Partager via

Update-SCXAgent

  • Référence
Module:
OperationsManager

Met à niveau l’agent de gestion sur les ordinateurs UNIX et Linux spécifiés vers la dernière version disponible.

Syntaxe

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

Description

La cmdlet Update-SCXAgent met à jour l’agent sur les ordinateurs spécifiés vers la dernière version disponible. Si la dernière version disponible de l’agent de gestion est déjà installée sur un ordinateur ciblé, aucune action n’est effectuée.

Le paramètre Agent requis spécifie les ordinateurs UNIX et Linux gérés ciblés à désinstaller et nécessite un objet 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 accepte paramètres d’entrée SshCredential et WsManCred ential. Le paramètre sshCredential fourni est utilisé pour les actions de mise à jour de l’agent privilégié, tandis que le WsManCredential fourni est utilisé pour la communication avec un agent à faible privilège. Si le paramètre sshCredential n’est pas fourni, l’applet de commande tente d’utiliser le compte d’identification d’identification de maintenance de l’agent défini associé à l’ordinateur ciblé.

La sortie de cette applet de commande est un tableau d’objets d’ordinateur UNIX ou Linux managés représentant les systèmes ciblés qui ont été correctement mis à jour.

Exemples

Exemple 1 : Mettre à jour un agent de gestion

PS C:\>$Agent01 = Get-SCXAgent -Name "nx1.contoso.com"
PS C:\> $WSCredential = Get-Credential "DavidChew"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key21.ppk" -ElevationType sudo
PS C:\> Update-SCXAgent -SSHCredential $SSHCredential -WSManCredential $WSCredential -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 obtient des informations d’identification pour un utilisateur à l’aide de l’applet de commande Get-Credential. La commande vous invite à entrer l’authentification, puis stocke les résultats dans la variable $WSCredential.

La troisiè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 met à jour l’agent de gestion dans $Agent 01 avec les valeurs des deuxième et troisième commandes.

Exemple 2 : Mettre à jour un agent de gestion avec le compte d’identification défini

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

Cette commande obtient l’agent pour un ordinateur Linux ou UNIX managé nommé nx1.contoso.com à l’aide de Get-SCXAgent. La commande transmet l’ordinateur géré à l’applet de commande actuelle. La commande met à jour 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 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

-SshCredential

Spécifie un paramètre de sshCredential privilégié utilisé pour effectuer les actions de mise à jour 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 de maintenance de l’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
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

-WsManCredential

Spécifie les informations d’identification utilisées pour la communication avec un agent à faible privilège via WSMan. Cette applet de commande utilise ces informations d’identification pour vérifier la disponibilité de l’agent.

Tapez un nom d’utilisateur, tel que User01 ou entrez un objet PSCredential, tel qu’un objet retourné par l’applet de commande Get-Credential. Lorsque vous tapez un nom d’utilisateur, vous êtes invité à entrer un mot de passe.

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

Sorties

Microsoft.Unix.Computer[]

Cette applet de commande retourne une collection de résultats de mise à niveau, chacune représentant l’état de mise à niveau d’un ordinateur. Chaque résultat doit contenir les informations suivantes :

  • Nom d’hôte
  • Systèmes d’exploitation
  • Ancienne version de l’agent
  • Nouvelle version de l’agent
  • état de la mise à niveau
  • Description

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

Notes

  • Cette applet de commande prend une collection de noms d’hôtes de manière énumérée. Il collecte tous les noms d’hôtes et traite l’ensemble de la collection en parallèle à la fin du pipeline.