UpdateActionAccount 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 updates the existing action account for a given management group with the given account.
ManagementServiceConfigurationClass.UpdateActionAccount (managementGroupName, actionAccountDomain,actionAccountUser,actionAccountPassword)
Parameters
| Parameter | Type | Description |
|---|---|---|
managementGroupName |
String |
The name of the management group for which the action account is updated. |
actionAccountDomain |
String |
Optional. If this parameter is present, this is the domain of the default action account user. |
actionAccountUser |
String |
Optional. If this parameter is present, this is the user name of the default action account user. |
actionAccountPassword |
String |
Optional. If this parameter is present, this is the password of the default action account user. |
- actionAccountDomain
If actionAccountDomain is Nothing and actionAccountUser is not Nothing, actionAccountUser should either be in the user principal name (UPN) format, if it is domain user, or be passed as LocalSystem, if it is local account of the computer. If actionAccountUser is Nothing, this parameter must also be Nothing.
- actionAccountUser
If actionAccountUser is in UPN naming format, actionAccountDomain will be ignored. If actionAccountUser is Nothing, LocalSystem will be used as the default action account, and both actionAccountDomain and actionAccountPassword must also be Nothing.
- actionAccountPassword
If actionAccountPassword is Nothing and actionAccountUser is not Nothing, the password for the account will be treated as the empty string.
Return Value
None.
Errors
| Error number | Description |
|---|---|
0x80004003 |
A required parameter has a Nothing value. |
0x80070005 |
Insufficient permissions to add a management group. The caller of this method must be an administrator. |
0x800700B7 |
The management group already exists. |
0x80FF003D |
No health service is installed. |
Remarks
On failure, the existing settings of the agent are not modified and the agent continues to using the old action account.
Example
This is the description for a Code Example.
Requirements
Platforms: Requires Windows Vista, Windows Server 2003, or Windows Server 2008
Version: Requires System Center 2012 – Operations Manager