Get-CMQuery

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

Configuration Manager クエリを取得します。

構文

Get-CMQuery
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMQuery
   [-Id <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

説明

Configuration Manager サイトからクエリを取得するには、このコマンドレットを使用します。 Configuration Manager クエリでは、指定した条件に基づいてサイト データベースから情報を取得する WMI クエリ言語 (WQL) 式を定義します。 WQL は SQL に似ていますが、引き続きデータベースに直接ではなく SMS プロバイダーを経由します。 そのため、WQL は引き続きロールベースのアクセス構成に従います。

クエリは、コンピューター、サイト、コレクション、アプリケーション、インベントリ データなど、ほとんどの種類の Configuration Manager オブジェクトを返すことができます。 詳細については、「 Configuration Manager でのクエリの概要」を参照してください。

既定では、Configuration Manager には複数のクエリが含まれています。 このコマンドレットを使用して、既定のクエリを確認できます。

注:

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

例

例 1

このコマンドは、"ConfigMgr クライアント" を含む名前のすべてのクエリを返します。

Get-CMQuery -Name "*ConfigMgr clients *"

パラメーター

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-Id

取得するクエリの ID を指定します。 たとえば、「 "XYZ00006" 」のように入力します。

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

-Name

取得するクエリの名前を指定します。

ワイルドカード文字を使用できます。

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

入力

None

出力

IResultObject[]

IResultObject