Install-SCOMAgent
部署 Operations Manager 代理程式。
Syntax
Install-SCOMAgent
-ActionAccount <PSCredential>
[-AgentActionAccount <PSCredential>]
-DNSHostName <String[]>
-PrimaryManagementServer <ManagementServer>
[-NoAPM]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
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 |