Add-CMUserCollectionQueryMembershipRule
將查詢成員資格規則新增至使用者集合。
Syntax
Add-CMUserCollectionQueryMembershipRule
-InputObject <IResultObject>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionQueryMembershipRule
-CollectionId <String>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionQueryMembershipRule
-CollectionName <String>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
使用此 Cmdlet 將查詢成員資格規則新增至使用者集合。
_查詢_規則可讓您根據排程執行的查詢，動態更新集合的成員資格。
您無法將成員資格規則新增至預設集合。 您目標的任何集合都應有以網站代碼開頭的 ID SMS 。
如需詳細資訊，請參閱 如何在 Configuration Manager 中建立集合。
注意
從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。 如需詳細資訊，請參閱 快速入門。
範例
範例1：新增查詢成員資格規則
這個範例會先將 WMI 查詢語言 (WQL) 語句儲存至 WQL 變數中。 下一個命令會將名為 遠端使用者 的成員資格規則新增至名為 遠端使用者的使用者集合。 QueryExpression參數會使用wql變數，並指定定義成員資格規則的查詢。
$wql = "select SMS_R_USER.ResourceID,SMS_R_USER.ResourceType,SMS_R_USER.Name,SMS_R_USER.UniqueUserName,SMS_R_USER.WindowsNTDomain from SMS_R_User"
Add-CMUserCollectionQueryMembershipRule -CollectionName "Remote Users" -QueryExpression $wql -RuleName "Remote users by domain"參數
-CollectionId
指定要新增規則的使用者集合識別碼。 此值為 CollectionID 屬性，例如 XYZ00012 。 因為您無法將成員資格規則新增至預設集合，所以這個識別碼會以網站程式碼為開頭 SMS 。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionName
指定要新增規則的使用者集合名稱。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
這個參數會處理萬用字元，而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
指定使用者集合的物件以新增規則。 若要取得此物件，請使用 CMCollection 或 CMUserCollection Cmdlet。
| Type: | IResultObject |
| Aliases: | Collection |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PassThru
新增此參數可傳回代表您正在使用之專案的物件。 根據預設，此 Cmdlet 可能不會產生任何輸出。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-QueryExpression
指定 WMI 查詢語言 (WQL) 運算式，網站會使用該運算式來更新使用者集合。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RuleName
指定要新增至集合的查詢規則名稱。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ValidateQueryHasResult
新增此參數可在新增規則之前測試查詢運算式。 當 Cmdlet 以此參數執行時，如果查詢運算式沒有任何結果，則 Cmdlet 會傳回下列錯誤訊息： No object corresponds to the specified parameters. 在此情況下，查詢不會新增至集合。
如果您知道查詢目前會傳回零結果，但仍想要新增規則，請勿使用此參數。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
ConfigurationManagement IResultObject
輸出
系統.物件