Remove-CMCollectionIncludeMembershipRule
デバイスまたはユーザー コレクションから含めるメンバーシップ ルールを削除します。
構文
Remove-CMCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollectionName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollection <IResultObject>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollectionId <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollection <IResultObject>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollectionId <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollectionName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollection <IResultObject>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollectionId <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollectionName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
デバイスまたはユーザー コレクションから含めるメンバーシップ ルールを削除するには、このコマンドレットを使用します。 include メンバーシップ ルール には、ルールが適用されるコレクション内の別のコレクションのメンバーが含まれます。
詳細については 、「Configuration Manager でコレクションを作成する方法」を参照してください。
コレクションに対する include メンバーシップ ルールを削除すると、リソースがコレクションのメンバーでなくなる可能性があります。 このアクションを実行すると、ソフトウェアまたは構成の展開がリソースに適用されない可能性があります。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\>
。 詳細については 、「Getting started」を参照してください。
例
例 1: include メンバーシップ ルールを削除する
このコマンドは、Devices という名前のデバイス コレクションから All Systems コレクションの include メンバーシップ ルールを 削除します。 Force パラメーターを 指定 すると、プロンプトを表示せずにメンバーシップ ルールが削除されます。
Remove-CMCollectionIncludeMembershipRule -CollectionName "Devices" -IncludeCollectionName "All Systems" -Force
例 2: パイプラインを使用して include メンバーシップ ルールを削除する
このコマンドは、 まず Get-CMCollection コマンドレットを使用して、Users という名前のユーザー コレクション オブジェクトを 取得します。 次に、パイプライン 演算子を使用してオブジェクトを Remove-CMCollectionIncludeMembershipRule コマンドレットに渡 します。
Get-CMCollection -Name "Users" | Remove-CMCollectionIncludeMembershipRule -IncludeCollectionName "All Users" -Force
パラメーター
-CollectionId
ルールを削除するコレクションの ID を指定します。 この値は 、CollectionID プロパティです。たとえば XYZ00012
、 です。 既定のコレクションにはメンバーシップ ルールが含まれるので、この ID はサイト コードではなく、 で始まります SMS
。
Type: | String |
Aliases: | Id |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
ルールを削除するコレクションの名前を指定します。
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
確認を求めずにコマンドを実行します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeCollection
ルールを削除する対象のコレクションのオブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMCollectionコマンドレット 、Get-CMDeviceCollectionコマンドレット、 または Get-CMUserCollection コマンドレットを使用します。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeCollectionId
ルールを削除する含まれるコレクションの ID を指定します。 この値は 、CollectionID プロパティです。たとえば XYZ00012
、 です。 既定のコレクションを含め、この値はサイト コードまたは SMS
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeCollectionName
ルールを削除する含まれるコレクションの名前を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
ルールを削除するコレクションのオブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMCollectionコマンドレット 、Get-CMDeviceCollectionコマンドレット、 または Get-CMUserCollection コマンドレットを使用します。
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object
メモ
このコマンドレットは 、Remove-CMDeviceCollectionIncludeMembershipRule と Remove-CMUserCollectionIncludeMembershipRuleに似ています。これはコレクションの種類に固有です。 このコマンドレットは、デバイス またはユーザー コレクションで動作します。
関連リンク
- Get-CMCollectionIncludeMembershipRule
- Remove-CMCollectionDirectMembershipRule
- Remove-CMCollectionExcludeMembershipRule
- Remove-CMCollectionQueryMembershipRule
- Add-CMDeviceCollectionIncludeMembershipRule
- Add-CMUserCollectionIncludeMembershipRule
- Get-CMDeviceCollectionIncludeMembershipRule
- Get-CMUserCollectionIncludeMembershipRule
- Get-CMCollection
- Get-CMDeviceCollection
- Get-CMUserCollection
- Configuration Manager でコレクションを作成する方法