Partager via

Uninstall-SCXAgent

  • Référence
Module:
OperationsManager

Désinstalle l’agent de gestion sur les ordinateurs UNIX et Linux gérés spécifiés.

Syntax

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

Description

L’applet de commande Uninstall-SCXAgent désinstalle l’agent de gestion sur les ordinateurs UNIX et Linux spécifiés.

Le paramètre Agent requis spécifie les ordinateurs UNIX ou Linux gérés ciblés à désinstaller et nécessite un objet d’ordinateur UNIX ou Linux. Pour plus d’informations sur la récupération d’ordinateurs UNIX ou Linux managés, consultez l’applet de commande Get-SCXAgent. Un paramètre SSHCredential facultatif peut être spécifié pour identifier les informations d’identification privilégiées utilisées pour la désinstallation de l’agent de gestion. Si sshCredential n’est pas spécifié, l’applet de commande tente d’utiliser le compte d’identification privilégié défini pour l’agent.

Cette applet de commande ne retourne aucune sortie.

Exemples

Exemple 1 : Désinstaller un agent de gestion

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

La première commande obtient l’agent pour un ordinateur Linux ou UNIX managé nommé nx1.contoso.com à l’aide de l’applet de commande Get-SCXAgent. La commande la stocke dans la variable $Agent 01.

La deuxième commande crée des informations d’identification privilégiées pour un utilisateur à l’aide de l’applet de commande Get-SCXSSHCredential. La commande stocke le résultat dans la variable $SSHCredential.

La commande finale désinstalle l’agent de gestion dans $Agent 01 à l’aide d’informations d’identification SSH spécifiées.

Exemple 2 : Désinstaller un agent de gestion avec le compte d’identification défini

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

Cette commande obtient l’agent pour un ordinateur Linux ou UNIX géré nommé nx1.contoso.com à l’aide de Get-SCXAgent. La commande transmet l’ordinateur managé à l’applet de commande actuelle. La commande désinstalle l’agent de gestion à l’aide du compte d’identification défini.

Paramètres

-Agent

Spécifie un ou plusieurs objets d’ordinateur UNIX ou Linux gérés. Pour plus d’informations sur l’obtention d’un objet ordinateur UNIX ou Linux managé, tapez Get-Help Get-SCXAgent.

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

-ComputerName

Spécifie un tableau de noms d’ordinateurs. L’applet de commande établit des connexions temporaires avec des groupes d’administration pour ces ordinateurs. Vous pouvez utiliser des noms NetBIOS, des adresses IP ou des noms de domaine complets (FQDN). Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, localhost ou un point (.).

Le service System Center Data Access doit être actif sur l’ordinateur. Si vous ne spécifiez pas d’ordinateur, l’applet de commande utilise l’ordinateur pour la connexion de groupe d’administration actuelle.

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

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Spécifie le compte d’utilisateur sous lequel la connexion au groupe d’administration s’exécute. Spécifiez un objet PSCredential , tel que celui retourné par l’applet de commande Get-Credential , pour ce paramètre. Pour plus d’informations sur les objets d’informations d’identification, tapez Get-Help Get-Credential.

Si vous spécifiez un ordinateur dans le paramètre ComputerName , utilisez un compte qui a accès à cet ordinateur. La valeur par défaut est l’utilisateur actuel.

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

-SCSession

Spécifie un tableau d’objets Connection . Pour obtenir des objets Connection , utilisez l’applet de commande Get-SCOMManagementGroupConnection .

Si ce paramètre n’est pas spécifié, l’applet de commande utilise la connexion persistante active à un groupe d’administration. Utilisez le paramètre SCSession pour spécifier une autre connexion persistante. Vous pouvez créer une connexion temporaire à un groupe d’administration à l’aide des paramètres ComputerName et Credential . Pour plus d'informations, voir Get-Help about_OpsMgr_Connections.

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

-SshCredential

Spécifie les informations d’identification SSH privilégiées utilisées pour effectuer les actions de maintenance de l’agent. Si ce paramètre n’est pas spécifié, l’applet de commande tente d’utiliser le compte d’identification d’identification d’agent défini pour l’agent.

Pour plus d’informations sur l’obtention d’un objet d’informations d’identification SSH, tapez Get-Help Get-SCXSSHCredential.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Sorties

Cette applet de commande retourne les résultats, qui représentent l’état de désinstallation d’un ordinateur. Les résultats contiennent les informations suivantes :

  • Nom de l’hôte
  • État de désinstallation
  • Description

La description inclut les détails de la raison pour laquelle une désinstallation a échoué.