次の方法で共有

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」と入力します。

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AgentActionAccount

PSCredential オブジェクトを指定します。 このパラメーターは、エージェントがコンピューターにインストールされた後に使用するアクション アカウントを指定します。 既定では、エージェントが使用するアクション アカウントはローカル システムに設定されます。 PSCredential オブジェクトを取得するには、Get-Credential コマンドレットを使用します。 詳細については、「Get-Help Get-Credential」と入力します。 Get-SCOMRunAsProfile コマンドレットを使用して、アクション アカウントに使用できる実行アカウントを取得できます。

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DNSHostName

ドメイン ネーム システム (DNS) ホストの名前を指定します。

型:String[]
Aliases:Name
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-NoAPM

これは、System Center Operations Manager 1807 で導入された省略可能なパラメーターです (このパラメーターは System Center 2019 Operations Manager では無効です)。これにより、エージェントへの APM コンポーネントのインストールを選択できます。 エージェントへの APM コンポーネントのインストールをスキップするには、このパラメーターを使用します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PassThru

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PrimaryManagementServer

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

型:ManagementServer
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False