This method removes an active management group from the agent.
ManagementServiceConfigurationClass.RemoveManagementGroup (managementGroupName)
Parameters
Parameter | Type | Description |
---|---|---|
managementGroupName |
String |
The name of the management group to be removed. |
None.
Error number | Description |
---|---|
0x80004003 |
A required parameter has a Nothing value. |
0x80070057 |
A parameter was outside the valid range. |
S_FALSE |
The management group does not exist. |
0x80070005 |
Insufficient permissions to add a management group. The caller of this method must be an administrator. |
This method removes the management group configuration, even if the existing configuration is invalid or partial.
When the method returns, the management group is unregistered, but it is still active with the agent. To deactivate the management group, either call ReloadConfiguration Method or restart the System Center Management service.
On failure, the existing settings of the agent are not modified on Windows Vista and Windows 7. On Windows Server 2003, the method attempts to make either all modifications or no modifications. However, in some cases modifications may not be possible.
For a scripting example, see How to Add and Remove a Management Group.
Platforms: Requires Windows Vista, Windows Server 2003, or Windows Server 2008
Version: Requires System Center 2012 – Operations Manager