Get-CMQuery

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 にはいくつかのクエリが含まれています。 このコマンドレットを使用して、既定のクエリを確認できます。

注意

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

例 1

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

Get-CMQuery -Name "*ConfigMgr clients *"

パラメーター

-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

-Id

取得するクエリの ID を指定します。 たとえば、"XYZ00006" などです。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

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

  • *: 複数の文字
  • ?: 1 文字
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

入力

なし

出力

IResultObject[]

IResultObject