New-CMTSRule
동적 변수 설정 작업 순서 단계에 추가할 규칙을 생성합니다.
Syntax
New-CMTSRule
-Variable <Hashtable>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTSRule
[-AssetTag <String>]
[-MacAddress <String>]
[-SerialNumber <String>]
[-Uuid <String>]
-Variable <Hashtable>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTSRule
[-DefaultGateway <String>]
-Variable <Hashtable>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTSRule
[-Make <String>]
[-Model <String>]
-Variable <Hashtable>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTSRule
[-ReferencedVariableName <String>]
[-ReferencedVariableOperator <VariableOperatorType>]
[-ReferencedVariableValue <String>]
-Variable <Hashtable>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
이 cmdlet을 사용하여 동적 변수 설정 작업 순서 단계에 추가하는 규칙 개체를 만들 수 있습니다. 규칙을 추가하기 위해 New-CMTSStepSetDynamicVariable 또는 Set-CMTSStepSetDynamicVariable cmdlet을 사용 합니다. 작업 순서가 이 단계를 실행하면 동적 규칙 및 변수가 순서대로 평가됩니다. 특정 디바이스에서 규칙을 평가하면 해당 규칙에 따라 작업 순서 변수를 설정할 수 있습니다.
규칙에는 네 가지 유형이 있습니다.
- 컴퓨터: 하드웨어 자산 태그, UUID, 일련 번호 또는 MAC 주소의 값을 평가합니다.
- 위치: 기본 네트워크 게이트웨이의 값을 평가합니다.
- Make and Model: 컴퓨터의 만들기 및 모델에 대한 값을 평가합니다.
- 작업 순서 변수: 평가할 작업 순서 변수, 조건 및 값을 추가합니다.
자세한 내용은 동적 규칙 및 변수 를 참조하세요.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>
). 자세한 내용은 시작을 참조하세요.
예제
예제 1: PE에 있는 경우 다운로드 Windows 설정
이 예에서는 다음 규칙을 만듭니다.
IF _SMSTSInWinPE equals "TRUE" THEN SET OSDDownloadDestinationLocationType = "TSCache"
그런 다음 작업 순서에서 이 단계의 기존 인스턴스에 이 규칙을 추가합니다.
$tsrule = New-CMTSRule -Variable @{'OSDDownloadDestinationLocationType' = 'TSCache'} -ReferencedVariableName "_SMSTSInWinPE" -ReferencedVariableOperator equals -ReferencedVariableValue TRUE
$tsname = "Default IPU"
$tsstep = "Set Dynamic Variables"
Set-CMTSStepSetDynamicVariable -TaskSequenceName $tsname -StepName $tsstep -AddRule $tsrule
매개 변수
-AssetTag
컴퓨터 규칙 유형에 대한 자산 태그를 지정합니다. 최대값은 255자입니다.
예를 들어 이 값을 으로 123456
설정하면 다음 규칙이 추가됩니다. IF Asset tag equals "123456" THEN
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 |
-DefaultGateway
위치 규칙 유형에 대한 기본 게이트웨이를 지정합니다.
예를 들어 이 값을 으로 192.168.10.1
설정하면 다음 규칙이 추가됩니다. IF Default gateway equals "192.168.10.1" THEN
Type: | String |
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 |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하며 예기치 않은 동작이 발생할 수 있습니다(권장하지 않음). DisableWildcardHandling과결합할 수 없습니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MacAddress
컴퓨터 규칙 유형에 대한 MAC 주소를 지정합니다.
예를 들어 이 값을 으로 00:11:22:33:44:55
설정하면 다음 규칙이 추가됩니다. IF MAC address equals "00:11:22:33:44:55" THEN
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Make
Make 및 Model 규칙 유형에 대해 Make를 지정합니다. 다른 값을 설정하기 위해 Model 매개 변수를 사용합니다. 두 값이 모두 true이면 규칙에서 true를 평가합니다.
와일드카드 문자를 사용할 수 있습니다.
*
: 여러 문자?
: 단일 문자
예를 들어 이 값을 으로 설정하고 Surface
Model을 으로 설정하면 *
다음 규칙이 추가됩니다. IF Make equals "Surface" AND Model equals "*" THEN
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Model
만들기 및 모델 규칙 유형에 대한 모델을 지정합니다. 다른 값을 설정하기 위해 Make 매개 변수를 사용합니다. 두 값이 모두 true이면 규칙에서 true를 평가합니다.
와일드카드 문자를 사용할 수 있습니다.
*
: 여러 문자?
: 단일 문자
예를 들어 이 값을 으로 설정하고 *
Make to 를 으로 설정하면 다음 Surface
규칙이 추가됩니다. IF Make equals "Surface" AND Model equals "*" THEN
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReferencedVariableName
작업 순서 변수 규칙 유형에 변수를 지정합니다. ReferencedVariableOperator 및 ReferencedVariableValue 매개 변수도 설정해야 합니다.
이 변수 이름은 기본 제공 작업 순서 변수 또는 만든 사용자 지정 변수일 수 있습니다. 자세한 내용은 Configuration Manager에서 작업 순서 변수를 사용하는 방법을 참조하세요.
예를 들어 다음 값을 설정하는 경우
- ReferencedVariableName:
OSDRegisteredOrgName
- ReferencedVariableOperator:
Equals
- ReferencedVariableValue:
Contoso
그런 다음 다음 규칙을 추가합니다. IF OSDRegisteredOrgName equals "Contoso" THEN
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReferencedVariableOperator
작업 순서 변수 규칙 유형에 대한 조건을 지정합니다. ReferencedVariableName 및 ReferencedVariableValue 매개 변수도 설정해야 합니다. 사용 가능한 연산자는 이 매개 변수에 대한 허용 값 목록을 참조하세요.
예를 들어 다음 값을 설정하는 경우
- ReferencedVariableName:
OSDRegisteredOrgName
- ReferencedVariableOperator:
Equals
- ReferencedVariableValue:
Contoso
그런 다음 다음 규칙을 추가합니다. IF OSDRegisteredOrgName equals "Contoso" THEN
Type: | VariableOperatorType |
Accepted values: | Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReferencedVariableValue
작업 순서 변수 규칙 유형에 대한 값을 지정합니다. ReferencedVariableName 및 ReferencedVariableOperator 매개 변수도 설정해야 합니다.
예를 들어 다음 값을 설정하는 경우
- ReferencedVariableName:
OSDRegisteredOrgName
- ReferencedVariableOperator:
Equals
- ReferencedVariableValue:
Contoso
그런 다음 다음 규칙을 추가합니다. IF OSDRegisteredOrgName equals "Contoso" THEN
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SerialNumber
컴퓨터 규칙 유형에 일련 번호를 지정합니다.
예를 들어 이 값을 으로 123456
설정하면 다음 규칙이 추가됩니다. IF Asset tag equals "123456" THEN
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Uuid
컴퓨터 규칙 유형에 대해 UUID를 지정합니다.
예를 들어 이 값을 으로 de5ba380-f692-45e0-bbd3-0e40543b549e
설정하면 다음 규칙이 추가됩니다. IF UUID equals "de5ba380-f692-45e0-bbd3-0e40543b549e" THEN
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Variable
규칙이 true로 평가될 때 단계에서 설정해야 하는 기존 또는 사용자 지정 작업 순서 변수 및 관련 값을 지정합니다.
예를 들어 이 값을 으로 설정하면 규칙의 다음 변수가 @{'OSDDownloadDestinationLocationType' = 'TSCache'}
THEN
추가됩니다. SET OSDDownloadDestinationLocationType = "TSCache"
동일한 해시표에 두 개 이상의 변수를 지정하기 위해 세미 콜론( ;
) 디지타이터를 사용 합니다. 예: @{'OSDRegisteredUserName' = 'Contoso';'OSDRegisteredOrgName' = 'Contoso'}
Type: | Hashtable |
Aliases: | Variables |
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 |
입력
없음
출력
IResultObject