Remove-SCOMLocation
場所との関連付けを削除するか、場所を削除します。
構文
Remove-SCOMLocation
[-Agent] <AgentManagedComputer[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Remove-SCOMLocation
[-ManagementServer] <ManagementServer[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Remove-SCOMLocation
[-Pool] <ManagementServicePool[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Remove-SCOMLocation
[-Location] <EnterpriseManagementObject[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]説明
Remove-SCOMLocation コマンドレットは、エージェントが管理するコンピューター、管理サーバー、またはリソース プールとの場所の関連付けを削除するか、場所を削除します。 関連付けを削除するには、エージェントで管理されるコンピューター、管理サーバー、またはリソース プールを指定します。 場所を削除するには、 Get-SCOMLocation コマンドレットを使用して場所を指定します。
Update-SCOMLocation コマンドレットを使用して、場所の表示名、緯度、経度を変更できます。
既定では、このコマンドレットは、管理グループへのアクティブな永続的な接続を使用します。
SCSession パラメーターを使用して、別の永続接続を指定します。
ComputerName パラメーターと資格情報パラメーターを使用して、管理グループへの一時的な接続を作成できます。
詳細を表示するには「Get-Help about_OpsMgr_Connections」を入力します。
例
例 1: 場所を削除する
PS C:\>$Location = Get-SCOMLocation -DisplayName "Seattle, WA"
PS C:\> Remove-SCOMLocation -Location $Location次の使用例は、シアトル (WA) という表示名を持つ場所を削除します。 最初のコマンドは、シアトル、WA の表示名を持つ場所オブジェクトを取得し、$Location変数にオブジェクトを格納します。
2 番目のコマンドは、$Location変数に格納されている場所オブジェクトを削除します。
例 2: エージェントで管理されるコンピューターを場所から削除する
PS C:\>$Agent = Get-SCOMAgent -Name "Server73.Contoso.com"
PS C:\> Remove-SCOMLocation -Agent $Agent次の使用例は、Server73.Contoso.com という名前のエージェントで管理されるコンピューターをその場所から削除します。 最初のコマンドは、Server73.Contoso.com という名前のコンピューターのエージェント オブジェクトを取得し、そのオブジェクトを $Agent 変数に格納します。
2 番目のコマンドは、$Agent変数に格納されているエージェントで管理されるコンピューター オブジェクトから場所の関連付けを削除します。 このコマンドでは、場所自体は削除されません。
例 3: 場所から管理サーバーを削除する
PS C:\>$MgmtServer = Get-SCOMManagementServer -Name "MgmtServer01.Contoso.com"
PS C:\> Remove-SCOMLocation -ManagementServer $MgmtServer次の使用例は、管理サーバーをその場所から削除します。 最初のコマンドは、MgmtServer01.Contoso.com という名前の管理サーバー オブジェクトを取得し、そのオブジェクトを$MgmtServer変数に格納します。
2 番目のコマンドは、$MgmtServer変数に格納されている管理サーバー オブジェクトから場所の関連付けを削除します。 このコマンドでは、場所自体は削除されません。
例 4: 場所からリソース プールを削除する
PS C:\>$Pool = Get-SCOMResourcePool -Name "Notifications Resource Pool"
PS C:\> Remove-SCOMLocation -Pool $Pool次の使用例は、Notifications Resource Pool という名前のリソース プールをその場所から削除します。 最初のコマンドは、Notifications Resource Pool という名前のリソース プールのリソース プール オブジェクトを取得し、そのオブジェクトを $Pool 変数に格納します。
2 番目のコマンドは、$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: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ManagementServer
管理サーバー オブジェクトの配列を指定します。 管理サーバー オブジェクトを取得するには、 Get-SCOMManagementServer コマンドレットを 使用します。
| Type: | ManagementServer[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| 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 |