Delen via

Uninstall-SCOMAgent

  • Referentie
Module:
OperationsManager

Hiermee verwijdert u agents van door agents beheerde computers.

Syntaxis

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

Description

De cmdlet Uninstall-SCOMAgent verwijdert agents van door agents beheerde computers. Voordat u een agent verwijdert, moet u de ad DS-agenttoewijzingen (Active Directory Domain Services) uit de beheergroep verwijderen. U kunt de Remove-SCOMADAgentAssignment cmdet gebruiken om AD DS-agenttoewijzingen uit de beheergroep te verwijderen.

Voorbeelden

Voorbeeld 1: Een agent verwijderen

PS C:\>Get-SCOMAgent -DNSHostName "server01.contoso.com" | Uninstall-SCOMAgent

Met de eerste opdracht wordt het Operations Manager-agentobject met de naam server01.contoso.com opgehaald en doorgegeven aan de cmdlet Uninstall-SCOMAgent met behulp van de pijplijnoperator. Met de tweede opdracht wordt de agent met de naam server01.contoso.com verwijderd.

Voorbeeld 2: Een agent verwijderen met behulp van een objectvariabele

PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent

In dit voorbeeld wordt de Operations Manager-agent verwijderd op een door een agent beheerde computer.

Met de eerste opdracht wordt het door de agent beheerde computerobject met de naam server01.contoso.com opgehaald en wordt het object opgeslagen in de variabele $Agent.

Met de tweede opdracht wordt de agent verwijderd die is opgeslagen in $Agent.

Voorbeeld 3: Een agent verwijderen met behulp van een actieaccount

PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent -ActionAccount (Get-Credential)

In dit voorbeeld wordt de Operations Manager-agent verwijderd op een door een agent beheerde computer nadat de gebruiker de referenties invoert die Operations Manager nodig heeft om de agent te verwijderen.

Met de eerste opdracht wordt het agentobject met de naam server01.contoso.com opgehaald en wordt het object opgeslagen in de variabele $Agent.

Met de tweede opdracht wordt de gebruiker gevraagd de referenties in te voeren die Operations Manager gebruikt om een agent te verwijderen. Met de opdracht wordt vervolgens de agent verwijderd die is opgeslagen in $Agent.

Parameters

-ActionAccount

Hiermee geeft u een PSCredential-object. Met deze parameter geeft u de referenties op die Operations Manager gebruikt om de implementatietaak uit te voeren. Als u deze parameter niet opgeeft of als u een null-waarde opgeeft, gebruikt Operations Manager het standaardactieaccount van de beheerserver voor de agent.

Als u een PSCredential--object wilt verkrijgen, gebruikt u de cmdlet Get-Credential. Typ Get-Help Get-Credentialvoor meer informatie.

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

-Agent

Hiermee geeft u een matrix van AgentManagedComputer objecten. Met deze parameter geeft u de Operations Manager-agents op die moeten worden verwijderd. Als u een AgentManagedComputer--object wilt verkrijgen, gebruikt u de cmdlet Get-SCOMADAgent.

Type:AgentManagedComputer[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
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

-PassThru

Geeft aan dat de cmdlet een object maakt of wijzigt dat een opdracht in de pijplijn kan gebruiken. Deze cmdlet genereert standaard geen uitvoer.

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

Invoerwaarden

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer

Uitvoerwaarden

Microsoft.EnterpriseManagement.Administration.AgentTaskResult