New-CMTSRule

참조

모듈:: ConfigurationManager

동적 변수 설정 작업 순서 단계에 추가할 규칙을 만듭니다.

구문

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 주소에 대한 값을 평가합니다.
위치: 기본 네트워크 게이트웨이에 대한 값을 평가합니다.
만들기 및 모델: 컴퓨터의 만들기 및 모델에 대한 값을 평가합니다.
작업 순서 변수: 평가할 작업 순서 변수, 조건 및 값을 추가합니다.

자세한 내용은 동적 규칙 및 변수를 참조하세요.

참고

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

예제

예제 1: Windows PE에 있는 경우 다운로드 대상 설정

이 예제에서는 다음 규칙을 만듭니다.

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

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

-Confirm

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

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

-DefaultGateway

위치 규칙 유형에 대한 기본 게이트웨이를 지정합니다.

예를 들어 이 값을 로 192.168.10.1설정하면 다음 규칙이 추가됩니다. IF Default gateway equals "192.168.10.1" THEN

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-MacAddress

컴퓨터 규칙 유형에 대한 MAC 주소를 지정합니다.

예를 들어 이 값을 로 00:11:22:33:44:55설정하면 다음 규칙이 추가됩니다. IF MAC address equals "00:11:22:33:44:55" THEN

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

-Make

Make for the Make and Model rule type을 지정합니다. 다른 값을 설정하려면 Model 매개 변수를 사용합니다. 두 값이 모두 true이면 규칙이 true로 평가됩니다.

와일드카드 문자를 사용할 수 있습니다.

*: 여러 문자
?: 단일 문자

예를 들어 이 값을 Surface 로 설정하고 Model*을 로 설정하면 다음 규칙이 추가됩니다.IF Make equals "Surface" AND Model equals "*" THEN

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

-Model

만들기 및 모델 규칙 형식에 대한 모델을 지정합니다. 다른 값을 설정하려면 Make 매개 변수를 사용합니다. 두 값이 모두 true이면 규칙이 true로 평가됩니다.

와일드카드 문자를 사용할 수 있습니다.

*: 여러 문자
?: 단일 문자

예를 들어 이 값을 * 로 설정하고 Make 를 Surface로 설정하면 다음 규칙이 추가됩니다. IF Make equals "Surface" AND Model equals "*" THEN

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

-ReferencedVariableName

작업 순서 변수 규칙 형식에 대한 변수를 지정합니다. 또한 ReferencedVariableOperator 및 ReferencedVariableValue 매개 변수를 설정해야 합니다.

이 변수 이름은 기본 제공 작업 순서 변수 또는 사용자가 만든 사용자 지정 변수일 수 있습니다. 자세한 내용은 Configuration Manager에서 작업 순서 변수를 사용하는 방법을 참조하세요.

예를 들어 다음 값을 설정하면 다음과 같습니다.

ReferencedVariableName: OSDRegisteredOrgName
ReferencedVariableOperator: Equals
ReferencedVariableValue: Contoso

그런 다음, 다음 규칙을 추가합니다. IF OSDRegisteredOrgName equals "Contoso" THEN

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

-ReferencedVariableOperator

작업 순서 변수 규칙 형식에 대한 조건을 지정합니다. ReferencedVariableName 및 ReferencedVariableValue 매개 변수도 설정해야 합니다. 사용 가능한 연산자는 이 매개 변수에 허용되는 값 목록을 참조하세요.

예를 들어 다음 값을 설정하면 다음과 같습니다.

ReferencedVariableName: OSDRegisteredOrgName
ReferencedVariableOperator: Equals
ReferencedVariableValue: Contoso

그런 다음, 다음 규칙을 추가합니다. IF OSDRegisteredOrgName equals "Contoso" THEN

형식:	VariableOperatorType
허용되는 값:	Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ReferencedVariableValue

작업 순서 변수 규칙 형식의 값을 지정합니다. ReferencedVariableName 및 ReferencedVariableOperator 매개 변수도 설정해야 합니다.

예를 들어 다음 값을 설정하면 다음과 같습니다.

ReferencedVariableName: OSDRegisteredOrgName
ReferencedVariableOperator: Equals
ReferencedVariableValue: Contoso

그런 다음, 다음 규칙을 추가합니다. IF OSDRegisteredOrgName equals "Contoso" THEN

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

-SerialNumber

컴퓨터 규칙 형식의 일련 번호를 지정합니다.

예를 들어 이 값을 로 123456설정하면 다음 규칙이 추가됩니다. IF Asset tag equals "123456" THEN

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

-Uuid

컴퓨터 규칙 유형에 대한 UUID를 지정합니다.

예를 들어 이 값을 로 de5ba380-f692-45e0-bbd3-0e40543b549e설정하면 다음 규칙이 추가됩니다. IF UUID equals "de5ba380-f692-45e0-bbd3-0e40543b549e" THEN

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

-Variable

규칙이 true로 평가될 때 단계에서 설정해야 하는 기존 또는 사용자 지정 작업 순서 변수 및 관련 값을 지정합니다.

예를 들어 이 값을 @{'OSDDownloadDestinationLocationType' = 'TSCache'}로 설정하면 규칙의 다음에 다음 변수가 THEN 추가됩니다. SET OSDDownloadDestinationLocationType = "TSCache"

동일한 해시 테이블의 변수를 둘 이상 지정하려면 세미콜론(;) 구분 기호를 사용합니다. 예: @{'OSDRegisteredUserName' = 'Contoso';'OSDRegisteredOrgName' = 'Contoso'}

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

-WhatIf

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

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

입력

None

출력

IResultObject

다음을 통해 공유

New-CMTSRule

구문

Description

예제

예제 1: Windows PE에 있는 경우 다운로드 대상 설정

매개 변수

-AssetTag

-Confirm

-DefaultGateway

-DisableWildcardHandling

-ForceWildcardHandling

-MacAddress

-Make

-Model

-ReferencedVariableName

-ReferencedVariableOperator

-ReferencedVariableValue

-SerialNumber

-Uuid

-Variable

-WhatIf

입력

출력

피드백

추가 리소스

다음을 통해 공유

New-CMTSRule

구문

Description

예제

예제 1: Windows PE에 있는 경우 다운로드 대상 설정

매개 변수

-AssetTag

-Confirm

-DefaultGateway

-DisableWildcardHandling

-ForceWildcardHandling

-MacAddress

-Make

-Model

-ReferencedVariableName

-ReferencedVariableOperator

-ReferencedVariableValue

-SerialNumber

-Uuid

-Variable

-WhatIf

입력

출력

관련 링크

피드백

추가 리소스