次の方法で共有

Set-SCOMLocation

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

エージェントで管理されるコンピューター、管理サーバー、またはリソース プールを場所に関連付けます。

構文

Set-SCOMLocation
   [-Agent] <AgentManagedComputer[]>
   -Location <EnterpriseManagementObject>
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMLocation
   [-ManagementServer] <ManagementServer[]>
   -Location <EnterpriseManagementObject>
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMLocation
   [-Pool] <ManagementServicePool[]>
   -Location <EnterpriseManagementObject>
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-SCOMLocation コマンドレットは、1 つ以上のエージェントで管理されるコンピューター、管理サーバー、またはリソース プールを場所に関連付けます。 このコマンドレットは、現在の関連付けが存在する場合は削除します。 Web アプリケーションの可用性監視の概要マップ ダッシュボードには、場所に関連付けられているエージェント、管理サーバー、およびリソース プールの状態情報が表示されます。

関連付けを削除するには、Remove-SCOMLocation コマンドレットを使用します。 New-SCOMLocation コマンドレットを使用して場所を作成できます。

既定では、このコマンドレットは、管理グループへのアクティブな永続的な接続を使用します。 SCSession パラメーターを使用して、別の永続的な接続を指定します。 ComputerName パラメーターと Credential パラメーターを使用して、管理グループへの一時的な接続を作成できます。 詳細については、「Get-Help about_OpsMgr_Connections」と入力します。

例

例 1: エージェントを場所に関連付ける

PS C:\>$Location = Get-SCOMLocation -DisplayName "Seattle, WA"
PS C:\> $Agent = Get-SCOMAgent -Name "Server01.Contoso.com"
PS C:\> Set-SCOMLocation -Location $Location -Agent $Agent

この例では、Sever01.Contoso.com という名前のエージェントで管理されるコンピューターを、ワシントン州シアトルの場所に関連付けます。 最初のコマンドは、Wa 州シアトルの表示名を持つ場所オブジェクトを取得し、そのオブジェクトを $Location 変数に格納します。

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

3 番目のコマンドは、$Location変数に格納されている場所を、$Agent変数に格納されているエージェントで管理されるコンピューターに関連付けます。 以前にこのエージェントで管理されたコンピューターを場所に関連付けておいた場合、コマンドはその関連付けを削除します。

例 2: 管理サーバーを場所に関連付ける

PS C:\>$Location = Get-SCOMLocation -DisplayName "New York, NY"
PS C:\> $MgmtServer = Get-SCOMManagementServer -Name "MgmtServer01.Contoso.com"
PS C:\> Set-SCOMLocation -Location $Location -ManagementServer $MgmtServer

次の使用例は、MgmtServer01.Contoso.com という名前の管理サーバーをニューヨーク州ニューヨークの場所に関連付けます。 最初のコマンドは、ニューヨーク州ニューヨークの表示名を持つ場所オブジェクトを取得し、そのオブジェクトを$Location変数に格納します。

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

3 番目のコマンドは、$Location変数に格納されている場所を、$MgmtServer変数に格納されている管理サーバーに関連付けます。 以前にこの管理サーバーを場所に関連付けておいた場合、コマンドはその関連付けを削除します。

例 3: リソース プールを場所に関連付ける

PS C:\>$Location = Get-SCOMLocation -DisplayName "Paris, FR"
PS C:\> $Pool = Get-SCOMResourcePool -Name "Notifications Resource Pool"
PS C:\> Set-SCOMLocation -Location $Location -Pool $Pool

次の使用例は、Notifications リソース プールという名前のリソース プールをパリ (FR) の場所に関連付けます。 最初のコマンドは、表示名パリ、FR を持つ場所オブジェクトを取得し、$Location変数にオブジェクトを格納します。

2 番目のコマンドは、Notifications Resource Pool という名前のリソース プールを取得し、オブジェクトを $Pool 変数に格納します。

3 番目のコマンドは、$Location変数に格納されている場所を、$Pool変数に格納されているリソース プールに関連付けます。 以前にリソース プールを場所に関連付けておいた場合、コマンドはその関連付けを削除します。

パラメーター

-Agent

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

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

-ComputerName

コンピューターの名前の配列を指定します。 コマンドレットは、これらのコンピューターの管理グループとの一時的な接続を確立します。 NetBIOS 名、IP アドレス、または完全修飾ドメイン名 (FQDN) を使用できます。 ローカル コンピューターを指定するには、コンピューター名、localhost、またはドット (.) を入力します。

System Center Data Access サービスがコンピューター上で実行されている必要があります。 コンピューターを指定しない場合、コマンドレットは現在の管理グループ接続にコンピューターを使用します。

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

-Confirm

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

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

-Credential

管理グループ接続 PSCredential オブジェクトを指定します。 PSCredential オブジェクトを取得するには、Get-Credential コマンドレットを使用します。 詳細については、「Get-Help Get-Credential」と入力します。

ComputerName パラメーターでコンピューターを指定する場合は、そのコンピューターにアクセスできるアカウントを使用します。 既定値は現在のユーザーです。

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

-Location

EnterpriseManagementObject オブジェクトとして場所を指定します。 場所を取得するには、Get-SCOMLocation コマンドレットを使用します。

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

-ManagementServer

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

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

-PassThru

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

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

-Pool

リソース プール オブジェクトの配列を指定します。 リソース プール オブジェクトを取得するには、Get-SCOMResourcePool コマンドレットを使用します。

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

-SCSession

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

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

-WhatIf

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

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