Share via

Uninstall-SCOMAgent

  • Referenz
Modul:
OperationsManager

Deinstalliert Agents aus verwalteten Agent-Computern.

Syntax

Uninstall-SCOMAgent
         [-ActionAccount <PSCredential>]
         -Agent <AgentManagedComputer[]>
         [-PassThru]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

Beschreibung

Das Cmdlet " Uninstall-SCOMAgent " deinstalliert Agent-verwaltete Computer. 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 verwalteten Agent-Computer deinstalliert.

Der erste Befehl ruft das vom Agent verwaltete Computerobjekt namens 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 verwalteten Agent-Computer deinstalliert, nachdem der Benutzer die Anmeldeinformationen eingegeben hat, die Operations Manager zum Deinstallieren des Agents benötigt.

Der erste Befehl ruft das Agentobjekt namens server01.contoso.com ab und speichert das Objekt in der $Agent Variablen.

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.

Verwenden Sie zum Abrufen eines PSCredential-Objekts das Get-Credential-Cmdlet. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Agent

Gibt ein Array von AgentManagedComputer-Objekten an. Dieser Parameter gibt die Operations Manager-Agents an, die deinstalliert werden sollen. Verwenden Sie zum Abrufen eines AgentManagedComputer-Objekts das Cmdlet Get-SCOMADAgent .

Type:AgentManagedComputer[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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

-PassThru

Gibt an, dass das Cmdlet ein Objekt erstellt oder ändert, das ein Befehl in der Pipeline verwenden kann. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

Type:SwitchParameter
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

Eingaben

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer

Ausgaben

Microsoft.EnterpriseManagement.Administration.AgentTaskResult