New-CMTSStepDownloadPackageContent
작업 순서에 추가할 수 있는 패키지 콘텐츠 다운로드 단계를 만듭니다.
구문
New-CMTSStepDownloadPackageContent
-AddPackage <IResultObject[]>
[-ContinueDownload <Boolean>]
[-DestinationVariable <String>]
[-LocationOption <LocationType>]
[-Path <String>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
이 cmdlet은 새 패키지 콘텐츠 다운로드 단계 개체를 만듭니다. 그런 다음 Add-CMTaskSequenceStep cmdlet을 사용하여 단계를 작업 순서에 추가합니다. 이 단계에 대한 자세한 내용은 작업 순서 단계: 패키지 콘텐츠 다운로드를 참조하세요.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.
예제
예제 1: 조건을 사용하여 작업 순서 단계 만들기 및 그룹에 추가
다음은 필요한 매개 변수에 대한 변수를 설정하는 예제입니다. 그런 다음 New-CMTSStepDownloadPackageContent cmdlet을 사용하여 단계를 만들고 이를 변수로 저장합니다. 그런 다음 Set-CMTaskSequenceGroup cmdlet을 사용하여 특정 그룹의 작업 순서에 단계를 추가합니다.
$TaskSequenceName = "Module - Download Driver Packages"
$Model = "Latitude E7470"
$GroupName = "Dell Drivers"
$ContentPackage = Get-CMPackage -Fast -Name "Driver Dell Latitude E7470"
$StepName = $ContentPackage.Name
$ConditionQuery = "Select * From Win32_ComputerSystem Where Model = `"$Model`""
$StepCondition = New-CMTSStepConditionQueryWMI -Namespace "root\cimv2" -Query $ConditionQuery
$PackageStep = New-CMTSStepDownloadPackageContent -AddPackage $ContentPackage -Name $StepName -LocationOption TaskSequenceWorkingFolder -DestinationVariable "DRIVERS" -Condition $StepCondition
Set-CMTaskSequenceGroup -TaskSequenceName $TaskSequenceName -StepName $GroupName -AddStep $PackageStep -InsertStepStartIndex 1매개 변수
-AddPackage
단계에서 사용할 하나 이상의 패키지 개체를 지정합니다. 이 개체를 얻으려면 Get-CMPackage cmdlet을 사용합니다.
| 형식: | IResultObject[] |
| 별칭: | AddPackages |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Condition
이 단계에서 사용할 조건 개체를 지정합니다. 조건 개체를 얻으려면 단계 조건 cmdlet 중 하나를 사용합니다. 예를 들어 New-CMTSStepConditionQueryWMI입니다.
| 형식: | IResultObject[] |
| 별칭: | Conditions |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ContinueDownload
패키지 다운로드가 실패할 true 경우 목록에서 다른 패키지를 계속 다운로드하려면 이 매개 변수를 로 설정합니다.
| 형식: | Boolean |
| 별칭: | ContinueDownloadOnError |
| 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 |
-DestinationVariable
이 매개 변수를 사용하여 패키지의 경로를 사용자 지정 작업 순서 변수에 저장합니다.
| 형식: | String |
| 별칭: | DestinationVariableName |
| 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 |
-LocationOption
작업 순서에서 패키지를 저장하는 위치에 대해 다음 값 중 하나를 지정합니다.
TaskSequenceWorkingFolder: 작업 순서 캐시라고도 하는 작업 순서 작업 디렉터리를 사용합니다.ClientCache: Configuration Manager 클라이언트 캐시를 사용합니다. 기본적으로 이 경로는 입니다%WinDir%\ccmcache.CustomPath: 작업 순서 엔진은 먼저 패키지를 작업 순서 작업 디렉터리에 다운로드합니다. 그런 다음 사용자가 지정한 이 경로로 콘텐츠를 이동합니다. 작업 순서 엔진은 패키지 ID를 사용하여 경로를 추가합니다. 이 옵션을 사용하는 경우 Path 매개 변수를 사용하여 경로를 설정합니다.
| 형식: | LocationType |
| 허용되는 값: | TaskSequenceWorkingFolder, ClientCache, CustomPath |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Name
이 단계의 이름을 지정하여 작업 순서에서 식별합니다.
| 형식: | String |
| 별칭: | StepName |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Path
를 지정 -LocationOption CustomPath하는 경우 이 매개 변수를 사용하여 패키지 콘텐츠를 저장할 로컬 경로를 지정합니다. 작업 순서 엔진은 패키지 ID를 사용하여 경로를 추가합니다.
| 형식: | String |
| 별칭: | DestinationCustomPath |
| 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_DownloadPackageContentAction 서버 WMI 클래스를 참조하세요.