New-CMOperatingSystemImage
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 de 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 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 : 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.