Remove-CMCollectionDirectMembershipRule

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

デバイスまたはユーザー コレクションから直接メンバーシップ ルールを削除します。

構文

Remove-CMCollectionDirectMembershipRule
      -CollectionName <String>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionName <String>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionName <String>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionId <String>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionId <String>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionId <String>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

デバイスまたはユーザー コレクションから直接メンバーシップ規則を削除するには、このコマンドレットを使用します。 直接メンバーシップ規則を使用すると、コレクションのメンバーを明示的に選択できます。 既定のコレクションには直接メンバーシップ規則がありません。 ターゲットとするコレクションには、 SMSではなくサイト コードで始まる ID が必要です。 詳細については、「 Configuration Manager でコレクションを作成する方法」を参照してください。

コレクションから直接メンバーシップ規則を削除すると、リソースがコレクションのメンバーでなくなる可能性があります。 このアクションにより、ソフトウェアまたは構成のデプロイがリソースに適用されない可能性があります。

注:

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

例

例 1: テスト デバイスのコレクションからローカル コンピューターを削除する

この例では、Windows 環境変数 ComputerName を 使用して、 Test Devices という名前のコレクションから削除します。 Force パラメーターを使用して、確認を求めないようにします。

Remove-CMCollectionDirectMembershipRule -CollectionName 'Test Devices' -ResourceName $env:ComputerName -Force

パラメーター

-CollectionId

削除する直接ルールを使用して、コレクションの ID を指定します。 たとえば、「 "XYZ0003F" 」のように入力します。

型:String
Aliases:Id
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CollectionName

削除する直接ルールを使用して、コレクションの名前を指定します。

型:String
Aliases:Name
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Force

確認を求めずにコマンドを実行します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

削除する直接ルールを持つコレクション オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMCollection、 Get-CMDeviceCollection、または Get-CMUserCollection コマンドレットを 使用します。

型:IResultObject
Aliases:Collection
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Resource

コレクションから削除するリソース オブジェクトの配列を指定します。 このオブジェクトを取得するには、 Get-CMResource、 Get-CMDevice、または Get-CMUser コマンドレットを 使用します。

型:IResultObject[]
Aliases:Resources
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ResourceId

コレクションから削除するリソース ID の配列を指定します。 この値は、SMS_Resource クラスの ResourceId プロパティです。 たとえば、「 "33555693" 」のように入力します。

型:String[]
Aliases:ResourceIds
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ResourceName

コレクションから削除するリソース名の配列を指定します。

型:String[]
Aliases:ResourceNames
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:True

-WhatIf

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

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

メモ

このコマンドレットは、コレクションの種類に固有の Remove-CMDeviceCollectionDirectMembershipRule および Remove-CMUserCollectionDirectMembershipRule に似ています。 このコマンドレットは、デバイスまたはユーザー コレクションで動作します。