Condividi tramite

Uninstall-SCOMAgent

  • Riferimento
Modulo:
OperationsManager

Disinstalla gli agenti dai computer gestiti dall'agente.

Sintassi

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

Descrizione

Il cmdlet Uninstall-SCOMAgent disinstalla gli agenti dai computer gestiti dall'agente. Prima di disinstallare un agente, è necessario rimuovere le assegnazioni dell'agente Active Directory Domain Services (AD DS) dal gruppo di gestione. È possibile usare il Remove-SCOMADAgentAssignment cmdet per rimuovere le assegnazioni degli agenti di Active Directory Domain Services dal gruppo di gestione.

Esempio

Esempio 1: Disinstallare un agente

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

Il primo comando ottiene l'oggetto agente di Operations Manager denominato server01.contoso.com e lo passa al cmdlet Uninstall-SCOMAgent usando l'operatore pipeline. Il secondo comando disinstalla l'agente denominato server01.contoso.com.

Esempio 2: Disinstallare un agente usando una variabile oggetto

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

In questo esempio viene disinstallato l'agente operations manager in un computer gestito dall'agente.

Il primo comando ottiene l'oggetto computer gestito dall'agente denominato server01.contoso.com e archivia l'oggetto nella variabile $Agent.

Il secondo comando disinstalla l'agente archiviato in $Agent.

Esempio 3: Disinstallare un agente usando un account azione

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

In questo esempio viene disinstallato l'agente operations manager in un computer gestito dall'agente dopo che l'utente immette le credenziali richieste da Operations Manager per disinstallare l'agente.

Il primo comando ottiene l'oggetto agente denominato server01.contoso.com e archivia l'oggetto nella variabile $Agent.

Il secondo comando richiede all'utente di immettere le credenziali usate da Operations Manager per disinstallare un agente. Il comando disinstalla quindi l'agente archiviato in $Agent.

Parametri

-ActionAccount

Specifica un oggetto PSCredential . Questo parametro specifica le credenziali usate da Operations Manager per eseguire l'attività di distribuzione. Se non si specifica questo parametro o si specifica un valore Null, Operations Manager usa l'account azione predefinito del server di gestione per l'agente.

Per ottenere un oggetto PSCredential , usare il cmdlet Get-Credential . Per altre informazioni, digitare Get-Help Get-Credential.

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Agent

Specifica una matrice di oggetti AgentManagedComputer. Questo parametro specifica gli agenti di Operations Manager da disinstallare. Per ottenere un oggetto AgentManagedComputer , usare il cmdlet Get-SCOMADAgent .

Tipo:AgentManagedComputer[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Indica che il cmdlet crea o modifica un oggetto che un comando può usare nella pipeline. Per impostazione predefinita, questo cmdlet non genera alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer

Output

Microsoft.EnterpriseManagement.Administration.AgentTaskResult