다음을 통해 공유


New-CMTSStepSetVariable

작업 순서에 추가할 수 있는 작업 순서 변수 설정 단계를 만듭니다.

구문

New-CMTSStepSetVariable
   [-IsMasked <Boolean>]
   -TaskSequenceVariable <String>
   [-TaskSequenceVariableValue <String>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet은 새 Set Task Sequence Variable 단계 개체를 만듭니다. 그런 다음 Add-CMTaskSequenceStep cmdlet을 사용하여 단계를 작업 순서에 추가합니다. 이 단계에 대한 자세한 내용은 작업 순서 단계 정보: 작업 순서 변수 설정을 참조하세요.

참고

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

예제

예 1

이 예제에서는 먼저 작업 순서 변수 설정 단계에 대한 개체를 만들어 OSDSetupAdditionalUpgradeOptions 기본 제공 변수를 /ReflectDrivers로 설정합니다.

그런 다음 작업 순서 개체를 가져오고 인덱스 11의 작업 순서에 이 새 단계를 추가합니다.

$step = New-CMTSStepSetVariable -Name "Set Task Sequence Variable" -TaskSequenceVariable "OSDSetupAdditionalUpgradeOptions" -TaskSequenceVariableValue "/ReflectDrivers"

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11

매개 변수

-Condition

이 단계에서 사용할 조건 개체를 지정합니다. 이 개체를 얻으려면 작업 순서 조건 cmdlet 중 하나를 사용합니다. 예를 들어 Get-CMTSStepConditionVariable입니다.

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

-Confirm

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

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

-ContinueOnError

이 매개 변수를 추가하여 오류 발생시 단계 옵션 계속을 사용하도록 설정합니다. 이 옵션을 사용하도록 설정하면 단계가 실패하면 작업 순서가 계속됩니다.

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

-Description

이 작업 순서 단계에 대한 선택적 설명을 지정합니다.

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

-Disable

이 매개 변수를 추가하여 이 작업 순서 단계를 사용하지 않도록 설정합니다.

형식:SwitchParameter
별칭:DisableThisStep
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

-IsMasked

작업 순서 변수에 $true 저장된 중요한 데이터를 마스킹하려면 이 매개 변수를 로 설정합니다. 예를 들어 암호를 지정할 때입니다.

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

-Name

이 단계의 이름을 지정하여 작업 순서에서 식별합니다.

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

-TaskSequenceVariable

작업 순서 기본 제공 또는 작업 변수의 이름을 지정하거나 사용자 정의 변수 이름을 지정합니다. 자세한 내용은 Configuration Manager에서 작업 순서 변수를 사용하는 방법작업 순서 변수 참조를 참조하세요.

TaskSequenceVariableValue 매개 변수를 사용하여 값을 설정합니다.

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

-TaskSequenceVariableValue

작업 순서는 TaskSequenceVariable 을 이 값으로 설정합니다. 이 작업 순서 변수를 구문을 %varname%사용하여 다른 작업 순서 변수의 값으로 설정합니다.

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

-WhatIf

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

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

입력

None

출력

IResultObject

참고

이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_TaskSequence_SetVariableAction 서버 WMI 클래스를 참조하세요.