Remove-SCOMLocation

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

場所との関連付けを削除するか、場所を削除します。

構文

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