New-CMTSStepUpgradeOperatingSystem

  • Riferimento
Modulo:
ConfigurationManager

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 Configuration Manager cmdlet dall'unità del sito 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.

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

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Description

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

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

-Disable

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

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

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:IResultObject
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.
Type:DynamicUpdateOption
Accepted values:DisablePolicy, UsingPolicy, OverridePolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EditionIndex

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

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

-ForceWildcardHandling

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

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

-IgnoreMessage

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

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

-Name

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

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

-ProductKey

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

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

-ScanOnly

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

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

-SetupTimeout

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

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

-SourcePath

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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à.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.