Freigeben über

Uninstall-SCOMAgent

  • Referenz
Modul:
OperationsManager

Deinstalliert Agents von vom Agent verwalteten Computern.

Syntax

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.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:AgentManagedComputer[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer

Ausgaben

Microsoft.EnterpriseManagement.Administration.AgentTaskResult