Get-SCOMADAgentAssignment

Gets AD DS agent assignments for the management group.

Syntax

Get-SCOMADAgentAssignment [[-Domain] <String[]>] [-ComputerName <String[]>] [-Credential <PSCredential>]
 -PrimaryServer <ManagementServer[]> [-SCSession <Connection[]>] [<CommonParameters>]

Description

The Get-SCOMADAgentAssignment cmdlet gets Active Directory Domain Services (AD DS) agent assignments for the management group.

Examples

Example 1: Get AD DS agent assignments by using a domain name

PS C:\>Get-SCOMADAgentAssignment -Domain "cdomain01.contoso.com"

This command gets all AD DS agent assignments for the domain named cdomain01.contoso.com.

Example 2: Get AD DS agent assignments by using a primary server

PS C:\>Get-SCOMManagementServer "OMServer01*" | Get-SCOMADAgentAssignment -Domain "contoso.com"

This command gets AD DS agent assignments for a domain that have the same primary management server. The command uses the Get-SCOMManagementServer cmdlet to get the management server named OMServer01, and passes the result to the Get-SCOMADAgentAssignment cmdlet by using the pipeline operator. The command cmdlet gets all AD DS agent assignments for the domain named contoso.com that have the primary server named OMServer01.

Parameters

-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.

Type:String[]
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-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.

Type:PSCredential
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Domain

Specifies the name of the domain or domain controller in which the target agents reside.

Type:String[]
Required:False
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PrimaryServer

Specifies an array of ManagementServer objects. This parameter specifies the primary management servers for the target agent-managed computer. To obtain a ManagementServer object, use the Get-SCOMManagementServer cmdlet.

Type:ManagementServer[]
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-SCSession

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.

Type:Connection[]
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False