New-CMTSStepUpgradeOperatingSystem
작업 순서에 추가할 수 있는 업그레이드 OS 단계를 만듭니다.
구문
New-CMTSStepUpgradeOperatingSystem
[-DriverPackage <IResultObject>]
[-DynamicUpdateSetting <DynamicUpdateOption>]
[-EditionIndex <Int32>]
[-IgnoreMessage <Boolean>]
[-ProductKey <String>]
[-ScanOnly <Boolean>]
[-SetupTimeout <Int32>]
[-SourcePath <String>]
[-StagedContent <String>]
[-UpgradePackage <IResultObject>]
[-SoftwareUpdate <IResultObject[]>]
[-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-CMOperatingSystemInstaller cmdlet을 사용하여 OS 업그레이드 패키지에 대한 개체를 가져옵니다. 이 개체는 $osUpgPkg 변수에 저장됩니다. 다음 단계에서는 $osUpgPkg 개체를 OS 업그레이드 패키지로 사용하여 OS 업그레이드 단계에 대한 개체를 만듭니다.
그런 다음 작업 순서 개체를 가져오고 인덱스 11의 작업 순서에 이 새 단계를 추가합니다.
$osUpgPkg = Get-CMOperatingSystemInstaller -Name "OSUpgradePkg01"
$step = New-CMTSStepUpgradeOperatingSystem -Name "Upgrade OS" -UpgradePackage $osUpgPkg -EditionIndex 1
$tsNameOsd = "Default OS upgrade"
$tsUpg = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsUpg | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11매개 변수
-Condition
이 단계에서 사용할 조건 개체를 지정합니다. 이 개체를 얻으려면 작업 순서 조건 cmdlet 중 하나를 사용합니다. 예를 들어 Get-CMTSStepConditionVariable입니다.
| 형식: | IResultObject[] |
| 별칭: | Conditions |
| 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 |
-Disable
이 매개 변수를 추가하여 이 작업 순서 단계를 사용하지 않도록 설정합니다.
| 형식: | SwitchParameter |
| 별칭: | DisableThisStep |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DriverPackage
업그레이드하는 동안 Windows 설치 프로그램에 드라이버 콘텐츠를 제공할 드라이버 패키지 개체를 지정합니다. 이 패키지를 얻으려면 Get-CMDriverPackage cmdlet을 사용합니다.
StagedContent 매개 변수를 사용하여 드라이버 콘텐츠의 위치를 지정합니다.
| 형식: | IResultObject |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DynamicUpdateSetting
이 매개 변수를 사용하여 Windows 업데이트를 사용하여 Windows 설치 프로그램을 동적으로 업데이트합니다.
-
DisablePolicy: 동적 업데이트를 사용하지 마세요. -
UsingPolicy: 검색, 다운로드 및 설치 업데이트와 같은 동적 업데이트를 사용하도록 설정을 사용하도록 설정합니다. -
OverridePolicy: 동적 업데이트 작업을 실행하기 위해 로컬 정책을 실시간으로 일시적으로 재정의합니다. 컴퓨터는 Windows 업데이트에서 업데이트를 가져옵니다.
| 형식: | DynamicUpdateOption |
| 허용되는 값: | DisablePolicy, UsingPolicy, OverridePolicy |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EditionIndex
OS 업그레이드 패키지 버전의 정수 값을 지정합니다. UpgradePackage 매개 변수와 함께 이 매개 변수를 사용합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-IgnoreMessage
이 매개 변수를 로 $true 설정하여 Windows 설치 프로그램이 설치를 완료하도록 지정하고 해제할 수 있는 호환성 메시지를 무시합니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Name
이 단계의 이름을 지정하여 작업 순서에서 식별합니다.
| 형식: | String |
| 별칭: | StepName |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ProductKey
업그레이드 프로세스에 적용할 제품 키를 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ScanOnly
업그레이드를 $true 시작하지 않고 Windows 설치 프로그램 호환성 검사를 실행하려면 이 매개 변수를 로 설정합니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SetupTimeout
Configuration Manager가 이 단계에 실패하기까지의 시간(분)을 지정합니다. 이 옵션은 Windows 설치 프로그램이 처리를 중지하지만 종료하지 않는 경우에 유용합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SoftwareUpdate
버전 2107부터 기능 업데이트를 사용하여 클라이언트의 Windows OS를 업그레이드할 소프트웨어 업데이트 개체를 지정합니다. 이 개체를 얻으려면 Get-CMSoftwareUpdate cmdlet을 사용합니다.
| 형식: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SourcePath
Windows 설치 프로그램에서 사용하는 Windows 미디어의 로컬 또는 네트워크 경로를 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-StagedContent
DriverPackage와 함께 이 매개 변수를 사용하여 드라이버 콘텐츠의 위치를 지정합니다. 로컬 폴더, 네트워크 경로 또는 작업 순서 변수를 지정할 수 있습니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UpgradePackage
OS 업그레이드 패키지 개체를 지정합니다. EditionIndex 매개 변수를 사용하여 버전을 설정합니다.
이 개체를 얻으려면 Get-CMOperatingSystemInstaller cmdlet을 사용합니다.
| 형식: | IResultObject |
| 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_UpgradeOperatingSystemAction 서버 WMI 클래스를 참조하세요.