Set-CMQuery
設定 Configuration Manager 查詢。
Syntax
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>]Description
使用此 Cmdlet 在 Configuration Manager 中設定查詢。 Configuration Manager 查詢會定義 WMI 查詢語言 (WQL) 運算式，以根據您所提供的準則，從網站資料庫取得資訊。 WQL 與 SQL 類似，但仍然會透過 SMS 提供者，而不是直接傳送至資料庫。 因此，WQL 仍然 abides 您的角色型訪問設定。
查詢可以傳回大多數類型的 Configuration Manager 物件，包括電腦、網站、集合、應用程式及庫存資料。 如需詳細資訊，請參閱 Configuration Manager 中的查詢簡介。
根據預設，Configuration Manager 包含數個查詢。 您可以使用 CMQuery Cmdlet 來複查預設查詢。 如需 WQL 運算式的更多範例，請參閱 範例 WQL 查詢。
注意
從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。 如需詳細資訊，請參閱 快速入門。
範例
範例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
執行 Cmdlet 之前提示您確認。
| 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 |
-ForceWildcardHandling
這個參數會處理萬用字元，而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
指定要設定的查詢物件。 若要取得此物件，請使用 CMQuery Cmdlet。
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-LimitToCollectionId
指定此查詢的集合限制設定方式：
- 不限於集合：請將此參數的值設為空白字串 (
"") 。 請勿使用$null內建變數。 - 限集合：指定集合的識別碼。 例如，
"SMSDM003"適用于 所有的 Desktop 和 Server Clients 集合。 - 提示進行收集：請將此參數的值設為
"<Prompt>"。
| 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
新增此參數可傳回代表您正在使用之專案的物件。 根據預設，此 Cmdlet 可能不會產生任何輸出。
| 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 |
使用者資源 |
SMS_SiteAndSubsites |
網站與子網站 |
SMS_R_UnknownSystem |
未知電腦 |
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-名稱
指定要設定之查詢的名稱。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-識別碼
指定要設定之查詢的識別碼。 例如，"XYZ00006"。
| Type: | String |
| Aliases: | QueryId |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-運算式
指定 WQL 語句，以定義要在結果中顯示的屬性，以及限制結果的準則。
WQL 語句通常會 " 在) 中包含雙引號 (，因此請將此參數的值設為以單引號括住的字串 (') 。
如需更多範例，請參閱 範例 WQL 查詢。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
ConfigurationManagement IResultObject
輸出
系統.物件