Remove-CMDeviceCollectionQueryMembershipRule
從裝置集合中移除查詢成員資格規則。
語法
Remove-CMDeviceCollectionQueryMembershipRule
-InputObject <IResultObject>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMDeviceCollectionQueryMembershipRule
-CollectionName <String>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMDeviceCollectionQueryMembershipRule
-CollectionId <String>
-RuleName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用此 Cmdlet 從裝置集合中移除查詢成員資格規則。
查詢規則可讓您根據依排程執行的查詢,動態更新集合的成員資格。
您無法從預設集合中移除查詢規則。 您目標的任何集合都應該有以月臺碼開頭的識別碼,而不是 SMS
。
如需詳細資訊,請 參閱如何在 Configuration Manager 中建立集合。
當您從集合中移除查詢成員資格規則時,多個資源可能不再是集合的成員。 此動作可能會導致任何軟體或設定部署不適用於裝置。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 1:移除裝置集合的查詢成員資格規則
此命令會從名為 Windows 10 裝置的裝置集合中移除名為 TPM 的查詢成員資格規則。
Remove-CMDeviceCollectionQueryMembershipRule -CollectionName "Windows 10 devices" -RuleName "TPM" -Force
參數
-CollectionId
指定要移除規則之裝置集合的標識碼。 這個值是 CollectionID 屬性, 例如 。 XYZ00012
因為您無法從預設集合中移除查詢規則,所以此識別子會以月臺碼開頭,而不是 SMS
。
類型: | String |
別名: | Id |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-CollectionName
指定要移除規則的裝置集合名稱。
類型: | String |
別名: | Name |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Force
執行命令而不要求確認。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-InputObject
指定要移除規則之裝置集合的物件。 若要取得此物件,請使用 Get-CMCollection 或 Get-CMDeviceCollection Cmdlet。
類型: | IResultObject |
別名: | Collection |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-RuleName
指定要從集合中移除的查詢規則名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object