Add-SCOMADAgentAssignment
Weist AD DS-verwaltete Computer der Verwaltungsgruppe 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 Add-SCOMADAgentAssignment-Cmdlet weist einem oder mehreren Active Directory Domain Services (AD DS)-Agent-verwalteten Computern die System Center 2019 - Operations Manager-Verwaltungsgruppe zu.
Bevor Sie dieses Cmdlet verwenden, um agentgesteuerte Computer der Verwaltungsgruppe 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 von AD DS-verwalteten Computern 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 dem Verwaltungsgruppe ein AD DS-Agent verwalteter Computer zugewiesen.
Der erste Befehl ruft das Verwaltungsserverobjekt namens DivMgmtSvr01.fabrikam.net ab und speichert das Objekt in der $PrimaryServer Variablen.
Der zweite Befehl gibt eine LDAP-Abfrage an, die Computer mit Namen wie SQLServer*.fabrikam.net auswählt und das Objekt in der $Ldap Variable speichert.
Der dritte Befehl weist den in $Ldap gespeicherten AD DS-Agentcomputern die Verwaltungsgruppe in der fabrikam.net Domäne zu. Der Befehl schließt den Computer mit dem Namen SQLServer05.fabrikam.net aus der Verwaltungsgruppe aus.
Beispiel 2: Festlegen von Failovers für eine AD DS-Agentzuordnung
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 $RunAs
In diesem Beispiel wird dem Verwaltungsgruppe ein AD DS-Agent verwalteter Computer zugewiesen und die Failover für den Agent festgelegt.
Der erste Befehl ruft das Verwaltungsserverobjekt namens DivMgmtSvr01.fabrikam.net ab und speichert das Objekt in der $PrimaryServer Variablen.
Der zweite Befehl ruft die Verwaltungsserver mit einem Namen wie FabrikamSecondary*.fabrikam.net ab und speichert die Objekte in der $Failovers Variablen.
Der dritte Befehl ruft das "Runs As"-Profilobjekt namens "Active Directory Based Agent Assignment Account" 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 $Ldap Variablen speichert.
Der fünfte Befehl weist den in $Ldap gespeicherten AD DS-Agentcomputern die Verwaltungsgruppe in der fabrikam.net Domäne zu. Der Befehl gibt den primären Verwaltungsserver an, der in $PrimaryServer für die verwalteten Agentcomputer gespeichert ist. Der Befehl gibt die in $Failovers gespeicherten Verwaltungsserver als Failover für die verwalteten Agentcomputer an. Der Befehl gibt das in $RunAs gespeicherte Profil für die verwalteten Agentcomputer an.
Parameter
-ComputerName
Gibt ein Array von Namen von Computern an. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Geben Sie zum Angeben des lokalen Computers den Computernamen, localhost oder einen Punkt (.) ein.
Der System Center Data Access-Dienst 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 des Domänen- oder Domänencontrollers an, in dem 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 Computer aus, die Sie aus der Agentzuweisung angeben.
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.
Standardmäßig verwendet Operations Manager alle Nicht-Gateway-Verwaltungsserver für 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 verwalteten Ziel-Agent 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 Run As-Profil an, das Operations Manager zum Ausführen des AD DS-Abfrageworkflows verwendet.
Das Run As-Profil muss demselben RunAs-Konto zugeordnet werden, das Sie angeben, wenn Sie MOMADAdmin.exe ausführen, um einen AD DS-Container für eine System Center 2019 - Operations Manager-Verwaltungsgruppe zu erstellen.
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. Die Standardeinstellung 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 |