次の方法で共有

Install-SCOMAgent

  • リファレンス
モジュール:
OperationsManager

Operations Manager エージェントを展開します。

構文

Install-SCOMAgent
       -ActionAccount <PSCredential>
       [-AgentActionAccount <PSCredential>]
       -DNSHostName <String[]>
       -PrimaryManagementServer <ManagementServer>
       [-NoAPM]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

説明

Install-SCOMAgent コマンドレットは、クライアント プッシュ インストールを使用して、1 つ以上の 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変数にオブジェクトを格納します。

2 番目のコマンドは、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変数に格納します。

2 番目のコマンドは、MgmtServer01.Contoso.com という名前の管理サーバー オブジェクトを取得し、そのオブジェクトを $PrimaryMgmtServer 変数に格納します。

3 番目のコマンドでは、$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

この例では、3 台のコンピューターにエージェントをインストールし、エージェントのエージェント アクション アカウントを設定します。

最初のコマンドは、$Agents変数に 3 台のコンピューターの名前を格納します。

2 番目のコマンドは、ユーザーに資格情報の入力を求め、資格情報を $InstallAccount 変数に格納します。

3 番目のコマンドは、Contoso ドメインの ActionAccount という名前のユーザー アカウントのパスワードをユーザーに求め、資格情報を $AgentActionAccount 変数に格納します。

4 番目のコマンドは、MgmtServer01.Contoso.com という名前の管理サーバー オブジェクトを取得し、$PrimaryMgmtServer変数にオブジェクトを格納します。

5 番目のコマンドでは、$InstallAccountに格納されている資格情報を使用して、$Agents変数に格納されている 3 台のコンピューターにエージェントをインストールします。 このコマンドは、エージェントのプライマリ管理サーバーを$PrimaryMgmtServerに格納されている管理サーバーに設定し、$AgentActionAccountに格納されている ActionAccount ユーザーにエージェント アクション アカウントを設定します。

パラメーター

-ActionAccount

PSCredential オブジェクトを指定します。 このパラメーターは、Operations Manager が展開タスクの実行に使用する資格情報を指定します。 これは必須パラメーターです。 null 値を指定した場合、Operations Manager はエージェントの管理サーバーの既定のアクション アカウントを使用します。

このパラメーターでは、エージェントがコンピューターにインストールした後に使用するアクション アカウントは指定されません。 既定では、エージェントが使用するアクション アカウントはローカル システムに設定されます。 AgentActionAccount パラメーターを使用して、エージェントが使用するアクション アカウントを変更できます。

PSCredential オブジェクトを取得するには、Get-Credential コマンドレットを使用します。 詳細を表示するには「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 コマンドレットを使用します。 詳細を表示するには「Get-Help Get-Credential」を入力します。 Get-SCOMRunAsProfile コマンドレットを使用して、アクション アカウントに使用できる実行アカウントを取得できます。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

コマンドがパイプラインで使用できるオブジェクトをコマンドレットで作成または変更することを示します。 既定では、このコマンドレットによる出力はありません。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrimaryManagementServer

ManagementServer オブジェクトを指定します。 このパラメーターは、エージェントのプライマリ管理サーバーを指定します。 ManagementServer オブジェクトを取得するには、Get-SCOMManagementServer コマンドレットを使用します。

Type:ManagementServer
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False