Remove-CMCollectionIncludeMembershipRule

從裝置或使用者集合中移除包含成員資格規則。

Syntax

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>]

Description

使用此 Cmdlet 從裝置或使用者集合中移除包含成員資格規則。 _包含_成員資格規則包括集合中套用規則之另一個集合的成員。

如需詳細資訊,請參閱 如何在 Configuration Manager 中建立集合

當您移除集合中的包含成員資格規則時,資源可能不再是該集合的成員。 這種動作可能會導致任何軟體或設定部署不會套用至資源。

注意

從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\> 。 如需詳細資訊,請參閱 快速入門。

範例

範例1:移除包含成員資格規則

此命令會從名為 device 的裝置集合中,移除 [所有系統] 集合的包含成員資格規則。 指定 Force 參數會指出成員資格規則已移除,而不會提示您。

Remove-CMCollectionIncludeMembershipRule -CollectionName "Devices" -IncludeCollectionName "All Systems" -Force

範例2:使用管線移除包含成員資格規則

此命令會先使用 CMCollection 指令程式 ,以取得名為 Users的 user 集合物件。 然後使用管線運算子將物件傳遞至 CMCollectionIncludeMembershipRule Cmdlet。

Get-CMCollection -Name "Users" | Remove-CMCollectionIncludeMembershipRule -IncludeCollectionName "All Users" -Force

參數

-CollectionId

指定集合的識別碼,以移除規則。 此值為 CollectionID 屬性,例如 XYZ00012 。 因為預設集合不包含成員資格規則,所以此識別碼會以網站程式碼開頭 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

執行 Cmdlet 之前提示您確認。

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

指定包含集合的物件,以移除規則。 若要取得此物件,請使用 CMCollectionCMDeviceCollectionCMUserCollection Cmdlet。

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

-IncludeCollectionId

指定包含的集合的識別碼,以移除規則。 此值為 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

指定集合的物件,以移除規則。 若要取得此物件,請使用 CMCollectionCMDeviceCollectionCMUserCollection Cmdlet。

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

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。

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

輸入

ConfigurationManagement IResultObject

輸出

系統.物件

備註

此 Cmdlet 類似于 CMDeviceCollectionIncludeMembershipRuleremove-CMUserCollectionIncludeMembershipRule,後者是特定于集合類型的。 此 Cmdlet 適用于裝置或使用者集合。