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.