Add-CMDeviceCollectionQueryMembershipRule

  • リファレンス
モジュール:
ConfigurationManager

デバイス コレクションにクエリ メンバーシップルールを追加します。

構文

Add-CMDeviceCollectionQueryMembershipRule
   -CollectionId <String>
   [-PassThru]
   -QueryExpression <String>
   -RuleName <String>
   [-ValidateQueryHasResult]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionQueryMembershipRule
   -CollectionName <String>
   [-PassThru]
   -QueryExpression <String>
   -RuleName <String>
   [-ValidateQueryHasResult]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionQueryMembershipRule
   -InputObject <IResultObject>
   [-PassThru]
   -QueryExpression <String>
   -RuleName <String>
   [-ValidateQueryHasResult]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットを使用して、デバイス コレクションにクエリ メンバーシップ規則を追加します。 クエリ ルールを使用すると、スケジュールに基づいて実行されるクエリに基づいて、コレクションのメンバーシップを動的に更新できます。 メンバーシップ ルールを既定のコレクションに追加することはできません。 ターゲットとするコレクションには、 SMSではなくサイト コードで始まる ID が必要です。 詳細については、「 Configuration Manager でコレクションを作成する方法」を参照してください。

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例

例 1: クエリ メンバーシップ ルールを追加する

この例では、最初に WMI クエリ言語 (WQL) ステートメントを wql 変数に格納します。 次のコマンドでは、 TPM という名前のメンバーシップ規則を Windows 10 デバイスという名前のデバイス コレクションに追加します。 QueryExpression パラメーターは wql 変数を使用し、メンバーシップ規則を定義するクエリを指定します。

$wql = "select SMS_R_System.ResourceId, SMS_R_System.ResourceType, SMS_R_System.Name, SMS_R_System.SMSUniqueIdentifier, SMS_R_System.ResourceDomainORWorkgroup, SMS_R_System.Client from  SMS_R_System inner join SMS_G_System_TPM on SMS_G_System_TPM.ResourceID = SMS_R_System.ResourceId"

Add-CMDeviceCollectionQueryMembershipRule -CollectionName "Windows 10 devices" -QueryExpression $wql -RuleName "TPM"

パラメーター

-CollectionId

規則を追加するデバイス コレクションの ID を指定します。 この値は CollectionID プロパティです (たとえば、 XYZ00012)。 既定のコレクションにメンバーシップ ルールを追加できないため、この ID はサイト コードで始まり、 SMSではありません。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CollectionName

規則を追加するデバイス コレクションの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

規則を追加するデバイス コレクションのオブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMCollection コマンドレットまたは Get-CMDeviceCollection コマンドレットを 使用します。

型:IResultObject
Aliases:Collection
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-PassThru

このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-QueryExpression

サイトがデバイス コレクションの更新に使用する WMI クエリ言語 (WQL) 式を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RuleName

コレクションに追加するクエリ ルールの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ValidateQueryHasResult

ルールを追加する前に、クエリ式をテストするには、このパラメーターを追加します。 このパラメーターを使用してコマンドレットを実行すると、クエリ式に結果がない場合、コマンドレットは次のエラー メッセージを返します。 No object corresponds to the specified parameters. この場合、クエリはコレクションに追加されません。

クエリが現在 0 個の結果を返しているのにルールを追加することがわかっている場合は、このパラメーターを使用しないでください。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object