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 쿼리는 제공한 조건에 따라 사이트 데이터베이스에서 정보를 가져오는 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

선택적 주석을 지정하여 사이트에서 쿼리를 추가로 식별합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

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

형식:SwitchParameter
별칭:cf
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Expression

결과에 표시할 특성과 결과를 제한하는 조건을 정의하는 WQL 문을 지정합니다.

WQL 문에는 큰따옴표(")가 포함된 경우가 많으므로 이 매개 변수의 값을 작은따옴표(')로 묶은 문자열로 설정합니다.

자세한 예제는 예제 WQL 쿼리를 참조하세요.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ForceWildcardHandling

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Id

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

형식:String
별칭:QueryId
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

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

형식:IResultObject
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-LimitToCollectionId

이 쿼리에 대한 컬렉션 제한을 구성하는 방법을 지정합니다.

  • 컬렉션이 제한되지 않음: 이 매개 변수의 값을 빈 문자열("")로 설정합니다. 기본 제공 변수를 $null 사용하지 마세요.
  • 컬렉션 제한: 컬렉션의 ID를 지정합니다. 예를 들어 "SMSDM003"모든 데스크톱 및 서버 클라이언트 컬렉션의 경우입니다 .
  • 컬렉션 프롬프트: 이 매개 변수의 값을 로 "<Prompt>"설정합니다.
형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Name

구성할 쿼리의 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NewName

쿼리 이름을 바꿀 새 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PassThru

작업 중인 항목을 나타내는 개체를 반환하려면 이 매개 변수를 추가합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않을 수 있습니다.

형식:SwitchParameter
Position:Named
Default value: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
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

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

형식:SwitchParameter
별칭:wi
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

System.Object