Add-SCOMADAgentAssignment
Weist der Verwaltungsgruppe verwaltete AD DS-Agent-Computer zu.
Syntax
Add-SCOMADAgentAssignment
[-Domain] <String>
[-PrimaryServer] <ManagementServer>
[-LdapQuery] <String>
[-RunAsProfile <ManagementPackSecureReference>]
[-FailoverServer <ManagementServer[]>]
[-Exclude <String[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Das Cmdlet Add-SCOMADAgentAssignment weist der Verwaltungsgruppe System Center – Operations Manager einen oder mehrere Active Directory Domain Services verwalteten Computer (AD DS) zu.
Bevor Sie dieses Cmdlet verwenden, um der Verwaltungsgruppe mit Agent verwaltete Computer zuzuweisen, verwenden Sie MOMADAdmin.exe, um einen AD DS-Container für eine Operations Manager-Verwaltungsgruppe in der Domäne der Computer zu erstellen.
Beispiele
Beispiel 1: Zuweisen verwalteter AD DS-Agent-Computer zur Verwaltungsgruppe
PS C:\>$PrimaryServer = Get-SCOMManagementServer -Name "DivMgmtSvr01.fabrikam.net"
PS C:\> $Ldap = "(&(sAMAccountType=805306369)(name=SQLServer*))"
PS C:\> Add-SCOMADAgentAssignment -Domain "fabrikam.net" -PrimaryServer $PrimaryServer -LdapQuery $Ldap -Exclude "SQLServer05.fabrikam.net"In diesem Beispiel wird der Verwaltungsgruppe ein mit AD DS-Agent verwalteter Computer zugewiesen.
Der erste Befehl ruft das Verwaltungsserverobjekt mit dem Namen DivMgmtSvr01.fabrikam.net ab und speichert das Objekt in der variablen $PrimaryServer.
Der zweite Befehl gibt eine LDAP-Abfrage an, die Computer mit Namen wie SQLServer*.fabrikam.net auswählt und das Objekt in der variablen $Ldap speichert.
Der dritte Befehl weist die in $Ldap gespeicherten AD DS-Agent-verwalteten Computer der Verwaltungsgruppe in der domäne fabrikam.net zu. Der Befehl schließt den Computer namens SQLServer05.fabrikam.net aus der Verwaltungsgruppe aus.
Beispiel 2: Festlegen von Failovern für eine AD DS-Agentzuweisung
PS C:\>$PrimaryServer = Get-SCOMManagementServer -Name "DivMgmtSvr01.fabrikam.net"
PS C:\> $Failovers = Get-SCOMManagementServer -Name "FabrikamSecondary*.fabrikam.net"
PS C:\> $RunAs = Get-SCOMRunAsProfile -Name "Active Directory Based Agent Assignment Account"
PS C:\> $Ldap = "(&(sAMAccountType=805306369)(name=SQLServer*))"
PS C:\> Add-SCOMADAgentAssignment -Domain "fabrikam.net" -PrimaryServer $PrimaryServer -LdapQuery $Ldap -FailoverServer $Failovers -RunAsProfile $RunAsIn diesem Beispiel wird der Verwaltungsgruppe ein mit AD DS-Agent verwalteter Computer zugewiesen und die Failover für den Agent festgelegt.
Der erste Befehl ruft das Verwaltungsserverobjekt mit dem Namen DivMgmtSvr01.fabrikam.net ab und speichert das Objekt in der variablen $PrimaryServer.
Der zweite Befehl ruft die Verwaltungsserver mit einem Namen wie FabrikamSecondary*.fabrikam.net ab und speichert die Objekte in der variablen $Failovers.
Der dritte Befehl ruft das Profilobjekt "Ausführen als" mit dem Namen "Active Directory-basiertes Agentzuweisungskonto" ab und speichert das Objekt in der $RunAs Variablen.
Der vierte Befehl gibt eine LDAP-Abfrage an, die Computer mit Namen wie SQLServer*.fabrikam.net auswählt und das Ergebnis in der variablen $Ldap speichert.
Der fünfte Befehl weist die in $Ldap gespeicherten AD DS-Agent-verwalteten Computer der Verwaltungsgruppe in der domäne fabrikam.net zu. Der Befehl gibt den primären Verwaltungsserver an, der in $PrimaryServer für die vom Agent verwalteten Computer gespeichert ist. Der Befehl gibt die in $Failovers gespeicherten Verwaltungsserver als Failover für die vom Agent verwalteten Computer an. Der Befehl gibt das ausführende Profil an, das in $RunAs für die vom Agent verwalteten Computer gespeichert ist.
Parameter
-ComputerName
Gibt ein Array von Namen von Computern an. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie den Computernamen, localhost oder einen Punkt (.) ein.
Der System Center-Datenzugriffsdienst muss auf dem Computer ausgeführt werden. Wenn Sie keinen Computer angeben, verwendet das Cmdlet den Computer für die aktuelle Verwaltungsgruppenverbindung.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Gibt ein PSCredential-Objekt für die Verwaltungsgruppenverbindung an.
Verwenden Sie zum Abrufen eines PSCredential-Objekts das Get-Credential-Cmdlet.
Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.
Wenn Sie einen Computer im ComputerName-Parameter angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Der Standardwert ist der aktuelle Benutzer.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Domain
Gibt den Namen der Domäne oder des Domänencontrollers an, in der sich die Ziel-Agents befinden.
| Type: | String |
| Aliases: | DC |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Exclude
Gibt ein Array von Namen von Computern an. Operations Manager schließt die von Ihnen angegebenen Computer aus der Agentzuweisung aus.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FailoverServer
Gibt ein Array von Namen von ManagementServer-Objekten an. Dieser Parameter gibt die Verwaltungsserver an, die Operations Manager als Failover für die Ziel-Agents verwendet.
Operations Manager verwendet standardmäßig alle Nicht-Gateway-Verwaltungsserver für das Failover.
| Type: | ManagementServer[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LdapQuery
Gibt die LDAP-Abfrage in der Domäne an, die die Ziel-Agent-Computer auswählt.
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrimaryServer
Gibt ein ManagementServer-Objekt an. Dieser Parameter gibt den primären Verwaltungsserver für den vom Ziel-Agent verwalteten Computer an. Verwenden Sie zum Abrufen eines ManagementServer-Objekts das Cmdlet Get-SCOMManagementServer .
| Type: | ManagementServer |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsProfile
Gibt das ausführende Profil an, das Operations Manager zum Ausführen des AD DS-Abfrageworkflows verwendet.
Das ausführende Profil muss dem gleichen RunAs-Konto zugeordnet sein, das Sie beim Ausführen MOMADAdmin.exe zum Erstellen eines AD DS-Containers für eine System Center Operations Manager-Verwaltungsgruppe angeben.
| Type: | ManagementPackSecureReference |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SCSession
Gibt ein Array von Connection-Objekten an. Verwenden Sie zum Abrufen eines Connection-Objekts das Cmdlet Get-SCOMManagementGroupConnection .
Ein Verbindungsobjekt stellt eine Verbindung mit einem Verwaltungsserver dar. Der Standardwert ist die aktuelle Verwaltungsgruppenverbindung.
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |