Uninstall-SCOMAgent
Deinstalliert Agents von vom Agent verwalteten Computern.
Syntax
Default (Standardwert)
Uninstall-SCOMAgent
[-ActionAccount <PSCredential>]
-Agent <AgentManagedComputer[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Die Uninstall-SCOMAgent Cmdlet deinstalliert Agents von agentverwalteten Computern. Bevor Sie einen Agent deinstallieren, müssen Sie die Active Directory Domain Services (AD DS)-Agentzuweisungen aus der Verwaltungsgruppe entfernen. Sie können die Remove-SCOMADAgentAssignment cmdet verwenden, um AD DS-Agent-Zuordnungen aus der Verwaltungsgruppe zu entfernen.
Beispiele
Beispiel 1: Deinstallieren eines Agents
PS C:\>Get-SCOMAgent -DNSHostName "server01.contoso.com" | Uninstall-SCOMAgent
Der erste Befehl ruft das Operations Manager-Agent-Objekt namens server01.contoso.com ab und übergibt es mithilfe des Pipelineoperators an das Cmdlet Uninstall-SCOMAgent. Der zweite Befehl deinstalliert den Agent namens server01.contoso.com.
Beispiel 2: Deinstallieren eines Agents mithilfe einer Objektvariable
PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent
In diesem Beispiel wird der Operations Manager-Agent auf einem vom Agent verwalteten Computer deinstalliert.
Der erste Befehl ruft das vom Agent verwaltete Computerobjekt mit dem Namen server01.contoso.com ab und speichert das Objekt in der $Agent Variablen.
Der zweite Befehl deinstalliert den in $Agent gespeicherten Agent.
Beispiel 3: Deinstallieren eines Agents mithilfe eines Aktionskontos
PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent -ActionAccount (Get-Credential)
In diesem Beispiel wird der Operations Manager-Agent auf einem vom Agent verwalteten Computer deinstalliert, nachdem der Benutzer die Anmeldeinformationen eingibt, die Operations Manager zum Deinstallieren des Agents benötigt.
Der erste Befehl ruft das Agentobjekt mit dem Namen server01.contoso.com ab und speichert das Objekt in der variablen $Agent.
Der zweite Befehl fordert den Benutzer auf, die Anmeldeinformationen einzugeben, die Operations Manager zum Deinstallieren eines Agents verwendet. Der Befehl deinstalliert dann den in $Agent gespeicherten Agent.
Parameter
-ActionAccount
Gibt ein PSCredential -Objekt an. Dieser Parameter gibt die Anmeldeinformationen an, die Operations Manager zum Ausführen der Bereitstellungsaufgabe verwendet. Wenn Sie diesen Parameter nicht angeben oder einen Nullwert angeben, verwendet Operations Manager das Standardaktionskonto des Verwaltungsservers für den Agent.
Um ein PSCredential-Objekt abzurufen, verwenden Sie das Cmdlet Get-Credential.
Geben Sie Get-Help Get-Credentialein, um weitere Informationen zu erfahren.
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 |
-Agent
Gibt ein Array von AgentManagedComputer- -Objekten an. Dieser Parameter gibt die zu deinstallierenden Operations Manager-Agents an. Um ein AgentManagedComputer--Objekt abzurufen, verwenden Sie das Cmdlet Get-SCOMADAgent.
Parametereigenschaften
| Typ: | AgentManagedComputer[] |
| 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 |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
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 |
-PassThru
Gibt an, dass das Cmdlet ein Objekt erstellt oder ändert, das ein Befehl in der Pipeline verwenden kann. Standardmäßig generiert dieses Cmdlet keine Ausgabe.
Parametereigenschaften
| Typ: | SwitchParameter |
| 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.