Remove-CMCollectionQueryMembershipRule

移除裝置或使用者集合中的查詢成員資格規則。

Syntax

Remove-CMCollectionQueryMembershipRule
      -InputObject <IResultObject>
      -RuleName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionQueryMembershipRule
      -CollectionName <String>
      -RuleName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionQueryMembershipRule
      -CollectionId <String>
      -RuleName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

使用此 Cmdlet 可移除裝置或使用者集合中的查詢成員資格規則。 _查詢_規則可讓您根據排程執行的查詢,動態更新集合的成員資格。 您無法移除預設集合中的查詢規則。 您目標的任何集合都應有以網站代碼開頭的 ID SMS 。 如需詳細資訊,請參閱 如何在 Configuration Manager 中建立集合

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

注意

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

範例

範例1:移除裝置集合的查詢成員資格規則

這個命令會從名為Windows 10 裝置的裝置集合中,移除名為TPM的查詢成員資格規則。

Remove-CMCollectionQueryMembershipRule -CollectionName "Windows 10 devices" -RuleName "TPM" -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

-InputObject

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

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

-RuleName

指定要從集合中移除的查詢規則名稱。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
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 類似于 CMDeviceCollectionQueryMembershipRuleremove-CMUserCollectionQueryMembershipRule,後者是特定于集合類型的。 此 Cmdlet 適用于裝置或使用者集合。