Partager via


New-CMTSStepUpgradeOperatingSystem

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

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

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 Configuration Manager applets de commande à 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[]
Aliases:Conditions
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

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

-Description

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

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

-Disable

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

Type:SwitchParameter
Aliases:DisableThisStep
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 obtient les mises à jour de 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

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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

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

-ProductKey

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

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

-SetupTimeout

Spécifiez le nombre de minutes avant que Configuration Manager’échec de 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.