Partager via

New-CMOperatingSystemImage

  • Référence
Module:
ConfigurationManager

Créer une image de système d’exploitation.

Syntaxe

New-CMOperatingSystemImage
   [-Description <String>]
   -Name <String>
   -Path <String>
   [-Index <Int32>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour ajouter une image de système d’exploitation à un site Configuration Manager. Les images de système d’exploitation sont des fichiers WIM qui représentent une collection compressée de fichiers et dossiers de référence. Configuration Manager utilise ces images avec une séquence de tâches pour déployer un système d’exploitation sur un ordinateur. Pour plus d’informations, consultez Gérer les images de système d’exploitation avec Configuration Manager.

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 : Créer une image de système d’exploitation

Cette commande crée l’image du système d’exploitation nommée « Windows 10 latest » à partir du chemin d’accès réseau aux fichiers sources d’installation de l’image du système d’exploitation.

New-CMOperatingSystemImage -Name "Windows 10 latest" -Path "\\Contoso01\CM\Images\win10_latest.wim"

Paramètres

-Confirm

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

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

-Description

Spécifiez une description facultative pour vous aider à identifier l’image. La longueur maximale est de 127 caractères.

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

-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

-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

-Index

Lorsque vous ajoutez ce paramètre, le site extrait une image d’index unique à partir d’une image multi-index. Il place ensuite la nouvelle image dans le même dossier source que l’image d’origine.

L’utilisation de cette option entraîne un fichier image plus petit et une maintenance hors connexion plus rapide. Il prend également en charge le processus d’optimisation de la maintenance des images, pour un fichier image plus petit après l’application des mises à jour logicielles.

Type:Int32
Alias:ImageIndex
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 le nom de l’image du système d’exploitation. La longueur maximale est de 50 caractères.

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

-Path

Spécifiez le chemin d’accès réseau au fichier WIM de l’image de système d’exploitation. Le chemin d’accès doit inclure le nom de fichier WIM avec l’extension .wim .

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

-Version

Spécifiez une version facultative de l’image du système d’exploitation. Cette valeur est destinée à votre contrôle de version interne, et non à la version du système d’exploitation. La longueur maximale est de 32 caractères.

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

-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:False
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_ImagePackage classe WMI du serveur.