Install-SCOMAgent
Déploie des agents Operations Manager.
Syntaxe
Default (Par défaut)
Install-SCOMAgent
-ActionAccount <PSCredential>
[-AgentActionAccount <PSCredential>]
-DNSHostName <String[]>
-PrimaryManagementServer <ManagementServer>
[-NoAPM]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande install-SCOMAgent
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 Get-Help Get-Credential.
Propriétés du paramètre
| Type: | PSCredential |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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 Get-Help Get-Credential.
Vous pouvez utiliser l’applet de commande get-SCOMRunAsProfile
Propriétés du paramètre
| Type: | PSCredential |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DNSHostName
Spécifie le nom d’un hôte DNS (Domain Name System).
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Nom |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PrimaryManagementServer
Spécifie un objet ManagementServer.
Ce paramètre spécifie le serveur d’administration principal de l’agent.
Pour obtenir un objet
Propriétés du paramètre
| Type: | ManagementServer |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.