Install-SCOMAgent
Déploie des agents Operations Manager.
Syntax
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 $PrimaryMgmtServerCet 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 $InstallAccountCet 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 -ConfirmCet 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 les 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. Ce paramètre est 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 utilisé par l’agent après l’avoir installé sur l’ordinateur. Par défaut, le compte d’action utilisé par l’agent est défini sur Le 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, voir Get-Help Get-Credential.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AgentActionAccount
Spécifie un objet PSCredential .
Ce paramètre spécifie le compte d’action utilisé par l’agent après son installation sur l’ordinateur.
Par défaut, le compte d’action utilisé par l’agent est défini sur Le système local.
Pour obtenir un objet PSCredential, utilisez l'applet de commande Get-Credential.
Pour plus d'informations, voir 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DNSHostName
Spécifie le nom d’un hôte DNS (Domain Name System).
| Type: | String[] |
| Aliases: | Name |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 aucun résultat.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |