Install-SCOMAgent
部署 Operations Manager 代理。
语法
Default （默认值）
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。
参数属性
| 类型: | PSCredential |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-AgentActionAccount
指定 PSCredential 对象。
此参数指定代理在计算机上安装后使用的作帐户。
默认情况下，代理使用的作帐户设置为本地系统。
若要获取 PSCredential 对象，请使用 Get-Credential cmdlet。
要了解详情，请键入 Get-Help Get-Credential。
可以使用 Get-SCOMRunAsProfile cmdlet 获取可用于作帐户的运行方式帐户。
参数属性
| 类型: | PSCredential |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
在运行 cmdlet 之前，提示你进行确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DNSHostName
指定域名系统 （DNS） 主机的名称。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 名称 |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-NoAPM
这是 System Center Operations Manager 1807 引入的可选参数（此参数对 System Center 2019 Operations Manager 无效），它允许你选择在代理中安装 APM 组件。 使用此参数可以跳过代理中 APM 组件的安装。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PassThru
指示 cmdlet 创建或修改命令可在管道中使用的对象。 默认情况下，此 cmdlet 不生成任何输出。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PrimaryManagementServer
指定 ManagementServer 对象。 此参数指定代理的主管理服务器。 若要获取 ManagementServer 对象，请使用 Get-SCOMManagementServer cmdlet。
参数属性
| 类型: | ManagementServer |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。