This browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Add-SCOMADAgent Assignment
Assigns AD DS agent-managed computers to the management group.
Description
The Add-SCOMADAgentAssignment cmdlet assigns one or more Active Directory Domain Services (AD DS) agent-managed computers to the System Center - Operations Manager management group.
Before you use this cmdlet to assign agent-managed computers to the management group, use MOMADAdmin.exe to create an AD DS container for an Operations Manager management group in the domain of the computers.
Example 1: Assign AD DS agent-managed computers to the management group
This example assigns an AD DS agent-managed computer to the management group.
The first command gets the management server object named DivMgmtSvr01.fabrikam.net, and stores the object in the $PrimaryServer variable.
The second command specifies an LDAP query that selects computers with names like SQLServer*.fabrikam.net, and stores the object in the $Ldap variable.
The third command assigns the AD DS agent-managed computers stored in $Ldap to the management group in the fabrikam.net domain. The command excludes the computer named SQLServer05.fabrikam.net from the management group.
Example 2: Set failovers for an AD DS agent assignment
This example assigns an AD DS agent-managed computer to the management group and sets the failovers for the agent.
The second command gets the management servers with a name like FabrikamSecondary*.fabrikam.net, and stores the objects in the $Failovers variable.
The third command gets the Runs As profile object named "Active Directory Based Agent Assignment Account" and stores the object in the $RunAs variable.
The fourth command specifies an LDAP query that selects computers with names like SQLServer*.fabrikam.net, and stores the result in the $Ldap variable.
The fifth command assigns the AD DS agent-managed computers stored in $Ldap to the management group in the fabrikam.net domain. The command specifies the primary management server stored in $PrimaryServer for the agent-managed computers. The command specifies the management servers stored in $Failovers as failovers for the agent-managed computers. The command specifies the Run As profile stored in $RunAs for the agent-managed computers.
-ComputerName
Specifies an array of names of computers. You can use NetBIOS names, IP addresses, or fully qualified domain names (FQDNs). To specify the local computer, type the computer name, localhost, or a dot (.).
The System Center Data Access service must be running on the computer. If you do not specify a computer, the cmdlet uses the computer for the current management group connection.
Prompts you for confirmation before running the cmdlet.
-Credential
Specifies a PSCredential object for the management group connection. To obtain a PSCredential object, use the Get-Credential cmdlet. For more information, type Get-Help Get-Credential .
If you specify a computer in the ComputerName parameter, use an account that has access to that computer. The default is the current user.
Specifies the name of the domain or domain controller in which the target agents reside.
Specifies an array of names of computers. Operations Manager excludes the computers that you specify from the agent assignment.
-FailoverServer
Specifies an array of names of ManagementServer objects. This parameter specifies the management servers that Operations Manager uses as failovers for the target agents.
By default, Operations Manager uses all non-gateway management servers for failover.
Specifies the LDAP query in the domain which selects the target agent computers.
-PrimaryServer
Specifies a ManagementServer object. This parameter specifies the primary management server for the target agent-managed computer. To obtain a ManagementServer object, use the Get-SCOMManagementServer cmdlet.
-RunAsProfile
Specifies the Run As profile that Operations Manager uses to run AD DS query workflow.
The Run As profile must be associated with the same RunAs account that you specify when you run MOMADAdmin.exe to create an AD DS container for a System Center - Operations Manager management group.
Specifies an array of Connection objects. To obtain a Connection object, use the Get-SCOMManagementGroupConnection cmdlet.
A connection object represents a connection to a management server. The default is the current management group connection.
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Related Links
- Get-SCOMADAgentAssignment
- Update-SCOMADAgentAssignment
- Remove-SCOMADAgentAssignment
Additional resources
IMAGES
VIDEO
COMMENTS
Active Directory agent assignment. System Center Operations Manager allows you to take advantage of your investment in Active Directory Domain Services (AD DS) by enabling you to use it to assign agent-managed computers to management groups. This feature is commonly used with the agent deployed as part of a server deployment build process.
The Add-SCOMADAgentAssignment cmdlet assigns one or more Active Directory Domain Services (AD DS) agent-managed computers to the System Center - Operations Manager management group. Before you use this cmdlet to assign agent-managed computers to the management group, use MOMADAdmin.exe to create an AD DS container for an Operations Manager management group in the domain of the computers.
Open “Microsoft.SystemCenter.OperationsManager.DefaultUser.xml” from the exported folder. Rename all the AD rules to use <NetBIOS Domain Name of MS> instead of <FQDN of MS> as shown below. Note: Please note that the domain name is case sensitive. Import the updated Management Pack.