Partager via

Install-SCXAgent

  • Référence
Module:
OperationsManager

Installe l’agent Operations Manager pour les ordinateurs UNIX et Linux détectés.

Syntaxe

Install-SCXAgent
       -DiscoveryResult <DiscoveryResult[]>
       [-SCSession <Connection[]>]
       [-ComputerName <String[]>]
       [-Credential <PSCredential>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

L’applet de commande Install-SCXAgent installe l’agent Operations Manager pour les ordinateurs UNIX et Linux détectés, signe le certificat pour la communication WS-Management et inscrit l’agent auprès d’Operations Manager pour la gestion. Les ordinateurs UNIX et Linux doivent être découverts avec l’applet de commande Invoke-SCXDiscovery. L’objet de sortie de l’applet de commande Invoke-SCXDiscovery est fourni en tant qu’entrée DiscoveryResult pour l’applet de commande install-SCXAgent .

Pour plus d’informations sur la découverte d’ordinateurs UNIX ou Linux, tapez Get-Help Invoke-SCXDiscovery.

Cette applet de commande retourne un tableau d’objets ordinateurs UNIX ou Linux managés qui représentent les systèmes ciblés qui ont été correctement installés.

Exemples

Exemple 1 : Découvrir des ordinateurs UNIX et Linux et installer l’agent de gestion

PS C:\>$WSCredential = Get-Credential "DavidChew"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key21.ppk" -ElevationType sudo
PS C:\> $Pool01 = Get-SCOMResourcePool -DisplayName "Pool01"
PS C:\> Invoke-SCXDiscovery -IPRange 192.168.1.50,192.168.1.75 -ResourcePool $MyPool -WSManCredential $WSCredential -SSHCredential $SSHCredential | Install-SCXAgent

La première 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 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 troisième commande obtient un pool de ressources nommé Pool01 à l’aide de l’applet de commande Get-SCOMResourcePool, puis le stocke dans la variable $Pool 01.

La commande finale appelle une découverte d’ordinateurs UNIX et Linux dans une plage d’adresses IP à l’aide de l’applet de commande Invoke-SCXDiscovery. La commande transmet tous les ordinateurs détectés à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. La commande installe l’agent de gestion.

Paramètres

-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

-DiscoveryResult

Spécifie l’objet DiscoveryResult à traiter pour l’installation de l’agent de gestion tel qu’il est retourné par l’applet de commande Invoke-SCXDiscovery.

Pour plus d’informations sur la découverte de systèmes ciblés, tapez Get-Help Invoke-SCXDiscovery.

Type:DiscoveryResult[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
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

Microsoft.Unix.Computer[]

Cette applet de commande retourne un tableau d’ordinateurs UNIX et Linux managés qui ont été correctement installés.