Add-SCOMADAgentAssignment
Weist der Verwaltungsgruppe mit AD DS-Agent verwaltete Computer zu.
Syntax
Default (Standardwert)
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 mit Active Directory-Domänendienste (Active Directory Domain Services, AD DS) verwaltete Computer zu.
Bevor Sie dieses Cmdlet verwenden, um der Verwaltungsgruppe mit Agents 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 von mit AD DS-Agents 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 der Verwaltungsgruppe ein vom AD DS-Agent verwalteter Computer zugewiesen.
Mit dem ersten Befehl wird das Verwaltungsserverobjekt mit dem Namen DivMgmtSvr01.fabrikam.net abgerufen und in der Variablen $PrimaryServer gespeichert.
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.
Mit dem dritten Befehl werden die mit AD DS-Agents verwalteten Computer, die in $Ldap gespeichert sind, der Verwaltungsgruppe in der Domäne fabrikam.net zugewiesen. Der Befehl schließt den Computer mit dem Namen SQLServer05.fabrikam.net aus der Verwaltungsgruppe aus.
Beispiel 2: Festlegen von Failovern für eine AD DS-Agent-Zuweisung
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 der Verwaltungsgruppe ein mit AD DS-Agents verwalteter Computer zugewiesen, und die Failover für den Agent werden festgelegt.
Mit dem ersten Befehl wird das Verwaltungsserverobjekt mit dem Namen DivMgmtSvr01.fabrikam.net abgerufen und in der Variablen $PrimaryServer gespeichert.
Der zweite Befehl ruft die Verwaltungsserver mit einem Namen wie FabrikamSecondary*.fabrikam.net ab und speichert die Objekte in der Variablen $Failovers.
Mit dem dritten Befehl wird das Profilobjekt "Ausführen als" mit dem Namen "Active Directory-basiertes Agent-Zuweisungskonto" abgerufen und in der Variablen $RunAs gespeichert.
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.
Mit dem fünften Befehl werden die mit AD DS-Agents verwalteten Computer, die in $Ldap gespeichert sind, der Verwaltungsgruppe in der Domäne fabrikam.net zugewiesen. Der Befehl gibt den primären Verwaltungsserver an, der in $PrimaryServer für die mit Agents verwalteten Computer gespeichert ist. Der Befehl gibt die in $Failovers gespeicherten Verwaltungsserver als Failover für die mit Agents verwalteten Computer an. Der Befehl gibt das ausführende Profil an, das in $RunAs für die mit Agents 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 (Fully Qualified Domain Names, FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie den Computernamen, den 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.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Credential
Gibt ein PSCredential- -Objekt für die Verwaltungsgruppenverbindung an.
Verwenden Sie das Cmdlet Get-Credential, um ein PSCredential-Objekt abzurufen.
Geben Sie Get-Help Get-Credentialein, um weitere Informationen zu erfahren.
Wenn Sie im Parameter ComputerName einen Computer angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Die Standardeinstellung ist der aktuelle Benutzer.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Domain
Gibt den Namen der Domäne oder des Domänencontrollers an, in der sich die Ziel-Agents befinden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | SL |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Exclude
Gibt ein Array von Namen von Computern an. Operations Manager schließt die Computer, die Sie angeben, aus der Agent-Zuweisung aus.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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 Verwaltungsserver, die keine Gateways sind, für das Failover.
Parametereigenschaften
| Typ: | ManagementServer[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-LdapQuery
Gibt die LDAP-Abfrage in der Domäne an, die die Ziel-Agent-Computer auswählt.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 3 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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 .
Parametereigenschaften
| Typ: | ManagementServer |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 2 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-RunAsProfile
Gibt das ausführende Profil an, das Operations Manager zum Ausführen des AD DS-Abfrageworkflows verwendet.
Das ausführende Profil muss demselben RunAs-Konto zugeordnet sein, das Sie beim Ausführen von MOMADAdmin.exe angeben, um einen AD DS-Container für eine System Center – Operations Manager-Verwaltungsgruppe zu erstellen.
Parametereigenschaften
| Typ: | ManagementPackSecureReference |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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 zu einem Management-Server dar. Der Standardwert ist die aktuelle Verwaltungsgruppenverbindung.
Parametereigenschaften
| Typ: | Connection[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.