Remove-CMBoundaryGroup

モジュール:

ConfigurationManager

境界グループを削除します。

構文

Remove-CMBoundaryGroup
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMBoundaryGroup
      [-Force]
      -Id <String[]>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMBoundaryGroup
      [-Force]
      -Name <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Remove-CMBoundaryGroup コマンドレットは、境界グループをConfiguration Managerから削除します。

注:

Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>)。 詳細については、「作業の 開始」を参照してください。

例

例 1: ID で指定された境界グループを削除する

PS XYZ:\> Remove-CMBoundaryGroup -Id "16777219"

このコマンドは、識別子によって指定された境界グループを削除します。 Force パラメーターが指定されていないため、アクションを実行する前に確認する必要があります。

例 2: InputObject を使用して複数の境界グループを削除する

PS XYZ:\> $BoundaryObj = Get-CMBoundary -Name "BGroup01", "BGroup02", "BGroup03"
PS XYZ:\> Remove-CMBoundary -InputObject $BoundaryObj

最初のコマンドでは 、Get-CMBoundaryGroup を使用して、名前で指定された複数の境界グループを取得し、このデータを $BoundaryObj 変数に格納します。

2 番目のコマンドは、入力オブジェクト $BoundaryObjを使用して指定された境界を識別して削除します。 Force パラメーターが指定されていないため、アクションを実行する前に確認する必要があります。

パラメーター

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

1 つ以上の境界グループの識別子 (ID) の配列を指定します。

Type:	String[]
Aliases:	GroupId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

このコマンドレットへの入力オブジェクトを指定します。 Get-CMBoundaryGroup コマンドレットを使用して、入力オブジェクトを取得できます。

Type:	IResultObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

境界グループの名前を指定します。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	True

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

関連リンク

• Get-CMBoundaryGroup
• New-CMBoundaryGroup
• Set-CMBoundaryGroup