New-CMTSStepRunCommandLine

참조

모듈:: ConfigurationManager

명령줄 실행 단계를 만들어 작업 순서에 추가할 수 있습니다.

Syntax

New-CMTSStepRunCommandLine
   -CommandLine <String>
   [-DisableWow64Redirection]
   [-PackageId <String>]
   [-RunAsUser]
   [-SuccessCode <Int32[]>]
   [-Timeout <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTSStepRunCommandLine
   -CommandLine <String>
   [-DisableWow64Redirection]
   [-OutputVariableName <String>]
   [-PackageId <String>]
   [-RunAsUser]
   [-SuccessCode <Int32[]>]
   [-Timeout <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTSStepRunCommandLine
   -CommandLine <String>
   [-DisableWow64Redirection]
   [-OutputVariableName <String>]
   [-PackageId <String>]
   [-RunAsUser]
   [-SuccessCode <Int32[]>]
   [-Timeout <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet은 새 Run Command Line 단계 개체를 만듭니다. 그런 다음 Add-CMTaskSequenceStep cmdlet을 사용하여 작업 순서에 단계를 추가합니다. 이 단계에 대한 자세한 내용은 작업 순서 단계: 명령줄 실행을 참조하세요.

참고

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

예제

예 1

이 예제에서는 먼저 명령줄 실행 단계에 대한 개체를 만듭니다. 사용할 명령줄과 패키지를 지정합니다.

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

$step = New-CMTSStepRunCommandLine -Name "Run Command Line" -CommandLine "cmd.exe /c copy Jan98.dat c:\sales\Jan98.dat" -PackageId "XYZ00821"

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

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

매개 변수

-CommandLine

작업 순서가 실행되는 명령줄을 지정합니다. 파일 이름 확장명을 포함합니다(예: .exe ). 필요한 모든 설정 파일 및 명령줄 옵션을 포함합니다.

예: cmd.exe /c copy Jan98.dat c:\sales\Jan98.dat

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Condition

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

Type:	IResultObject[]
Aliases:	Conditions
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

-ContinueOnError

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Disable

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

Type:	SwitchParameter
Aliases:	DisableThisStep
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

-DisableWow64Redirection

기본적으로 64비트 운영 체제는 WOW64 파일 시스템 리디렉션을 사용하여 명령줄을 실행합니다. 이 동작은 32비트 버전의 OS 실행 및 라이브러리를 제대로 찾는 것입니다. WOW64 파일 시스템 리디렉션기 사용을 사용하지 않도록 설정하기 위해 이 매개 변수를 추가합니다. Windows 실행 가능한 네이티브 64비트 버전의 OS 실행 및 라이브러리를 사용하여 명령을 실행합니다. 이 옵션은 32비트 OS에서 실행되는 경우 효과가 없습니다.

Type:	SwitchParameter
Aliases:	DisableRedirectionFor64BitFileSystem
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

-Name

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

Type:	String
Aliases:	StepName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-OutputVariableName

사용자 지정 작업 순서 변수의 이름을 지정합니다. 이 매개 변수를 사용하면 명령 출력의 마지막 1,000자만 변수에 저장됩니다.

Type:	String
Aliases:	Output, OutputVariable
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PackageId

대상 컴퓨터에 아직 없는 파일 또는 프로그램을 명령줄에 지정하는 경우 이 매개 변수를 사용하여 필요한 파일이 있는 패키지의 패키지 ID를 지정합니다. 패키지에는 프로그램이 필요하지 않습니다. 지정한 파일이 대상 컴퓨터에 있는 경우 이 옵션은 필요하지 않습니다.

이 값은 표준 패키지 ID(예: XYZ00821 )입니다.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RunAsUser

명령줄을 로컬 시스템 계정이 아닌 Windows 사용자 계정으로 실행하려면 이 매개 변수를 추가합니다. 그런 다음 UserName 및 UserPassword 매개 변수를 사용합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SuccessCode

단계가 성공으로 평가해야 하는 명령에서 정수 값 배열을 종료 코드로 지정합니다.

Type:	Int32[]
Aliases:	SuccessCodes
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Timeout

Configuration Manager에서 명령줄을 실행할 수 있는 기간을 나타내는 정수 값을 지정합니다. 이 값은 분에서 1 분까지일 수 999 있습니다. 기본값은 15 분입니다.

지정한 명령이 성공적으로 완료될 수 있는 시간이 충분하지 않은 값을 입력하면 이 단계가 실패합니다. 단계 또는 그룹 조건에 따라 전체 작업 순서가 실패할 수 있습니다. 시간 제한이 만료되면 Configuration Manager는 명령줄 프로세스를 종료합니다.

Type:	Int32
Aliases:	TimeoutInMinutes
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UserName

RunAsUser 매개 변수를 사용하는 경우 이 매개 변수를 사용하여 사용자 계정의 Windows 지정합니다. 계정 암호를 지정하려면 UserPassword 매개 변수를 사용합니다.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UserPassword

RunAsUser 매개 변수를 사용하는 경우 이 매개 변수를 사용하여 UserName으로지정한 계정의 암호를 지정합니다.

Type:	SecureString
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

-WorkingDirectory

명령이 시작되는 폴더를 지정합니다. 이 경로는 최대 127자까지 사용할 수 있습니다.

Type:	String
Aliases:	StartIn
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

입력

없음

출력

IResultObject

참고

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

Share via

New-CMTSStepRunCommandLine

Syntax

Description

예제

예 1

매개 변수

-CommandLine

-Condition

-Confirm

-ContinueOnError

-Description

-Disable

-DisableWildcardHandling

-DisableWow64Redirection

-ForceWildcardHandling

-Name

-OutputVariableName

-PackageId

-RunAsUser

-SuccessCode

-Timeout

-UserName

-UserPassword

-WhatIf

-WorkingDirectory

입력

출력

참고

추가 리소스

Share via

New-CMTSStepRunCommandLine

Syntax

Description

예제

예 1

매개 변수

-CommandLine

-Condition

-Confirm

-ContinueOnError

-Description

-Disable

-DisableWildcardHandling

-DisableWow64Redirection

-ForceWildcardHandling

-Name

-OutputVariableName

-PackageId

-RunAsUser

-SuccessCode

-Timeout

-UserName

-UserPassword

-WhatIf

-WorkingDirectory

입력

출력

참고

관련 링크

추가 리소스