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 dynamiqueUsingPolicy
: 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.
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour