New-CMTSStepUpgradeOperatingSystem

  • Référence
Module:
ConfigurationManager

Créez une étape Mettre à niveau le système d’exploitation , que vous pouvez ajouter à une séquence de tâches.

Syntaxe

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

Cette applet de commande crée un nouvel objet d’étape de mise à niveau du système d’exploitation . Utilisez ensuite l’applet de commande Add-CMTaskSequenceStep pour ajouter l’étape à une séquence de tâches. Pour plus d’informations sur cette étape, consultez À propos des étapes de séquence de tâches : Mettre à niveau le système d’exploitation.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1

Cet exemple utilise d’abord l’applet de commande Get-CMOperatingSystemInstaller pour obtenir un objet pour le package de mise à niveau du système d’exploitation. Il enregistre cet objet dans la variable $osUpgPkg . L’étape suivante crée un objet pour l’étape Mettre à niveau le système d’exploitation , en utilisant l’objet $osUpgPkg comme package de mise à niveau du système d’exploitation.

Il obtient ensuite un objet de séquence de tâches et ajoute cette nouvelle étape à la séquence de tâches à l’index 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

Paramètres

-Condition

Spécifiez un objet de condition à utiliser avec cette étape. Pour obtenir cet objet, utilisez l’une des applets de commande de condition de séquence de tâches. Par exemple, Get-CMTSStepConditionVariable.

Type:IResultObject[]
Alias:Conditions
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ContinueOnError

Ajoutez ce paramètre pour activer l’option d’étape Continuer en cas d’erreur. Lorsque vous activez cette option, si l’étape échoue, la séquence de tâches continue.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Description

Spécifiez une description facultative pour cette étape de séquence de tâches.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Disable

Ajoutez ce paramètre pour désactiver cette étape de séquence de tâches.

Type:SwitchParameter
Alias:DisableThisStep
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DriverPackage

Spécifiez un objet de package de pilote pour fournir son contenu de pilote au programme d’installation de Windows pendant la mise à niveau. Pour obtenir ce package, utilisez l’applet de commande Get-CMDriverPackage .

Utilisez le paramètre StagedContent pour spécifier l’emplacement du contenu du pilote.

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DynamicUpdateSetting

Utilisez ce paramètre pour mettre à jour dynamiquement le programme d’installation de Windows avec Windows Update.

  • DisablePolicy: n’utilisez pas la mise à jour dynamique
  • UsingPolicy: permet au programme d’installation d’utiliser la mise à jour dynamique, par exemple la recherche, le téléchargement et l’installation des mises à jour.
  • OverridePolicy: remplacez temporairement la stratégie locale en temps réel pour exécuter des opérations de mise à jour dynamique. L’ordinateur reçoit les mises à jour de Windows Update.
Type:DynamicUpdateOption
Valeurs acceptées:DisablePolicy, UsingPolicy, OverridePolicy
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EditionIndex

Spécifiez une valeur entière de l’édition du package de mise à niveau du système d’exploitation. Utilisez ce paramètre avec le paramètre UpgradePackage .

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IgnoreMessage

Définissez ce paramètre sur $true pour spécifier que le programme d’installation de Windows termine l’installation, en ignorant les messages de compatibilité pouvant être ignorés.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifiez un nom pour cette étape afin de l’identifier dans la séquence de tâches.

Type:String
Alias:StepName
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ProductKey

Spécifiez la clé de produit à appliquer au processus de mise à niveau.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ScanOnly

Définissez ce paramètre sur $true pour exécuter l’analyse de compatibilité du programme d’installation de Windows sans démarrer la mise à niveau.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SetupTimeout

Spécifiez le nombre de minutes avant que Configuration Manager échoue à cette étape. Cette option est utile si le programme d’installation de Windows arrête le traitement mais ne se termine pas.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SoftwareUpdate

À compter de la version 2107, spécifiez un objet de mise à jour logicielle pour mettre à niveau le système d’exploitation Windows d’un client à l’aide d’une mise à jour des fonctionnalités. Pour obtenir cet objet, utilisez l’applet de commande Get-CMSoftwareUpdate .

Type:IResultObject[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SourcePath

Spécifiez un chemin d’accès local ou réseau au média Windows utilisé par le programme d’installation de Windows.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-StagedContent

Utilisez ce paramètre avec DriverPackage pour spécifier l’emplacement du contenu du pilote. Vous pouvez spécifier un dossier local, un chemin d’accès réseau ou une variable de séquence de tâches.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UpgradePackage

Spécifiez un objet de package de mise à niveau du système d’exploitation. Utilisez le paramètre EditionIndex pour définir l’édition.

Pour obtenir cet objet, utilisez l’applet de commande Get-CMOperatingSystemInstaller .

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_TaskSequence_UpgradeOperatingSystemAction classe WMI du serveur.