RemoveManagementGroup Method

Article
04/04/2012

Applies To: System Center 2012 - Operations Manager

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

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.

Return Value

None.

Errors

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.

Remarks

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.

Example

For a scripting example, see How to Add and Remove a Management Group.

Requirements

Platforms: Requires Windows Vista, Windows Server 2003, or Windows Server 2008

Version: Requires System Center 2012 – Operations Manager