New-CMQuery
Configuration Manager クエリを作成します。
構文
New-CMQuery
[-Comment <String>]
-Expression <String>
[-LimitToCollectionId <String>]
-Name <String>
[-TargetClassName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]説明
このコマンドレットを使用して、Configuration Managerでクエリを作成します。
Configuration Managerクエリでは、指定した条件に基づいてサイト データベースから情報を取得する WMI クエリ言語 (WQL) 式を定義します。 WQL は SQL に似ていますが、引き続きデータベースに直接ではなく SMS プロバイダーを経由します。 そのため、WQL は引き続きロールベースのアクセス構成に従います。
クエリは、コンピューター、サイト、コレクション、アプリケーション、インベントリ データなど、ほとんどの種類のConfiguration Manager オブジェクトを返すことができます。 詳細については、「Configuration Managerでのクエリの概要」を参照してください。
既定では、Configuration Managerには複数のクエリが含まれています。 Get-CMQuery コマンドレットを使用して、既定のクエリを確認できます。 WQL 式のその他の例については、「 WQL クエリの例」を参照してください。
注:
Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>)。 詳細については、「作業の 開始」を参照してください。
例
例 1: 特定のバージョンのサーバーに対する新しいクエリを作成する
この例では、Microsoft Windows Server 2012 で始まる OS キャプションを持つクライアントを検索する Server 2016 という名前の新しいクエリを作成します。 Name、Last logon ユーザー名、OS キャプションの 3 つのプロパティが返されます。
New-CMQuery -Name "Server 2016" -Expression 'select SMS_R_System.Name, SMS_R_System.LastLogonUserName, SMS_G_System_OPERATING_SYSTEM.Caption from SMS_R_System inner join SMS_G_System_OPERATING_SYSTEM on SMS_G_System_OPERATING_SYSTEM.ResourceID = SMS_R_System.ResourceId where SMS_G_System_OPERATING_SYSTEM.Caption like "Microsoft Windows Server 2012%"' -TargetClassName "SMS_R_System" -LimitToCollectionId "SMS00001"例 2: デスクトップ デバイスのクエリを作成する
次の使用例は、System Enclosure クラスのシャーシの種類プロパティの特定の値を持つデバイスを検索する Desktop devices という名前の新しいクエリを作成します。 複数のプロパティが返され、特定のコレクションによって制限されます。
New-CMQuery -Name "Desktop devices" -Expression '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_SYSTEM_ENCLOSURE on SMS_G_System_SYSTEM_ENCLOSURE.ResourceID = SMS_R_System.ResourceId where SMS_G_System_SYSTEM_ENCLOSURE.ChassisTypes in ( "3", "4", "5","6", "7", "15","16")' -TargetClassName "SMS_R_System" -LimitToCollectionId "XYZ000049"パラメーター
-Comment
オプションのコメントを指定して、サイト内のクエリをさらに識別します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Expression
結果に表示する属性と、結果を制限する条件を定義する WQL ステートメントを指定します。
WQL ステートメントには二重引用符 (") が含まれることがよくあります。そのため、このパラメーターの値を単一引用符' () で囲まれた文字列として設定します。
その他の例については、「 WQL クエリの例」を参照してください。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LimitToCollectionId
このクエリのコレクション制限を構成する方法を指定します。
- コレクションに制限されない: このパラメーターの値を空の文字列 (
"") に設定します。 組み込み変数は$null使用しないでください。 - コレクションへの制限: コレクションの ID を指定します。 たとえば、
"SMSDM003"すべてのデスクトップクライアントとサーバークライアント コレクションの場合です。 - 収集のプロンプト: このパラメーターの値を に
"<Prompt>"設定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
クエリの名前を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetClassName
クエリで返すオブジェクト クラスの名前を指定します。 使用可能なオブジェクトの種類は多数あります。 次の表に、Configuration Manager コンソールの説明を含む一般的なクラス名をいくつか示します。
| クラス名 | 説明 |
|---|---|
SMS_R_System |
システム リソース |
SMS_Program |
プログラム |
SMS_R_UserGroup |
ユーザー グループ リソース |
SMS_R_User |
User リソース |
SMS_SiteAndSubsites |
サイトとサブサイト |
SMS_R_UnknownSystem |
不明なコンピューター |
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
None
出力
IResultObject
関連リンク
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示