Share via

Get-SCOMADAgentAssignment

  • Reference
Module:
OperationsManager

Gets AD DS agent assignments for the management group.

Syntax

PowerShell 
Get-SCOMADAgentAssignment
   [[-Domain] <String[]>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
PowerShell 
Get-SCOMADAgentAssignment
   -PrimaryServer <ManagementServer[]>
   [[-Domain] <String[]>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<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

PowerShell 
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

PowerShell 
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[]
Position:Named
Default value:None
Required:False
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
Position:Named
Default value:None
Required:False
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[]
Position:1
Default value:None
Required:False
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[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False