Set-CMQuery
Configuration Manager クエリを構成します。
構文
Set-CMQuery
[-Comment <String>]
[-Expression <String>]
-InputObject <IResultObject>
[-LimitToCollectionId <String>]
[-NewName <String>]
[-PassThru]
[-TargetClassName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMQuery
[-Comment <String>]
[-Expression <String>]
-Id <String>
[-LimitToCollectionId <String>]
[-NewName <String>]
[-PassThru]
[-TargetClassName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMQuery
[-Comment <String>]
[-Expression <String>]
[-LimitToCollectionId <String>]
-Name <String>
[-NewName <String>]
[-PassThru]
[-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:\>
。 詳細については 、「Getting started」を参照してください。
例
例 1: クエリの名前を変更する
Get-CMQuery -Name "My systems" | Set-CMQuery -NewName "My systems v2"
例 2: 制限コレクションの入力を求めるクエリを変更する
Set-CMQuery -Name "Windows 10" -LimitToCollectionId "<Prompt>"
パラメーター
-Comment
オプションのコメントを指定して、サイト内のクエリをさらに識別します。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Expression
結果に表示する属性と結果を制限する条件を定義する WQL ステートメントを指定します。
WQL ステートメントには、多くの場合、二重引用符 ( ) が含まれるので、このパラメーターの値を単一引用符 ( ) で囲まれた文字列 "
として設定します '
。
その他の例については、「 サンプル WQL クエリ」を参照してください。
Type: | String |
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 |
Aliases: | QueryId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
構成するクエリ オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMQuery コマンドレットを使用 します。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LimitToCollectionId
このクエリのコレクション制限を構成する方法を指定します。
- コレクションに限定されない: このパラメーターの値を空白の文字列 ( ) に設定
""
します。 組み込みの$null
変数を使用しない。 - コレクションの制限: コレクションの ID を指定します。 たとえば、[すべての
"SMSDM003"
デスクトップと サーバー クライアント ] コレクションの場合です。 - コレクションのプロンプト: このパラメーターの値をに設定します
"<Prompt>"
。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
構成するクエリの名前を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
クエリの名前を変更する新しい名前を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
このパラメーターを追加して、作業しているアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object