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 コマンドレットを使用します。

Type:	AgentManagedComputer[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

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

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

-FailoverServer

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

Type:	ManagementServer[]
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-GatewayServer

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

Type:	ManagementServer[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PassThru

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

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

-PrimaryServer

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

Type:	ManagementServer
Position:	2
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

メモ

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

関連リンク

• Get-SCOMParentManagementServer