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 쿼리는 제공하는 조건에 따라 사이트 데이터베이스에서 정보를 얻을 수 있는 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"및 서버 클라이언트 컬렉션의 경우 - 컬렉션 프롬프트: 이 매개 변수의 값을 로
"<Prompt>"설정
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
구성할 쿼리의 이름을 지정합니다.
| 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 |
입력
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
출력
System.Object