Freigeben über

Uninstall-SCXAgent

  • Referenz
Modul:
OperationsManager

Deinstalliert den Verwaltungs-Agent auf den angegebenen verwalteten UNIX- und Linux-Computern.

Syntax

Uninstall-SCXAgent
         -Agent <IPersistedUnixComputer[]>
         [-SshCredential <CredentialSet>]
         [-SCSession <Connection[]>]
         [-ComputerName <String[]>]
         [-Credential <PSCredential>]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

Beschreibung

Das Cmdlet "Uninstall-SCXAgent " deinstalliert den Verwaltungs-Agent auf den angegebenen UNIX- und Linux-Computern.

Der erforderliche Agent-Parameter gibt die gezielt verwalteten UNIX- oder Linux-Computer an, die deinstalliert werden sollen, und erfordert ein UNIX- oder Linux-Computerobjekt. Informationen zum Abrufen verwalteter UNIX- oder Linux-Computer finden Sie im Cmdlet Get-SCXAgent. Ein optionaler SSHCredential-Parameter kann angegeben werden, um die privilegierten Anmeldeinformationen zu identifizieren, die für die Deinstallation des Verwaltungs-Agents verwendet werden. Wenn die SSH-Anmeldeinformationen nicht angegeben sind, versucht das Cmdlet, den definierten privilegierten Run As-Konto für den Agent zu verwenden.

Dieses Cmdlet gibt keine Ausgabe zurück.

Beispiele

Beispiel 1: Deinstallieren eines Verwaltungs-Agents

PS C:\>$Agent01 = Get-SCXAgent -Name "nx1.contoso.com"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key21.ppk" -ElevationType sudo
PS C:\> Uninstall-SCXAgent -SSHCredential $SSHCredential -Agent $Agent01

Der erste Befehl ruft den Agent für einen verwalteten Linux- oder UNIX-Computer namens nx1.contoso.com mithilfe des Cmdlets Get-SCXAgent ab. Der Befehl speichert sie in der Variablen $Agent 01.

Der zweite Befehl erstellt eine privilegierte Anmeldeinformationen für einen Benutzer mithilfe des Cmdlets Get-SCXSSHCredential. Der Befehl speichert das Ergebnis in der $SSHCredential Variablen.

Der endgültige Befehl deinstalliert den Verwaltungs-Agent in $Agent 01 mithilfe einer angegebenen SSH-Anmeldeinformationen.

Beispiel 2: Deinstallieren eines Verwaltungs-Agents mit dem definierten Run As-Konto

PS C:\>Get-SCXAgent -Name "nx1.contoso.com" | Uninstall-SCXAgent

Dieser Befehl ruft den Agent für einen verwalteten Linux- oder UNIX-Computer namens nx1.contoso.com mithilfe von Get-SCXAgent ab. Der Befehl übergibt den verwalteten Computer an das aktuelle Cmdlet. Der Befehl deinstalliert den Verwaltungs-Agent mithilfe des definierten Run As-Kontos.

Parameter

-Agent

Gibt mindestens ein verwaltetes UNIX- oder Linux-Computerobjekt an. Informationen zum Abrufen eines verwalteten UNIX- oder Linux-Computerobjekts finden Sie unter Get-Help Get-SCXAgent".

Type:IPersistedUnixComputer[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Gibt ein Array von Namen von Computern an. Das Cmdlet erstellt temporäre Verbindungen mit Verwaltungsgruppen für diese Computer. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Geben Sie zum Angeben des lokalen Computers den Computernamen, localhost oder einen Punkt (.) ein.

Der System Center Data Access-Dienst muss auf dem Computer aktiv sein. Wenn Sie keinen Computer angeben, verwendet das Cmdlet den Computer für die aktuelle Verwaltungsgruppenverbindung.

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

-Credential

Gibt das Benutzerkonto an, unter dem die Verwaltungsgruppenverbindung ausgeführt wird. Geben Sie ein PSCredential-Objekt an, z. B. eins, das das Get-Credential-Cmdlet zurückgibt, für diesen Parameter. Weitere Informationen zu Anmeldeinformationenobjekten geben Sie Get-Help Get-Credentialein.

Wenn Sie einen Computer im ComputerName-Parameter angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Der Standardwert ist der aktuelle Benutzer.

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

-SCSession

Gibt ein Array von Connection-Objekten an. Um Verbindungsobjekte abzurufen, verwenden Sie das Cmdlet Get-SCOMManagementGroupConnection .

Wenn dieser Parameter nicht angegeben wird, verwendet das Cmdlet die aktive persistente Verbindung zu einer Verwaltungsgruppe. Verwenden Sie den SCSession-Parameter , um eine andere persistente Verbindung anzugeben. Sie können eine temporäre Verbindung zu einer Verwaltungsgruppe erstellen, indem Sie die Parameter "ComputerName " und "Anmeldeinformationen " verwenden. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help about_OpsMgr_Connections.

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SshCredential

Gibt eine privilegierte SSH-Anmeldeinformationen an, die zum Ausführen der Agent-Wartungsaktionen verwendet werden. Wenn dieser Parameter nicht angegeben ist, versucht das Cmdlet, die definierte Agent-Wartung als Konto für den Agent zu verwenden.

Informationen zum Abrufen eines SSH-Anmeldeinformationenobjekts finden Sie Get-Help Get-SCXSSHCredentialunter ".

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

Ausgaben

Dieses Cmdlet gibt Ergebnisse zurück, die den Deinstallationsstatus für einen Computer darstellen. Die Ergebnisse enthalten die folgenden Informationen:

  • Hostname
  • Deinstallationsstatus
  • Beschreibung

Die Beschreibung enthält die Details, warum eine Deinstallation fehlgeschlagen ist.