Partager via

Remove-SCXAgent

  • Référence
Module:
OperationsManager

Supprime les ordinateurs UNIX et Linux gérés ciblés du groupe d’administration.

Syntaxe

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

Description

La cmdlet Remove-SCXAgent supprime les ordinateurs UNIX et Linux gérés ciblés du groupe d’administration. Les ordinateurs UNIX et Linux gérés sont passés à l’applet de commande Remove-SCXAgent sous la forme d’un tableau d’objets d’ordinateur UNIX et Linux.

Pour plus d’informations sur la récupération d’ordinateurs UNIX et Linux managés, consultez l’applet de commande Get-SCXAgent.

Cette applet de commande ne retourne aucune sortie.

Exemples

Exemple 1 : Supprimer des agents de gestion

PS C:\>$Agents = Get-SCXAgent -Name "scxserver1.contoso.com","scxserver2*","*.development.contoso.com"
PS C:\> Remove-SCXAgent -Agent $Agents

La première commande obtient des agents pour les ordinateurs Linux ou UNIX gérés qui correspondent aux noms spécifiés à l’aide de l’applet de commande Get-SCXAgent. La commande stocke les résultats dans la variable de tableau $Agents.

La commande finale supprime les agents dans $Agents.

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

PS C:\>Get-SCXAgent -Name "scxserver1.contoso.com","scxserver2*","*.development.contoso.com" | Remove-SCXAgent

Cette commande obtient des agents pour un ordinateur Linux ou UNIX managé qui correspondent aux noms spécifiés à l’aide de Get-SCXAgent. La commande transmet les agents à l’applet de commande actuelle. La commande supprime les agents de gestion.

Paramètres

-Agent

Spécifie un ou plusieurs objets d’ordinateur UNIX et Linux managé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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SCSession

Spécifie un tableau d’objets Connection. Pour obtenir 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 connexion persistante différente. Vous pouvez créer une connexion temporaire à un groupe d’administration à l’aide des paramètres ComputerName et Credential. Pour plus d’informations, tapez Get-Help about_OpsMgr_Connections.

Type:Connection[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Sorties

Cette applet de commande ne génère aucune sortie. Il n’existe aucun cas d’échec pour l’applet de commande Remove-SCXAgent.