Add-CMDeviceCollectionQueryMembershipRule
장치 컬렉션에 쿼리 멤버 자격 규칙을 추가합니다.
Syntax
Add-CMDeviceCollectionQueryMembershipRule
-CollectionId <String>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMDeviceCollectionQueryMembershipRule
-CollectionName <String>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMDeviceCollectionQueryMembershipRule
-InputObject <IResultObject>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
이 cmdlet을 사용하여 장치 컬렉션에 쿼리 멤버 자격 규칙을 추가합니다.
쿼리 규칙을 사용하면 일정에 따라 실행되는 쿼리에 따라 컬렉션의 구성원 자격을 동적으로 업데이트할 수 있습니다.
기본 컬렉션에는 구성원 규칙을 추가할 수 없습니다. 대상 컬렉션에는 사이트 코드로 시작하는 ID가 와야 SMS 합니다.
자세한 내용은 Configuration Manager에서 컬렉션을 만드는 방법을 참조하세요.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\> ). 자세한 내용은 시작을 참조하세요.
예제
예제 1: 쿼리 멤버 자격 규칙 추가
이 예제에서는 먼저 WQL(WMI Query Language) 문을 wql 변수에 저장합니다. 다음 명령은 이름이 tPM인 멤버 자격 규칙을 Windows 10 장치 컬렉션에 추가합니다. QueryExpression 매개 변수는 wql 변수를 사용하며 멤버 자격 규칙을 정의하는 쿼리를 지정합니다.
$wql = "select SMS_R_System.ResourceId, SMS_R_System.ResourceType, SMS_R_System.Name, SMS_R_System.SMSUniqueIdentifier, SMS_R_System.ResourceDomainORWorkgroup, SMS_R_System.Client from SMS_R_System inner join SMS_G_System_TPM on SMS_G_System_TPM.ResourceID = SMS_R_System.ResourceId"
Add-CMDeviceCollectionQueryMembershipRule -CollectionName "Windows 10 devices" -QueryExpression $wql -RuleName "TPM"매개 변수
-CollectionId
규칙을 추가할 장치 컬렉션의 ID를 지정합니다. 이 값은 CollectionID 속성(예: XYZ00012 )입니다. 기본 모음에는 구성원 자격 규칙을 추가할 수 없습니다. 이 ID는 사이트 코드가 아닌 사이트 코드로 SMS 시작됩니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionName
규칙을 추가할 장치 컬렉션의 이름을 지정합니다.
| 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: | False |
| 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 |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하며 예기치 않은 동작이 발생할 수 있습니다(권장하지 않음). DisableWildcardHandling과결합할 수 없습니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
규칙을 추가할 장치 컬렉션에 대한 개체를 지정합니다. 이 개체를 얻거나 Get-CMCollection 또는 Get-CMDeviceCollection cmdlet을 사용합니다.
| Type: | IResultObject |
| Aliases: | Collection |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PassThru
이 매개 변수를 추가하여 작업할 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않을 수 있습니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-QueryExpression
사이트에서 장치 컬렉션을 업데이트하는 데 사용하는 WQL(WMI 쿼리 언어) 식을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RuleName
컬렉션에 추가할 쿼리 규칙의 이름을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ValidateQueryHasResult
규칙을 추가하기 전에 이 매개 변수를 추가하여 쿼리 식을 테스트합니다. 이 매개 변수를 사용하여 cmdlet을 실행하면 쿼리 식에 결과가 없는 경우 cmdlet은 다음 오류 메시지를 반환합니다. 이 경우 쿼리는 컬렉션에 No object corresponds to the specified parameters. 추가되지 않습니다.
쿼리에서 현재 결과를 반환하지 않지만 규칙을 추가하려는 경우 이 매개 변수를 사용하지 않습니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여줍니다. 이 cmdlet은 실행되지 않습니다.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
입력
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
출력
System.Object