New-CMTSStepInstallSoftware
작업 순서에 추가할 수 있는 패키지 설치 단계를 만들 수 있습니다.
Syntax
New-CMTSStepInstallSoftware
[-BaseVariableName <String>]
[-ContinueOnInstallError]
[-Program <IResultObject>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
이 cmdlet은 새 Install Package 단계 개체를 만듭니다. 그런 다음 Add-CMTaskSequenceStep cmdlet을 사용하여 작업 순서에 단계를 추가합니다. 이 단계에 대한 자세한 내용은 작업 순서 단계 정보: 패키지 설치를 참조하세요.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>
). 자세한 내용은 시작을 참조하세요.
예제
예 1
이 예제에서는 먼저 Get-CMProgram cmdlet을 사용하여 ID가 XYZ0000F인패키지에서 Install 프로그램을 다운로드합니다.
다음 줄에서는 프로그램 변수를 사용하여 패키지 설치 단계에 대한 개체를 만듭니다.
그런 다음 작업 순서 개체를 시작하고 인덱스 11의 작업 순서에 이 새 단계를 추가합니다.
$program = Get-CMProgram -PackageId "XYZ0000F" -ProgramName "Install"
$step = New-CMTSStepInstallSoftware -Name "Install Package" -Program $program
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11
매개 변수
-BaseVariableName
동적 변수 목록에 따라 소프트웨어 패키지를 설치하려면 이 매개 변수를 사용합니다. 그런 다음 작업 순서에서 이 기본 변수 이름을 사용하여 패키지를 설치합니다. 자세한 내용은 동적 변수 목록에 따라 소프트웨어 패키지 설치를 참조하세요.
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 |
-ContinueOnInstallError
패키지가 설치되지 않을 경우 목록에 다른 패키지를 계속 설치하려면 이 매개 변수를 추가합니다. 이 설정을 지정하지 않으면 설치가 실패하면 단계가 즉시 종료됩니다.
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 |
-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 |
-Program
설치할 패키지에서 프로그램 개체를 지정합니다. 이 개체를 얻습니다. Get-CMProgram cmdlet을 사용합니다.
Type: | IResultObject |
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
참고
이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_TaskSequence_InstallSoftwareAction 서버 WMI 클래스를 참조하세요.