Set-SCOMLocation
エージェントで管理されるコンピューター、管理サーバー、またはリソース プールを場所に関連付けます。
構文
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 パラメーターと資格情報パラメーターを使用して、管理グループへの一時的な接続を作成できます。
詳細を表示するには「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 Resource Pool という名前のリソース プールをパリ FR の場所に関連付けます。 最初のコマンドは、表示名パリ、FR を持つ場所オブジェクトを取得し、$Location変数にオブジェクトを格納します。
2 番目のコマンドは、Notifications Resource Pool という名前のリソース プールを取得し、そのオブジェクトを $Pool 変数に格納します。
3 番目のコマンドは、$Location変数に格納されている場所を、$Pool変数に格納されているリソース プールに関連付けます。 以前にリソース プールを場所に関連付けておいた場合、コマンドはその関連付けを削除します。
パラメーター
-Agent
AgentManagedComputer オブジェクトの配列を指定します。 AgentManagedComputer オブジェクトを取得するには、Get-SCOMAgent コマンドレットを使用します。
| Type: | AgentManagedComputer[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ComputerName
コンピューターの名前の配列を指定します。 コマンドレットは、これらのコンピューターの管理グループとの一時的な接続を確立します。 NetBIOS 名、IP アドレス、または完全修飾ドメイン名 (FQDN) を使用できます。 ローカル コンピューターを指定するには、コンピューター名、localhost、またはドット (.) を入力します。
System Center Data Access サービスがコンピューター上で実行されている必要があります。 コンピューターを指定しない場合、コマンドレットは現在の管理グループ接続にコンピューターを使用します。
| Type: | String[] |
| 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 |
-Credential
管理グループ接続の PSCredential オブジェクトを指定します。
PSCredential オブジェクトを取得するには、Get-Credential コマンドレットを使用します。
詳細を表示するには「Get-Help Get-Credential」を入力します。
ComputerName パラメーターでコンピューターを指定する場合は、そのコンピューターにアクセスできるアカウントを使用します。 既定値は現在のユーザーです。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Location
場所を EnterpriseManagementObject オブジェクトとして指定します。 場所を取得するには、 Get-SCOMLocation コマンドレットを使用します。
| Type: | EnterpriseManagementObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ManagementServer
管理サーバー オブジェクトの配列を指定します。 管理サーバー オブジェクトを取得するには、 Get-SCOMManagementServer コマンドレットを 使用します。
| Type: | ManagementServer[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PassThru
パイプラインでコマンドが使用できるオブジェクトをコマンドレットで作成または変更することを示します。 既定では、このコマンドレットによる出力はありません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Pool
リソース プール オブジェクトの配列を指定します。 リソース プール オブジェクトを取得するには、 Get-SCOMResourcePool コマンドレットを 使用します。
| Type: | ManagementServicePool[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SCSession
Connection オブジェクトの配列を指定します。 Connection オブジェクトを取得するには、Get-SCOMManagementGroupConnection コマンドレットを使用します。
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |