Partager via

Install-SCOMAgent

  • Référence
Module:
OperationsManager

Déploie des agents Operations Manager.

Syntaxe

Install-SCOMAgent
       -ActionAccount <PSCredential>
       [-AgentActionAccount <PSCredential>]
       -DNSHostName <String[]>
       -PrimaryManagementServer <ManagementServer>
       [-NoAPM]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

L’applet de commande install-SCOMAgent déploie un ou plusieurs agents System Center 2019 - Operations Manager et versions ultérieures à l’aide de l’installation push du client. Remarque : le paramètre [-NoAPM] est introduit avec System Center Operations Manager 1807 (ce paramètre n’est pas valide avec System Center 2019 Operations Manager).

Exemples

Exemple 1 : Installer un agent sur un serveur

PS C:\>$PrimaryMgmtServer = Get-SCOMManagementServer -ComputerName "MgmtServer01.Contoso.com"
PS C:\> Install-SCOMAgent -DNSHostName "server01.contoso.com" -PrimaryManagementServer $PrimaryMgmtServer

Cet exemple installe un agent sur un serveur et définit le serveur d’administration principal de l’agent.

La première commande obtient l’objet serveur d’administration nommé MgmtServer01.Contoso.com et stocke l’objet dans la variable $PrimaryMgmtServer.

La deuxième commande installe un agent sur Server01.Contoso.com et définit son serveur d’administration principal sur le serveur d’administration stocké dans $PrimaryMgmtServer.

Exemple 2 : Installer un agent sur un serveur à l’aide des informations d’identification du compte d’action

PS C:\>$InstallAccount = Get-Credential
PS C:\> $PrimaryMgmtServer = Get-SCOMManagementServer -ComputerName "MgmtServer01.Contoso.com"
PS C:\> Install-SCOMAgent -DNSHostName "Server01.Contoso.com" -PrimaryManagementServer $PrimaryMgmtServer -ActionAccount $InstallAccount

Cet exemple invite l’utilisateur à entrer des informations d’identification, puis utilise les informations d’identification pour installer un agent.

La première commande invite l’utilisateur à entrer les informations d’identification et à stocker les informations d’identification dans la variable $InstallAccount.

La deuxième commande obtient l’objet serveur d’administration nommé MgmtServer01.Contoso.com et stocke l’objet dans la variable $PrimaryMgmtServer.

La troisième commande installe un agent sur Server01.Contoso.com à l’aide des informations d’identification stockées dans $InstallAccount et définit le serveur d’administration principal de l’agent sur le serveur d’administration stocké dans $PrimaryMgmtServer.

Exemple 3 : Installer un agent sur des serveurs et définir le compte d’action de l’agent

PS C:\>$Agents = "DC1.contoso.com","DC2.contoso.com","DC3.contoso.com"
PS C:\> $InstallAccount = Get-Credential
PS C:\> $AgentActionAccount = Get-Credential Contoso\ActionAccount
PS C:\> $PrimaryMgmtServer = Get-SCOMManagementserver -ComputerName MgmtServer01.contoso.com
PS C:\> $Install-SCOMAgent -DNSHostName $Agents -PrimaryManagementServer $PrimaryMgmtServer -ActionAccount $InstallAccount -AgentActionAccount $AgentActionAccount -Confirm

Cet exemple installe des agents sur trois ordinateurs et définit le compte d’action de l’agent pour les agents.

La première commande stocke le nom de trois ordinateurs dans la variable $Agents.

La deuxième commande invite l’utilisateur à entrer des informations d’identification et stocke les informations d’identification dans la variable $InstallAccount.

La troisième commande invite l’utilisateur à entrer un mot de passe pour un compte d’utilisateur nommé ActionAccount dans le domaine Contoso et stocke les informations d’identification dans la variable $AgentActionAccount.

La quatrième commande obtient l’objet serveur d’administration nommé MgmtServer01.Contoso.com et stocke l’objet dans la variable $PrimaryMgmtServer.

La cinquième commande installe un agent sur les trois ordinateurs stockés dans la variable $Agents à l’aide des informations d’identification stockées dans $InstallAccount. La commande définit le serveur d’administration principal de l’agent sur le serveur d’administration stocké dans $PrimaryMgmtServer et définit le compte d’action de l’agent sur l’utilisateur ActionAccount stocké dans $AgentActionAccount.

Paramètres

-ActionAccount

Spécifie un objet PSCredential. Ce paramètre spécifie les informations d’identification que Operations Manager utilise pour exécuter la tâche de déploiement. Il s’agit d’un paramètre obligatoire. Si vous spécifiez une valeur Null, Operations Manager utilise le compte d’action par défaut du serveur d’administration pour l’agent.

Ce paramètre ne spécifie pas le compte d’action que l’agent utilise après l’avoir installé sur l’ordinateur. Par défaut, le compte d’action que l’agent utilise est défini sur Système local. Vous pouvez utiliser le paramètre AgentActionAccount pour modifier le compte d’action utilisé par l’agent.

Pour obtenir un objet PSCredential, utilisez l’applet de commande Get-Credential . Pour plus d’informations, tapez Get-Help Get-Credential.

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

-AgentActionAccount

Spécifie un objet PSCredential. Ce paramètre spécifie le compte d’action que l’agent utilise après son installation sur l’ordinateur. Par défaut, le compte d’action que l’agent utilise est défini sur Système local. Pour obtenir un objet PSCredential, utilisez l’applet de commande Get-Credential . Pour plus d’informations, tapez Get-Help Get-Credential. Vous pouvez utiliser l’applet de commande get-SCOMRunAsProfile pour obtenir un compte d’identification que vous pouvez utiliser pour le compte d’action.

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

-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

-DNSHostName

Spécifie le nom d’un hôte DNS (Domain Name System).

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

-NoAPM

Il s’agit d’un paramètre facultatif introduit avec System Center Operations Manager 1807 (ce paramètre n’est pas valide avec System Center 2019 Operations Manager), ce qui vous permet de choisir l’installation du composant APM dans l’agent. Utilisez ce paramètre pour ignorer l’installation du composant APM dans l’agent.

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

-PassThru

Indique que l’applet de commande crée ou modifie un objet qu’une commande peut utiliser dans le pipeline. Par défaut, cette applet de commande ne génère aucune sortie.

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

-PrimaryManagementServer

Spécifie un objet ManagementServer. Ce paramètre spécifie le serveur d’administration principal de l’agent. Pour obtenir un objet ManagementServer, utilisez l’applet de commande Get-SCOMManagementServer .

Type:ManagementServer
Position:Named
Valeur par défaut:None
Obligatoire:True
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