共用方式為

Set-CMQuery

  • 參考
模組:
ConfigurationManager

設定 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>]

Description

使用此 Cmdlet 在 Configuration Manager 中設定查詢。 Configuration Manager 查詢會定義 WMI 查詢語言 (WQL) 表示式，以根據您提供的準則從月台資料庫取得資訊。 WQL 類似於 SQL，但仍會通過 SMS 提供者，而不是直接進入資料庫。 因此，WQL 仍然遵守您的角色型存取設定。

查詢可以傳回大部分類型的 Configuration Manager 物件，包括計算機、月臺、集合、應用程式和清查數據。 如需詳細資訊， 請參閱 Configuration Manager 中的查詢簡介。

根據預設，Configuration Manager 包含數個查詢。 您可以使用 Get-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

指定選擇性批注，以進一步識別網站中的查詢。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Confirm

執行 Cmdlet 之前提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Expression

指定 WQL 語句，定義要在結果中顯示的屬性，以及限制結果的準則。

WQL 語句通常會在) (" 包含雙引號，因此請將此參數的值設定為以單引號括住的字串， (') 。

如需更多範例，請 參閱範例 WQL 查詢。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ForceWildcardHandling

此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Id

指定要設定之查詢的識別碼。 例如，"XYZ00006"。

類型:String
別名:QueryId
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-InputObject

指定要設定的查詢物件。 若要取得此物件，請使用 Get-CMQuery Cmdlet。

類型:IResultObject
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-LimitToCollectionId

指定如何設定此查詢的集合限制：

  • 不限集合：將此參數的值設定為空白字串 ("") 。 請勿使用 $null 內建變數。
  • 集合限制：指定集合的標識碼。 例如， "SMSDM003" 針對 [所有桌面] 和 [伺服器用戶端] 集合。
  • 提示收集：將此參數的值設定為 "<Prompt>"。
類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Name

指定要設定的查詢名稱。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-NewName

指定要重新命名查詢的新名稱。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-PassThru

新增此參數以傳回 物件，代表您正在使用的專案。 根據預設，此 Cmdlet 可能不會產生任何輸出。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-TargetClassName

指定您要查詢傳回的物件類別名稱。 有許多可用的物件類型。 下表列出數個通用類別名稱，以及 Configuration Manager 控制台的描述：

類別名稱 描述
SMS_R_System 系統資源
SMS_Program 程式
SMS_R_UserGroup 使用者群組資源
SMS_R_User 用戶資源
SMS_SiteAndSubsites 網站和子網站
SMS_R_UnknownSystem 未知的電腦
類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object