New-CMTSStepApplyOperatingSystem
작업 순서에 추가할 수 있는 OS 이미지 적용 단계를 만듭니다.
구문
New-CMTSStepApplyOperatingSystem
[-ConfigFileName <String>]
[-ConfigFilePackage <IResultObject>]
[-Destination <DestinationType>]
[-DestinationDisk <Int32>]
[-DestinationDriveLetter <String>]
[-LayeredDriver <OsdLayeredDriver>]
[-DestinationPartition <Int32>]
[-DestinationVariable <String>]
[-ImagePackage <IResultObject>]
[-ImagePackageIndex <Int32>]
[-InstallPackage <IResultObject>]
[-InstallPackageIndex <Int32>]
[-RunFromNet <Boolean>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
이 cmdlet은 새 OS 이미지 적용 단계 개체를 만듭니다. 그런 다음 Add-CMTaskSequenceStep cmdlet을 사용하여 단계를 작업 순서에 추가합니다. 이 단계에 대한 자세한 내용은 작업 순서 정보: OS 이미지 적용을 참조하세요.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.
예제
예 1
이 예제에서는 먼저 Get-CMOperatingSystemImage cmdlet을 사용하여 OS 이미지 패키지에 대한 개체를 가져옵니다. 이 개체는 $osImgPkg 변수에 저장됩니다. 다음 단계에서는 $osImgPkg 개체를 이미지 패키지로 사용하여 OS 이미지 적용 단계에 대한 개체를 만듭니다.
그런 다음 작업 순서 개체를 가져오고 인덱스 11의 작업 순서에 이 새 단계를 추가합니다.
$osImgPkg = Get-CMOperatingSystemImage -Name "OSImagePkg01"
$step = New-CMTSStepApplyOperatingSystem -Name "Apply OS image" -ImagePackage $osImgPkg -ImagePackageIndex 1
$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 |
-ConfigFileName
사용자 지정 설치에 사용할 무인 또는 Sysprep 응답 파일의 파일 이름을 지정합니다. ConfigFilePackage 매개 변수와 함께 이 매개 변수를 사용합니다.
| 형식: | String |
| 별칭: | AnswerFileName |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ConfigFilePackage
사용자 지정 설치에 사용할 무인 또는 Sysprep 응답 파일이 포함된 패키지 개체를 지정합니다. 이 개체를 얻으려면 Get-CMPackage cmdlet을 사용합니다. ConfigFileName 매개 변수와 함께 이 매개 변수를 사용합니다.
| 형식: | IResultObject |
| 별칭: | AnswerFilePackage |
| 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 |
-Destination
이 OS를 적용할 위치를 지정합니다. 이 매개 변수를 지정하지 않으면 기본값은 입니다 NextAvailableFormattedPartition.
NextAvailableFormattedPartition: 이 작업 순서에서 운영 체제 적용 또는 데이터 이미지 적용 단계의 대상이 아직 지정되지 않은 다음 순차 파티션을 사용합니다.SpecificDiskAndPartition: DestinationDisk 매개 변수를 사용하여 디스크 번호를 지정하고 DestinationPartition 매개 변수를 사용하여 파티션 번호를 지정합니다.SpecificLogicalDriverLetter: DestinationDriveLetter 매개 변수를 사용하여 Windows PE에서 파티션에 할당된 논리 드라이브 문자를 지정합니다. 이 드라이브 문자는 새로 배포된 OS에서 할당한 드라이브 문자와 다를 수 있습니다.LogicalDriverLetterInVariable: DestinationVariable 매개 변수를 사용하여 Windows PE에서 파티션에 할당된 드라이브 문자를 포함하는 작업 순서 변수를 지정합니다. 이 변수는 일반적으로 형식 및 파티션 디스크 작업 순서 단계에 대한 Set-CMTSStepPartitionDisk 또는 New-CMTSStepPartitionDisk cmdlet의 DiskNumberVariable 매개 변수로 설정됩니다.
| 형식: | DestinationType |
| 허용되는 값: | NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DestinationDisk
를 사용하는 -Destination SpecificDiskAndPartition경우 이 매개 변수를 사용하여 디스크 번호를 지정합니다. 에서 0 로 정수를 지정합니다 99.
DestinationPartition 매개 변수도 사용합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DestinationDriveLetter
를 사용하는 -Destination SpecificLogicalDriverLetter경우 이 매개 변수를 사용하여 논리 드라이브 문자를 지정합니다. 에서 로의 드라이브 문자를 C 지정합니다 Z.
| 형식: | String |
| 별칭: | DestinationLogicalDrive |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DestinationPartition
를 사용하는 -Destination SpecificDiskAndPartition경우 이 매개 변수를 사용하여 파티션 번호를 지정합니다. 에서 1 로 정수를 지정합니다 99.
DestinationDisk 매개 변수도 사용합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DestinationVariable
를 사용하는 -Destination LogicalDriverLetterInVariable경우 이 매개 변수를 사용하여 논리 드라이브 문자로 작업 순서 변수를 지정합니다. 변수 이름은 공백이 없고 256자 미만인 영숫자여야 합니다.
| 형식: | 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 |
-ImagePackage
OS 이미지 패키지 개체를 지정합니다. 이 단계에서는 이 이미지의 OS를 적용합니다. ImagePackageIndex 매개 변수를 사용하여 이미지 인덱스를 설정합니다.
이 개체를 얻으려면 Get-CMOperatingSystemImage cmdlet을 사용합니다.
| 형식: | IResultObject |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ImagePackageIndex
이미지 인덱스의 정수 값을 지정합니다. ImagePackage 매개 변수와 함께 이 매개 변수를 사용합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-InstallPackage
OS 업그레이드 패키지 개체를 지정합니다. 이 단계는 이 원래 설치 원본의 OS를 적용합니다. InstallPackageIndex 매개 변수를 사용하여 버전을 설정합니다.
이 개체를 얻으려면 Get-CMOperatingSystemInstaller cmdlet을 사용합니다.
| 형식: | IResultObject |
| 별칭: | UpgradePackage |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-InstallPackageIndex
OS 업그레이드 패키지 버전의 정수 값을 지정합니다. InstallPackage 매개 변수와 함께 이 매개 변수를 사용합니다.
| 형식: | Int32 |
| 별칭: | UpgradePackageIndex |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-LayeredDriver
버전 2107부터 이 매개 변수를 사용하여 일본어 및 한국어와 공통적인 다른 유형의 키보드를 선택합니다. Windows와 함께 설치할 계층화된 드라이버의 정수 값을 지정합니다. OsdLayeredDriver 작업 순서 변수와 동일한 값을 사용합니다.
| 형식: | OsdLayeredDriver |
| 별칭: | KeyboardDriver |
| 허용되는 값: | DoNotSpecify, Driver1, Driver2, Driver3, Driver4, Driver5, Driver6 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Name
이 단계의 이름을 지정하여 작업 순서에서 식별합니다.
| 형식: | String |
| 별칭: | StepName |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RunFromNet
작업 순서가 배포 지점에서 OS 이미지를 직접 적용할 수 있도록 하려면 이 매개 변수 $true 를 로 설정합니다.
보안을 강화하려면 이 설정을 사용하지 않는 것이 좋습니다. 이 옵션은 스토리지 용량이 제한된 디바이스에서 사용하도록 설계되었습니다. 자세한 내용은 배포 지점에서 직접 콘텐츠 액세스를 참조하세요.
| 형식: | Boolean |
| 별칭: | AllowAccessFromDistributionPoint |
| 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_ApplyOperatingSystemAction 서버 WMI 클래스를 참조하세요.