Remove-SCOMADAgentAssignment
Entfernt AD DS-Agent-Zuweisungen aus der Verwaltungsgruppe.
Syntax
Default (Standardwert)
Remove-SCOMADAgentAssignment
-AgentAssignment <AgentAssignment>
-PrimaryServer <ManagementServer>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Mit dem Cmdlet Remove-SCOMADAgentAssignment werden Agent-Zuweisungen für Active Directory-Domänendienste (Active Directory Domain Services, AD DS) aus der Verwaltungsgruppe entfernt.
Nachdem Sie eine Agent-Zuweisung entfernt haben, werden die mit dem Agent verwalteten Computer nicht von der Verwaltungsgruppe überwacht. Der Status dieser Computer ändert sich in Kritisch, da die Computer keine Takte mehr an die Verwaltungsgruppe senden. Sie können diese Computer aus der Verwaltungsgruppe entfernen, und wenn der Computer nicht anderen Verwaltungsgruppen zugewiesen ist, können Sie den System Center – Operations Manager-Agent deinstallieren.
Beispiele
Beispiel 1: Entfernen einer Agent-Zuweisung mithilfe des primären Servers
PS C:\>Get-SCOMManagementServer "OMServer01*" | Get-SCOMADAgentAssignment | Remove-SCOMADAgentAssignment
Mit diesem Befehl werden alle AD DS-Agent-Zuweisungen für einen primären Verwaltungsserver entfernt. Der Befehl verwendet das Cmdlet Get-SCOMManagementServer , um den Verwaltungsserver mit dem Namen OMServer01 abzurufen, und übergibt das Ergebnis mithilfe des Pipelineoperators an das Cmdlet Get-SCOMADAgentAssignment .
Der Befehl ruft alle AD DS-Agent-Zuweisungen ab, deren primärer Server den Namen OMServer01 hat, und übergibt die Ergebnisse mithilfe des Pipelineoperators an das Cmdlet Remove-SCOMADAgentAssignment . Mit dem Befehl werden die Agent-Zuweisungen entfernt, deren primärer Server den Namen OMServer01 hat.
Beispiel 2: Entfernen einer Agent-Zuweisung mithilfe der Domäne
PS C:\>Get-SCOMADAgentAssignment -Domain "contoso.com" | Remove-SCOMADAgentAssignment
Mit diesem Befehl werden alle AD DS-Agent-Zuweisungen für eine Domäne abgerufen. Der Befehl verwendet das Cmdlet Get-SCOMADAgentAssignment , um die AD DS-Agent-Zuweisung mit dem Namen contoso.com abzurufen, und übergibt das Ergebnis mithilfe des Pipelineoperators an das Cmdlet Remove-SCOMADAgentAssignment . Das Befehls-Cmdlet entfernt die AD DS-Agent-Zuweisungen für die Domäne mit dem Namen contoso.com.
Parameter
-AgentAssignment
Gibt ein AgentAssignment-Objekt an. Verwenden Sie zum Abrufen eines AgentAssignment-Objekts das Cmdlet Get-SCOMADAgentAssignment .
Parametereigenschaften
| Typ: | AgentAssignment |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-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 |
-PrimaryServer
Gibt ein ManagementServer-Objekt an. Dieser Parameter gibt den primären Verwaltungsserver für die vom Agent verwalteten Zielcomputer 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: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| 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.