Share via

Invoke-CMQuery

  • 참조
모듈:
ConfigurationManager

Configuration Manager 쿼리를 실행합니다.

Syntax

Invoke-CMQuery
      -InputObject <IResultObject>
      [-LimitToCollectionId <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMQuery
      -Id <String>
      [-LimitToCollectionId <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMQuery
      [-LimitToCollectionId <String>]
      -Name <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

이 cmdlet을 사용하여 Configuration Manager 사이트에서 쿼리를 실행합니다. Configuration Manager 쿼리는 제공한 조건에 따라 사이트 데이터베이스에서 정보를 가져오는 WQL(WMI 쿼리 언어) 식을 정의합니다. WQL은 SQL과 비슷하지만 데이터베이스에 직접 연결하지 않고 SMS 공급자를 계속 통과합니다. 따라서 WQL은 여전히 역할 기반 액세스 구성을 준수합니다.

쿼리를 실행하면 사이트에서 WQL 식을 처리하고 PowerShell에서 결과를 반환합니다. WQL 문의 구조에 따라 결과의 형식이 다를 수 있습니다.

쿼리는 컴퓨터, 사이트, 컬렉션, 애플리케이션 및 인벤토리 데이터를 포함하는 대부분의 유형의 Configuration Manager 개체를 반환할 수 있습니다. 자세한 내용은 Configuration Manager 쿼리 소개를 참조하세요.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 기본 쿼리 보기 및 실행

이 예제에서는 먼저 기본 쿼리인 이 사이트 및 하위 사이트의 속성을 표시하는 Get-CMQuery cmdlet을 보여 줍니다.

그런 다음 Invoke-CMQuery cmdlet을 표시하여 동일한 쿼리를 실행하고 결과를 표시합니다.

PS XYZ:\> Get-CMQuery -Id "SMS012"

SmsProviderObjectPath          : SMS_Query.QueryID="SMS012"
Comments                       : This site and all its subsites in the ConfigMgr hierarchy
Expression                     : SELECT SiteCode, SiteName, Version, ServerName FROM sms_siteandsubsites
LimitToCollectionID            :
LocalizedCategoryInstanceNames : {}
Name                           : This Site and its Subsites
QueryID                        : SMS012
ResultAliasNames               : {sms_siteandsubsites, sms_siteandsubsites, sms_siteandsubsites, sms_siteandsubsites}
ResultColumnsNames             : {sms_siteandsubsites.SiteCode, sms_siteandsubsites.SiteName,
                                 sms_siteandsubsites.Version, sms_siteandsubsites.ServerName}
TargetClassName                : sms_siteandsubsites

PS XYZ:\> Invoke-CMQuery -Id "SMS012"

SmsProviderObjectPath : SMS_SiteAndSubsites.SiteCode="XYZ"
ServerName            : cmserver.contoso.com
SiteCode              : XYZ
SiteName              : Production primary site
Version               : 5.00.9043.1000

Get-CMQuery cmdlet의 출력에서 WQL 식이 단순하다는 것을 알 수 있습니다. 단일 클래스에서 네 개의 특성을 선택합니다.

그런 다음 Invoke-CMQuery cmdlet의 출력이 간단한 테이블인 방법을 확인합니다.

예제 2: 복잡한 쿼리 보기 및 실행

이 예제에서는 먼저 Get-CMQuery cmdlet을 보여 줘서 사용자 지정 쿼리의 속성을 표시합니다.

그런 다음 Invoke-CMQuery cmdlet을 표시하여 동일한 쿼리를 실행하고 결과를 표시합니다.

PS XYZ:\> Get-CMQuery -Id "XYZ00002"

SmsProviderObjectPath          : SMS_Query.QueryID="XYZ00002"
Comments                       :
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%"
LimitToCollectionID            : XYZ0025F
LocalizedCategoryInstanceNames : {}
Name                           : Server 2016
QueryID                        : XYZ00002
ResultAliasNames               : {SMS_R_System, SMS_R_System, SMS_G_System_OPERATING_SYSTEM}
ResultColumnsNames             : {SMS_R_System.Name, SMS_R_System.LastLogonUserName,
                                 SMS_G_System_OPERATING_SYSTEM.Caption}
TargetClassName                : SMS_R_System

PS XYZ:\> Invoke-CMQuery -Id "XYZ00002"


SmsProviderObjectPath         : __GENERIC
SMS_G_System_OPERATING_SYSTEM :
                                instance of SMS_G_System_OPERATING_SYSTEM
                                {
                                        Caption = "Microsoft Windows Server 2012 R2 Datacenter";
                                };

SMS_R_System                  :
                                instance of SMS_R_System
                                {
                                        LastLogonUserName = "jqpublic";
                                        Name = "millcreek01";
                                };

이 쿼리에는 두 클래스를 조인하는 더 복잡한 식 이 있습니다. 그러면 쿼리 결과가 더 복잡해집니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

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

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

실행할 쿼리의 ID를 지정합니다. 예를 들면 "XYZ00006"와 같습니다.

Type:String
Aliases:QueryId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

실행할 쿼리 개체를 지정합니다. 이 개체를 얻으려면 Get-CMQuery cmdlet을 사용합니다.

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

-LimitToCollectionId

제한 컬렉션을 묻는 메시지를 표시하도록 쿼리가 구성된 경우 이 매개 변수를 사용하여 컬렉션 ID를 지정합니다. 쿼리의 LimitToCollectionID 속성이 이 <Prompt>고 쿼리를 실행할 때 이 매개 변수를 포함하지 않으면 cmdlet이 실패합니다.

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

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

System.Object