Set-SCOMParentManagementServer

モジュール:

OperationsManager

エージェントまたはゲートウェイ管理サーバーのプライマリ管理サーバーとフェールオーバー管理サーバーを変更します。

構文

Set-SCOMParentManagementServer
   [-Agent] <AgentManagedComputer[]>
   [-PrimaryServer] <ManagementServer>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SCOMParentManagementServer
   [-Agent] <AgentManagedComputer[]>
   [-FailoverServer] <ManagementServer[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SCOMParentManagementServer
   [-PrimaryServer] <ManagementServer>
   [-GatewayServer] <ManagementServer[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SCOMParentManagementServer
   [-GatewayServer] <ManagementServer[]>
   [-FailoverServer] <ManagementServer[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-SCOMParentManagementServer コマンドレットは、エージェントまたはゲートウェイ管理サーバーのプライマリ管理サーバーとフェールオーバー管理サーバーを変更します。 System Center - Operations Manager では、プライマリ管理サーバーとフェールオーバー管理サーバーがエージェントとゲートウェイ管理サーバーの冗長性を提供します。

このコマンドレットには、エージェント オブジェクトまたはゲートウェイ管理サーバー オブジェクトと管理サーバー オブジェクトが必要です。 エージェント オブジェクトを取得する方法については、「Get-Help Get-SCOMAgent」と入力します。 ゲートウェイ管理サーバー オブジェクトを取得する方法については、「Get-Help Get-SCOMGatewayManagementServer」と入力します。

このコマンドレットは、同じコマンドでプライマリ サーバーとフェールオーバー管理サーバーの両方を変更することはできません。

例

例 1: プライマリ管理サーバーとフェールオーバー管理サーバーを設定する

$PrimaryMgmtServer = Get-SCOMManagementServer -Name "MS01-2016.contoso.com"
$FailoverMgmtServer = Get-SCOMManagementServer -Name "MS02-2016.contoso.com"
$Agent1 = "AGENT01-2016.contoso.com" | Get-SCOMAgent
$Agent1 | Set-SCOMParentManagementServer -FailoverServer $null | Out-Null
$Agent1 | Set-SCOMParentManagementServer -PrimaryServer $PrimaryMgmtServer -Passthru
$Agent1 | Set-SCOMParentManagementServer -FailoverServer $FailoverMgmtServer -Passthru
$Agent2 = "DC01-2016.contoso.com" | Get-SCOMAgent
$Agent2 | Set-SCOMParentManagementServer -FailoverServer $null | Out-Null
$Agent2 | Set-SCOMParentManagementServer -PrimaryServer $PrimaryMgmtServer -Passthru
$Agent2 | Set-SCOMParentManagementServer -FailoverServer $FailoverMgmtServer -Passthru

上記のスクリプトでは、フェールオーバーが$nullに設定され、プライマリ サーバーとフェールオーバー サーバーの設定に進みます。 これは、プライマリ サーバーまたはフェールオーバー サーバーを、エージェントのプライマリ サーバーまたはフェールオーバー サーバーの値で既に設定されているサーバー名に設定するときにエラーが発生しないようにするためです。

例 2: ゲートウェイ プライマリ サーバーとフェールオーバー サーバーを設定する

PS C:\>$PrimaryMgmtServer = Get-SCOMManagementServer -name "MgmtServer01.Contoso.com"
PS C:\> $FailoverMgmtServer = Get-SCOMManagementServer -Name "MgmtServer02.Contoso.com"
PS C:\> "GatewayMgmtServer01.Contoso.com" | Get-SCOMGatewayManagementServer | Set-SCOMParentManagementServer -PrimaryServer $PrimaryMgmtServer
PS C:\> "GatewayMgmtServer01.Contoso.com" | Get-SCOMGatewayManagementServer | Set-SCOMParentManagementServer -FailoverServer $FailoverMgmtServer

この例では、ゲートウェイ、プライマリ、およびフェールオーバーの親管理サーバーを設定します。

最初の 2 つのコマンドでは、Get-SCOMManagementServer コマンドレットを使用して、ゲートウェイ サーバーのプライマリ管理サーバーとして設定する管理サーバーと、ゲートウェイ サーバーのフェールオーバー管理サーバーとして設定する管理サーバーを取得します。 コマンドは、オブジェクトをそれぞれ$PrimaryMgmtServerに格納し、変数を$FailoverMgmtServerします。

3 番目のコマンドは、Get-SCOMGatewayManagementServer コマンドレットを使用して、GatewayMgmtServer01.Contoso.com という名前のゲートウェイ管理サーバーを取得し、結果を Set-SCOMParentManagementServer コマンドレットにパイプして、ゲートウェイ管理サーバーの$PrimaryMgmtServer変数で指定されたプライマリ管理サーバーを設定します。

4 番目のコマンドでは、Get-SCOMGatewayManagementServer コマンドレットを使用して、GatewayMgmtServer01.Contoso.com という名前のゲートウェイ管理サーバーを取得し、結果を Set-SCOMParentManagementServer コマンドレットにパイプして、ゲートウェイ管理サーバーの $FailoverMgmtServer 変数に指定されたフェールオーバー管理サーバーを設定します。

例 3: プライマリ管理サーバーを設定する

PS C:\>Set-SCOMParentManagementServer -Agent (Get-SCOMAgent -Name "Server01.Contoso.com") -PrimaryServer (Get-SCOMManagementServer -Name "MgmtServer01.Contoso.com")

次の使用例は、指定したエージェントのプライマリ管理サーバーを設定します。

最初に実行されるかっこ内のコマンドは、Server01 という名前のエージェントと MgmtServer01 という名前の管理サーバーを取得します。 次に、コマンドレットはコマンドの結果をかっこで囲んで Set-SCOMParentManagementServer コマンドレットに渡し、エージェントのプライマリ サーバーを設定します。

パラメーター

-Agent

エージェント オブジェクトの配列を指定します。 AgentManagedComputer オブジェクトを取得するには、Get-SCOMADAgent コマンドレットを使用します。

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

-Confirm

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

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

-FailoverServer

エージェントがフェールオーバー サーバーとして使用する管理サーバー オブジェクトの配列を指定します。 管理サーバー オブジェクトを取得する方法については、「Get-Help Get-SCOMManagementServer」と入力します。

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

-GatewayServer

ゲートウェイ管理サーバー オブジェクトの配列を指定します。 管理サーバー オブジェクトを取得する方法については、「Get-Help Get-SCOMGatewayManagementServer」と入力します。

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

-PassThru

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

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

-PrimaryServer

エージェントがプライマリ サーバーとして使用する管理サーバー オブジェクトの配列を指定します。

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

-WhatIf

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

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

メモ

• 同じコマンドでプライマリ管理サーバーとフェールオーバー管理サーバーの両方を変更することはできません。 両方を変更するには、例に示すように、Set-SCOMParentManagementServer 2 回実行します。

関連リンク

• Get-SCOMParentManagementServer