Partager via


RemoveManagementGroup Method

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

See Also

Reference

AddManagementGroup Method
GetManagementGroup Method
GetManagementGroups Method
ManagementServiceConfigurationClass Object