次の方法で共有

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 パラメーターと Credential パラメーターを使用して、管理グループへの一時的な接続を作成できます。 詳細については、「Get-Help about_OpsMgr_Connections」と入力します。

例

例 1: 場所を削除する

PS C:\>$Location = Get-SCOMLocation -DisplayName "Seattle, WA"
PS C:\> Remove-SCOMLocation -Location $Location

次の使用例は、表示名 Seattle (WA) を持つ場所を削除します。 最初のコマンドは、表示名 Seattle (WA) を持つ location オブジェクトを取得し、そのオブジェクトを $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 リソース プールという名前のリソース プールをその場所から削除します。 最初のコマンドは、Notifications Resource Pool という名前のリソース プールのリソース プール オブジェクトを取得し、そのオブジェクトを $Pool 変数に格納します。

2 番目のコマンドは、$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[]
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ManagementServer

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

型:ManagementServer[]
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る: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