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
指定集合的物件,以移除規則。 若要取得此物件,請使用 CMCollection、 CMDeviceCollection或 CMUserCollection 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 類似于 CMDeviceCollectionQueryMembershipRule 和 remove-CMUserCollectionQueryMembershipRule,後者是特定于集合類型的。 此 Cmdlet 適用于裝置或使用者集合。
相關連結
- CMCollectionQueryMembershipRule
- Remove-CMCollectionDirectMembershipRule
- Remove-CMCollectionExcludeMembershipRule
- Remove-CMCollectionIncludeMembershipRule
- 載入 CMDeviceCollectionQueryMembershipRule
- 載入 CMUserCollectionQueryMembershipRule
- CMDeviceCollectionQueryMembershipRule
- CMUserCollectionQueryMembershipRule
- CMCollection
- CMDeviceCollection
- CMUserCollection
- 如何在 Configuration Manager 中建立集合