Add-CMUserCollectionQueryMembershipRule
ユーザー コレクションにクエリ メンバーシップ ルールを追加します。
構文
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>]
説明
このコマンドレットを使用して、ユーザー コレクションにクエリ メンバーシップ ルールを追加します。
クエリ ルール を使用すると、スケジュールに従って実行されるクエリに基づいてコレクションのメンバーシップを動的に更新できます。
既定のコレクションにメンバーシップ ルールを追加できない。 ターゲットとするコレクションには、サイト コードで始まる ID を持つ必要があります SMS
。
詳細については 、「Configuration Manager でコレクションを作成する方法」を参照してください。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\>
。 詳細については 、「Getting started」を参照してください。
例
例 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
ルールを追加するユーザー コレクションの ID を指定します。 この値は 、CollectionID プロパティです。たとえば XYZ00012
、 です。 既定のコレクションにメンバーシップ ルールを追加できないので、この ID はサイト コードではなく、 で始まります 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
コマンドレットを実行する前に確認メッセージを表示します。
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
ルールを追加するユーザー コレクションのオブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMCollection コマンドレット または Get-CMUserCollection コマンドレット を使用します。
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
このパラメーターを追加して、作業しているアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
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
このパラメーターを追加して、ルールを追加する前にクエリ式をテストします。 このパラメーターを使用してコマンドレットを実行すると、クエリ式に結果がない場合、コマンドレットは次のエラー メッセージを返します。この場合、クエリはコレクション No object corresponds to the specified parameters.
に追加されません。
クエリが現在結果を 0 に戻しているが、ルールを追加する場合は、このパラメーターを使用しない必要があります。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object