Condividi tramite


New-CMTSStepUpgradeOperatingSystem

Creare un passaggio Aggiorna sistema operativo , che è possibile aggiungere a una sequenza di attività.

Sintassi

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>]

Descrizione

Questo cmdlet crea un nuovo oggetto passaggio del sistema operativo di aggiornamento . Usare quindi il cmdlet Add-CMTaskSequenceStep per aggiungere il passaggio a una sequenza di attività. Per altre informazioni su questo passaggio, vedere Informazioni sui passaggi della sequenza di attività: Aggiornare il sistema operativo.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1

Questo esempio usa innanzitutto il cmdlet Get-CMOperatingSystemInstaller per ottenere un oggetto per il pacchetto di aggiornamento del sistema operativo. Salva questo oggetto nella variabile $osUpgPkg . Il passaggio successivo crea un oggetto per il passaggio Aggiorna sistema operativo , usando l'oggetto $osUpgPkg come pacchetto di aggiornamento del sistema operativo.

Ottiene quindi un oggetto sequenza di attività e aggiunge questo nuovo passaggio alla sequenza di attività in corrispondenza dell'indice 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

Parametri

-Condition

Specificare un oggetto condizione da usare con questo passaggio. Per ottenere questo oggetto, usare uno dei cmdlet della condizione della sequenza di attività. Ad esempio, Get-CMTSStepConditionVariable.

Tipo:IResultObject[]
Alias:Conditions
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ContinueOnError

Aggiungere questo parametro per abilitare l'opzione di passaggio Continua in caso di errore. Quando si abilita questa opzione, se il passaggio ha esito negativo, la sequenza di attività continua.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specificare una descrizione facoltativa per questo passaggio della sequenza di attività.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Disable

Aggiungere questo parametro per disabilitare questo passaggio della sequenza di attività.

Tipo:SwitchParameter
Alias:DisableThisStep
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DriverPackage

Specificare un oggetto pacchetto driver per fornire il contenuto del driver al programma di installazione di Windows durante l'aggiornamento. Per ottenere questo pacchetto, usare il cmdlet Get-CMDriverPackage .

Usare il parametro StagedContent per specificare il percorso del contenuto del driver.

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DynamicUpdateSetting

Usare questo parametro per aggiornare dinamicamente l'installazione di Windows con Windows Update.

  • DisablePolicy: non usare l'aggiornamento dinamico
  • UsingPolicy: abilitare l'installazione per l'uso dell'aggiornamento dinamico, ad esempio la ricerca, il download e l'installazione degli aggiornamenti.
  • OverridePolicy: eseguire temporaneamente l'override dei criteri locali in tempo reale per eseguire le operazioni di aggiornamento dinamico. Il computer ottiene gli aggiornamenti da Windows Update.
Tipo:DynamicUpdateOption
Valori accettati:DisablePolicy, UsingPolicy, OverridePolicy
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EditionIndex

Specificare un valore intero dell'edizione del pacchetto di aggiornamento del sistema operativo. Usare questo parametro con il parametro UpgradePackage .

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IgnoreMessage

Impostare questo parametro su $true per specificare che l'installazione di Windows completa l'installazione, ignorando eventuali messaggi di compatibilità ignorabili.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specificare un nome per questo passaggio per identificarlo nella sequenza di attività.

Tipo:String
Alias:StepName
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProductKey

Specificare il codice Product Key da applicare al processo di aggiornamento.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ScanOnly

Impostare questo parametro su $true per eseguire l'analisi di compatibilità del programma di installazione di Windows senza avviare l'aggiornamento.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SetupTimeout

Specificare il numero di minuti prima che Configuration Manager non riesca in questo passaggio. Questa opzione è utile se il programma di installazione di Windows interrompe l'elaborazione ma non termina.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SoftwareUpdate

A partire dalla versione 2107, specificare un oggetto di aggiornamento software per aggiornare il sistema operativo Windows di un client usando un aggiornamento delle funzionalità. Per ottenere questo oggetto, usare il cmdlet Get-CMSoftwareUpdate .

Tipo:IResultObject[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SourcePath

Specificare un percorso locale o di rete per il supporto di Windows usato dal programma di installazione di Windows.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-StagedContent

Usare questo parametro con DriverPackage per specificare il percorso per il contenuto del driver. È possibile specificare una cartella locale, un percorso di rete o una variabile della sequenza di attività.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UpgradePackage

Specificare un oggetto pacchetto di aggiornamento del sistema operativo. Usare il parametro EditionIndex per impostare l'edizione.

Per ottenere questo oggetto, usare il cmdlet Get-CMOperatingSystemInstaller .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_TaskSequence_UpgradeOperatingSystemAction classe WMI del server.