Condividi tramite

Uninstall-SCXAgent

  • Riferimento
Modulo:
OperationsManager

Disinstalla l'agente di gestione nei computer UNIX e Linux gestiti specificati.

Sintassi

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

Descrizione

Il cmdlet Uninstall-SCXAgent disinstalla l'agente di gestione nei computer UNIX e Linux specificati.

Il parametro Agent obbligatorio specifica i computer UNIX o Linux gestiti di destinazione da disinstallare e richiede un oggetto computer UNIX o Linux. Per informazioni sul recupero di computer UNIX o Linux gestiti, vedere il cmdlet Get-SCXAgent. È possibile specificare un parametro SSHCredential facoltativo per identificare le credenziali con privilegi usate per la disinstallazione dell'agente di gestione. Se il SSHCredential non viene specificato, il cmdlet tenta di usare l'account RunAs con privilegi definito per l'agente.

Questo cmdlet non restituisce alcun output.

Esempio

Esempio 1: Disinstallare un agente di gestione

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

Il primo comando ottiene l'agente per un computer Linux o UNIX gestito denominato nx1.contoso.com usando il cmdlet Get-SCXAgent. Il comando lo archivia nella variabile $Agent 01.

Il secondo comando crea una credenziale con privilegi per un utente usando il cmdlet Get-SCXSSHCredential. Il comando archivia il risultato nella variabile $SSHCredential.

Il comando finale disinstalla l'agente di gestione in $Agent 01 usando una credenziale SSH specificata.

Esempio 2: Disinstallare un agente di gestione con l'account RunAs definito

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

Questo comando ottiene l'agente per un computer Linux o UNIX gestito denominato nx1.contoso.com usando Get-SCXAgent. Il comando passa il computer gestito al cmdlet corrente. Il comando disinstalla l'agente di gestione usando l'account RunAs definito.

Parametri

-Agent

Specifica uno o più oggetti computer UNIX o Linux gestiti. Per informazioni su come ottenere un oggetto computer UNIX o Linux gestito, digitare Get-Help Get-SCXAgent.

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

-ComputerName

Specifica una matrice di nomi di computer. Il cmdlet stabilisce connessioni temporanee con i gruppi di gestione per questi computer. È possibile usare nomi NetBIOS, indirizzi IP o nomi di dominio completi (FQDN). Per specificare il computer locale, digitare il nome del computer, localhost o un punto (.).

Il servizio Di accesso ai dati di System Center deve essere attivo nel computer. Se non si specifica un computer, il cmdlet usa il computer per la connessione al gruppo di gestione corrente.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
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

-Credential

Specifica l'account utente in cui viene eseguita la connessione al gruppo di gestione. Specificare un oggetto PSCredential , ad esempio quello restituito dal cmdlet get-Credential per questo parametro. Per altre informazioni sugli oggetti credenziali, digitare Get-Help Get-Credential.

Se si specifica un computer nel parametro ComputerName, utilizzare un account che abbia accesso a tale computer. Il valore predefinito è l'utente corrente.

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

-SCSession

Specifica una matrice di oggetti Connection. Per ottenere oggetti Connection, usare il cmdlet Get-SCOMManagementGroupConnection .

Se questo parametro non viene specificato, il cmdlet usa la connessione permanente attiva a un gruppo di gestione. Usare il parametro SCSession per specificare una connessione permanente diversa. È possibile creare una connessione temporanea a un gruppo di gestione usando i parametri ComputerName e credenziali. Per altre informazioni, digitare Get-Help about_OpsMgr_Connections.

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

-SshCredential

Specifica una credenziale SSH privilegiata usata per eseguire le azioni di manutenzione dell'agente. Se questo parametro non viene specificato, il cmdlet tenta di usare l'account RunAs di manutenzione dell'agente definito per l'agente.

Per informazioni su come ottenere un oggetto credenziali SSH, digitare Get-Help Get-SCXSSHCredential.

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

Output

Questo cmdlet restituisce i risultati, che rappresentano lo stato di disinstallazione per un computer. I risultati contengono le informazioni seguenti:

  • Nome host
  • Stato di disinstallazione
  • Descrizione

La descrizione include i dettagli relativi al motivo per cui una disinstallazione non è riuscita.