New-CMTSStepApplyDataImage

  • 참조
모듈:
ConfigurationManager

작업 순서에 추가할 수 있는 데이터 이미지 적용 단계를 만듭니다.

Syntax

New-CMTSStepApplyDataImage
   [-Destination <DestinationType>]
   [-DestinationDisk <Int32>]
   [-DestinationDriveLetter <String>]
   [-DestinationPartition <Int32>]
   [-DestinationVariable <String>]
   -ImagePackage <IResultObject>
   -ImagePackageIndex <Int32>
   [-WipePartition <Boolean>]
   [-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

이 예제에서는 먼저 Get-CMOperatingSystemImage cmdlet을 사용하여 데이터 이미지 패키지에 대한 개체를 가져옵니다. 이 개체는 $pkgDataImg 변수에 저장됩니다. 다음 단계에서는 $pkgDataImg 개체를 이미지 패키지로 사용하여 데이터 이미지 적용 단계에 대한 개체를 만듭니다.

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

$pkgDataImg = Get-CMOperatingSystemImage -Name "Data image"
$step = New-CMTSStepApplyDataImage -Name "Apply data image" -ImagePackage $pkgDataImg -ImagePackageIndex 1

$tsName = "Custom task sequence"
$ts = Get-CMTaskSequence -Name $tsName -Fast

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

매개 변수

-Condition

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

Type:IResultObject[]
Aliases:Conditions
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

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

-ContinueOnError

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

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

-Description

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

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

-Destination

이 데이터 이미지를 적용할 위치를 지정합니다. 이 매개 변수를 지정하지 않으면 기본값은 입니다 NextAvailableFormattedPartition.

  • NextAvailableFormattedPartition: 이 작업 순서에서 운영 체제 적용 또는 데이터 이미지 적용 단계의 대상이 아직 지정되지 않은 다음 순차 파티션을 사용합니다.

  • SpecificDiskAndPartition: DestinationDisk 매개 변수를 사용하여 디스크 번호를 지정하고 DestinationPartition 매개 변수를 사용하여 파티션 번호를 지정합니다.

  • SpecificLogicalDriverLetter: DestinationDriveLetter 매개 변수를 사용하여 Windows PE에서 파티션에 할당된 논리 드라이브 문자를 지정합니다. 이 드라이브 문자는 새로 배포된 OS에서 할당한 드라이브 문자와 다를 수 있습니다.

  • LogicalDriverLetterInVariable: DestinationVariable 매개 변수를 사용하여 Windows PE에서 파티션에 할당된 드라이브 문자를 포함하는 작업 순서 변수를 지정합니다. 이 변수는 일반적으로 형식 및 파티션 디스크 작업 순서 단계에 대한 Set-CMTSStepPartitionDisk 또는 New-CMTSStepPartitionDisk cmdlet의 DiskNumberVariable 매개 변수로 설정됩니다.

Type:DestinationType
Accepted values:NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationDisk

를 사용하는 -Destination SpecificDiskAndPartition경우 이 매개 변수를 사용하여 디스크 번호를 지정합니다. 에서 0 로 정수를 지정합니다 99. DestinationPartition 매개 변수도 사용합니다.

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

-DestinationDriveLetter

를 사용하는 -Destination SpecificLogicalDriverLetter경우 이 매개 변수를 사용하여 논리 드라이브 문자를 지정합니다. 에서 로의 드라이브 문자를 C 지정합니다 Z.

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

-DestinationPartition

를 사용하는 -Destination SpecificDiskAndPartition경우 이 매개 변수를 사용하여 파티션 번호를 지정합니다. 에서 1 로 정수를 지정합니다 99. DestinationDisk 매개 변수도 사용합니다.

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

-DestinationVariable

를 사용하는 -Destination LogicalDriverLetterInVariable경우 이 매개 변수를 사용하여 논리 드라이브 문자로 작업 순서 변수를 지정합니다. 변수 이름은 공백이 없고 256자 미만인 영숫자여야 합니다.

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

-Disable

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

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-ImagePackage

데이터 이미지 패키지 개체를 지정합니다. 이 단계에서는 이 이미지의 데이터를 적용합니다. ImagePackageIndex 매개 변수를 사용하여 이미지 인덱스를 설정합니다.

이 개체를 얻으려면 Get-CMOperatingSystemImage cmdlet을 사용합니다.

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ImagePackageIndex

이미지 인덱스의 정수 값을 지정합니다. ImagePackage 매개 변수와 함께 이 매개 변수를 사용합니다.

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

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

-WhatIf

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

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

-WipePartition

이 설정은 기본적으로 사용하도록 설정되며, 이미지를 적용하기 전에 파티션의 모든 콘텐츠를 삭제합니다.

파티션의 이전 내용을 삭제하지 않도록 이 매개 변수 $false 를 로 설정합니다. 이 작업은 이전에 대상으로 지정된 파티션에 더 많은 콘텐츠를 적용하는 데 사용할 수 있습니다.

Type:Boolean
Aliases:WipePartitionBeforeApplyImage
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

None

출력

IResultObject

참고

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