Delen via

Uninstall-SCXAgent

  • Referentie
Module:
OperationsManager

Hiermee verwijdert u de beheeragent op de opgegeven beheerde UNIX- en Linux-computers.

Syntaxis

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

Description

De cmdlet Uninstall-SCXAgent verwijdert de beheeragent op de opgegeven UNIX- en Linux-computers.

De vereiste Agent parameter specificeert de doel beheerde UNIX- of Linux-computers die moeten worden verwijderd en vereist een UNIX- of Linux-computerobject. Zie de cmdlet Get-SCXAgent voor informatie over het ophalen van beheerde UNIX- of Linux-computers. Een optionele SSHCredential- parameter kan worden opgegeven om de bevoegde referentie te identificeren die wordt gebruikt voor het verwijderen van de beheeragent. Als de SSHCredential- niet is opgegeven, probeert de cmdlet het gedefinieerde Uitvoeren als-account voor de agent te gebruiken.

Deze cmdlet retourneert geen uitvoer.

Voorbeelden

Voorbeeld 1: Een beheeragent verwijderen

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

Met de eerste opdracht haalt u de agent op voor een beheerde Linux- of UNIX-computer met de naam nx1.contoso.com met behulp van de Get-SCXAgent-cmdlet. Met de opdracht wordt deze opgeslagen in de variabele $Agent 01.

Met de tweede opdracht maakt u een bevoegde referentie voor een gebruiker met behulp van de cmdlet Get-SCXSSHCredential. Met de opdracht wordt het resultaat opgeslagen in de $SSHCredential variabele.

Met de laatste opdracht wordt de beheeragent in $Agent 01 verwijderd met behulp van een opgegeven SSH-referentie.

Voorbeeld 2: Een beheeragent verwijderen met het gedefinieerde Uitvoeren als-account

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

Met deze opdracht haalt u de agent op voor een beheerde Linux- of UNIX-computer met de naam nx1.contoso.com met behulp van Get-SCXAgent. De opdracht geeft de beheerde computer door aan de huidige cmdlet. Met de opdracht wordt de beheeragent verwijderd met behulp van het gedefinieerde Uitvoeren als-account.

Parameters

-Agent

Hiermee geeft u een of meer beheerde UNIX- of Linux-computerobjecten op. Typ Get-Help Get-SCXAgentvoor informatie over het ophalen van een beheerd UNIX- of Linux-computerobject.

Type:IPersistedUnixComputer[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ComputerName

Hiermee geeft u een matrix van namen van computers. Met de cmdlet worden tijdelijke verbindingen met beheergroepen voor deze computers tot stand gebracht. U kunt NetBIOS-namen, IP-adressen of FQDN's (Fully Qualified Domain Names) gebruiken. Als u de lokale computer wilt opgeven, typt u de computernaam, localhost of een punt (.).

De System Center Data Access-service moet actief zijn op de computer. Als u geen computer opgeeft, gebruikt de cmdlet de computer voor de huidige beheergroepverbinding.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u het gebruikersaccount waaronder de verbinding met de beheergroep wordt uitgevoerd. Geef een PSCredential--object op, zoals een object dat door de Get-Credential cmdlet wordt geretourneerd voor deze parameter. Typ Get-Help Get-Credentialvoor meer informatie over referentieobjecten.

Als u een computer opgeeft in de parameter ComputerName, gebruikt u een account dat toegang heeft tot die computer. De standaardwaarde is de huidige gebruiker.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SCSession

Hiermee geeft u een matrix van Connection-objecten. Gebruik de cmdlet Get-SCOMManagementGroupConnection om Connection-objecten op te halen.

Als deze parameter niet is opgegeven, gebruikt de cmdlet de actieve permanente verbinding met een beheergroep. Gebruik de parameter SCSession om een andere permanente verbinding op te geven. U kunt een tijdelijke verbinding met een beheergroep maken met behulp van de parameters ComputerName en Credential. Typ Get-Help about_OpsMgr_Connectionsvoor meer informatie.

Type:Connection[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SshCredential

Hiermee geeft u een bevoegde SSH-referentie die wordt gebruikt om de agentonderhoudsacties uit te voeren. Als deze parameter niet is opgegeven, probeert de cmdlet het uitvoeren als-account van de agent te gebruiken voor het uitvoeren als-account van de agent.

Typ Get-Help Get-SCXSSHCredentialvoor informatie over het ophalen van een SSH-referentieobject.

Type:CredentialSet
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden

Deze cmdlet retourneert resultaten, die de verwijderingsstatus voor een computer vertegenwoordigen. De resultaten bevatten de volgende informatie:

  • Hostnaam
  • Status verwijderen
  • Beschrijving

De beschrijving bevat de details van waarom het verwijderen is mislukt.