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

说明

使用此 cmdlet 在 Configuration Manager 中配置查询。 Configuration Manager 查询使用 WQL (定义 WMI) 语言，以便根据提供的条件从网站数据库中获取信息。 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

指定可选注释以进一步标识网站中的查询。

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

-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 cmdlet。

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

-LimitToCollectionId

指定如何为此查询配置集合限制：

• 不限制集合：将此参数的值设置为空字符串 "" () 。 请勿使用 $null 内置变量。
• 集合限制：指定集合的 ID。 例如， "SMSDM003" 对于 All 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	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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

相关链接

• Export-CMQuery
• Get-CMQuery
• Import-CMQuery
• Invoke-CMQuery
• New-CMQuery
• Remove-CMQuery
• Configuration Manager 中的查询简介