Get-CMCollectionQueryMembershipRule

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

デバイスまたはユーザー コレクションのクエリ メンバーシップルールを取得します。

構文

Get-CMCollectionQueryMembershipRule
   -CollectionName <String>
   [-RuleName <String>]
   [<CommonParameters>]
Get-CMCollectionQueryMembershipRule
   -CollectionId <String>
   [-RuleName <String>]
   [<CommonParameters>]
Get-CMCollectionQueryMembershipRule
   -InputObject <IResultObject>
   [-RuleName <String>]
   [<CommonParameters>]

説明

このコマンドレットを使用して、デバイスまたはユーザー コレクションの 1 つ以上のクエリ メンバーシップ規則を取得します。 クエリ ルールを使用すると、スケジュールに基づいて実行されるクエリに基づいて、コレクションのメンバーシップを動的に更新できます。 詳細については、「 Configuration Manager でコレクションを作成する方法」を参照してください。

メンバーシップ ルールの詳細については、「 Configuration Manager のコレクションの概要」を参照してください。

注:

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

例

例 1: All Systems コレクションのすべてのクエリ メンバーシップ ルールを取得する

このコマンドは、 すべてのシステムという名前の既定のデバイス コレクションからクエリ メンバーシップルールを取得します。

Get-CMCollectionQueryMembershipRule -CollectionName "All Systems"

例 2: All Users コレクションのルールのクエリ式を表示する

このコマンドは、All Users コレクションから All Users という名前のクエリ メンバーシップ ルールを取得し、クエリ式を返します。

Get-CMCollectionQueryMembershipRule -CollectionId "SMS00002" -RuleName "All Users" | Select-Object QueryExpression

パラメーター

-CollectionId

規則を取得するコレクションの ID を指定します。 この値は CollectionID プロパティです (たとえば、 XYZ00012 や SMS00001)。

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

-CollectionName

規則を取得するコレクションの名前を指定します。

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

-InputObject

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

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

-RuleName

コレクションから取得するクエリ ルールの名前を指定します。

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

メモ

このコマンドレットは、コレクションの種類に固有の Get-CMDeviceCollectionQueryMembershipRule と Get-CMUserCollectionQueryMembershipRule に似ています。 このコマンドレットは、デバイスまたはユーザー コレクションで動作します。