New-CMTSStepUpgradeOperatingSystem

  • 참조
모듈:
ConfigurationManager

작업 순서에 추가할 수 있는 업그레이드 OS 단계를 만듭니다.

Syntax

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입니다.

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

-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

-DriverPackage

업그레이드하는 동안 Windows 설치 프로그램에 드라이버 콘텐츠를 제공할 드라이버 패키지 개체를 지정합니다. 이 패키지를 얻으려면 Get-CMDriverPackage cmdlet을 사용합니다.

StagedContent 매개 변수를 사용하여 드라이버 콘텐츠의 위치를 지정합니다.

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

-DynamicUpdateSetting

이 매개 변수를 사용하여 windows 설치 프로그램을 Windows 업데이트 동적으로 업데이트합니다.

  • DisablePolicy: 동적 업데이트를 사용하지 마세요.
  • UsingPolicy: 검색, 다운로드 및 설치 업데이트와 같은 동적 업데이트를 사용하도록 설정을 사용하도록 설정합니다.
  • OverridePolicy: 동적 업데이트 작업을 실행하기 위해 로컬 정책을 실시간으로 일시적으로 재정의합니다. 컴퓨터는 Windows 업데이트 업데이트를 가져옵니다.
Type:DynamicUpdateOption
Accepted values:DisablePolicy, UsingPolicy, OverridePolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EditionIndex

OS 업그레이드 패키지 버전의 정수 값을 지정합니다. UpgradePackage 매개 변수와 함께 이 매개 변수를 사용합니다.

Type:Int32
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

-IgnoreMessage

이 매개 변수를 로 $true 설정하여 Windows 설치 프로그램이 설치를 완료하도록 지정하고 해제할 수 있는 호환성 메시지를 무시합니다.

Type:Boolean
Position:Named
Default value:None
Required:False
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

-ProductKey

업그레이드 프로세스에 적용할 제품 키를 지정합니다.

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

-ScanOnly

업그레이드를 $true 시작하지 않고 Windows 설치 프로그램 호환성 검사를 실행하려면 이 매개 변수를 로 설정합니다.

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

-SetupTimeout

Configuration Manager 이 단계에 실패하기 전까지의 시간(분)을 지정합니다. 이 옵션은 Windows 설치 프로그램이 처리를 중지하지만 종료하지 않는 경우에 유용합니다.

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

-SoftwareUpdate

버전 2107부터 기능 업데이트를 사용하여 클라이언트의 Windows OS를 업그레이드할 소프트웨어 업데이트 개체를 지정합니다. 이 개체를 얻으려면 Get-CMSoftwareUpdate cmdlet을 사용합니다.

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

-SourcePath

Windows 설치 프로그램에서 사용하는 Windows 미디어의 로컬 또는 네트워크 경로를 지정합니다.

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

-StagedContent

DriverPackage와 함께 이 매개 변수를 사용하여 드라이버 콘텐츠의 위치를 지정합니다. 로컬 폴더, 네트워크 경로 또는 작업 순서 변수를 지정할 수 있습니다.

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

-UpgradePackage

OS 업그레이드 패키지 개체를 지정합니다. EditionIndex 매개 변수를 사용하여 버전을 설정합니다.

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

Type:IResultObject
Position:Named
Default value:None
Required:False
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

입력

None

출력

IResultObject

참고

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