RemoveManagementGroup Method

Updated: January 31, 2012

Applies To: System Center 2012 - Operations Manager

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

Reference