Install-SCOMAgent
部署 Operations Manager 代理。
语法
Install-SCOMAgent
-ActionAccount <PSCredential>
[-AgentActionAccount <PSCredential>]
-DNSHostName <String[]>
-PrimaryManagementServer <ManagementServer>
[-NoAPM]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]说明
Install-SCOMAgent cmdlet 使用客户端推送安装部署一个或多个 System Center 2019 - Operations Manager 和更高产品版本代理。 注意：[-NoAPM] 参数在 System Center Operations Manager 1807 中引入， (此参数对 System Center 2019 Operations Manager) 无效。
示例
示例 1：在服务器上安装代理
PS C:\>$PrimaryMgmtServer = Get-SCOMManagementServer -ComputerName "MgmtServer01.Contoso.com"
PS C:\> Install-SCOMAgent -DNSHostName "server01.contoso.com" -PrimaryManagementServer $PrimaryMgmtServer本示例在服务器上安装代理，并为代理设置主管理服务器。
第一个命令获取名为 MgmtServer01.Contoso.com 的管理服务器对象，并将对象存储在$PrimaryMgmtServer变量中。
第二个命令在 Server01.Contoso.com 上安装代理，并将其主管理服务器设置为存储在 $PrimaryMgmtServer 中的管理服务器。
示例 2：使用操作帐户凭据在服务器上安装代理
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本示例提示用户输入凭据，然后使用凭据安装代理。
第一个命令提示用户输入凭据，并将凭据存储在$InstallAccount变量中。
第二个命令获取名为 MgmtServer01.Contoso.com 的管理服务器对象，并将对象存储在$PrimaryMgmtServer变量中。
第三个命令使用存储在 $InstallAccount 中的凭据在 Server01.Contoso.com 上安装代理，并将代理的主管理服务器设置为存储在$PrimaryMgmtServer的管理服务器。
示例 3：在服务器上安装代理并设置代理操作帐户
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本示例在三台计算机上安装代理，并设置代理的代理操作帐户。
第一个命令将三台计算机的名称存储在$Agents变量中。
第二个命令提示用户输入凭据，并将凭据存储在$InstallAccount变量中。
第三个命令提示用户输入 Contoso 域中名为 ActionAccount 的用户帐户的密码，并将凭据存储在$AgentActionAccount变量中。
第四个命令获取名为 MgmtServer01.Contoso.com 的管理服务器对象，并将对象存储在$PrimaryMgmtServer变量中。
第五个命令使用存储在 $InstallAccount 中的凭据在 $Agents 变量中存储的三台计算机上安装代理。 该命令将代理的主管理服务器设置为存储在$PrimaryMgmtServer的管理服务器，并将代理操作帐户设置为存储在 $AgentActionAccount 中的 ActionAccount 用户。
参数
-ActionAccount
指定 PSCredential 对象。 此参数指定 Operations Manager 用于运行部署任务的凭据。 这是必需的参数。 如果指定 null 值，Operations Manager 将为代理使用管理服务器的默认操作帐户。
此参数未指定代理在计算机上安装它后使用的操作帐户。 默认情况下，代理使用的操作帐户设置为本地系统。 可以使用 AgentActionAccount 参数更改代理使用的操作帐户。
若要获取 PSCredential 对象，请使用 Get-Credential cmdlet。
要了解详情，请键入 Get-Help Get-Credential。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AgentActionAccount
指定 PSCredential 对象。
此参数指定代理在计算机上安装后使用的操作帐户。
默认情况下，代理使用的操作帐户设置为本地系统。
若要获取 PSCredential 对象，请使用 Get-Credential cmdlet。
要了解详情，请键入 Get-Help Get-Credential。
可以使用 Get-SCOMRunAsProfile cmdlet 获取可用于操作帐户的运行方式帐户。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DNSHostName
指定域名系统 (DNS) 主机的名称。
| Type: | String[] |
| Aliases: | Name |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NoAPM
这是 System Center Operations Manager 1807 引入的可选参数， (此参数对 System Center 2019 Operations Manager) 无效，这允许你在代理中选择 APM 组件的安装。 使用此参数跳过代理中 APM 组件的安装。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
指示 cmdlet 创建或修改命令可以在管道中使用的对象。 默认情况下，此 cmdlet 将不产生任何输出。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrimaryManagementServer
指定 ManagementServer 对象。 此参数指定代理的主管理服务器。 若要获取 ManagementServer 对象，请使用 Get-SCOMManagementServer cmdlet。
| Type: | ManagementServer |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |