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 SSHCredential non è 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 privilegiata 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.

Type:IPersistedUnixComputer[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 utilizza il computer per la connessione al gruppo di gestione corrente.

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

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Credential . Per ulteriori informazioni, digitare Get-Help about_OpsMgr_Connections.

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

-SshCredential

Specifica una credenziale SSH con privilegi utilizzata 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.

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 del motivo per cui una disinstallazione non è riuscita.