L’applet de commande Set-CMOperatingSystemImage modifie les paramètres de configuration d’une ou de plusieurs images de système d’exploitation dans Configuration Manager.
Les images de système d’exploitation sont des fichiers au format .wim et représentent une collection compressée de fichiers de référence et de dossiers dont Configuration Manager a besoin pour installer et configurer correctement un système d’exploitation sur un ordinateur.
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 : Modifier les paramètres d’une image de système d’exploitation à l’aide d’un ID
Cette commande modifie les paramètres de configuration de l’image du système d’exploitation avec l’ID Cm10004f.
La commande renomme l’image du système d’exploitation, ajoute une version et une description, et spécifie le chemin d’accès aux fichiers sources d’installation de l’image de système d’exploitation.
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
-CopyToPackageShareOnDistributionPoint
Type:
Boolean
Alias:
CopyToPackageShareOnDistributionPoints
Position:
Named
Valeur par défaut:
None
Obligatoire:
False
Accepter l'entrée de pipeline:
False
Accepter les caractères génériques:
False
-CustomPackageShareName
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
-Description
Spécifie une description pour l’image du système d’exploitation.
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
-DisconnectUserFromDistributionPoint
Type:
Boolean
Alias:
DisconnectUsersFromDistributionPoints
Position:
Named
Valeur par défaut:
None
Obligatoire:
False
Accepter l'entrée de pipeline:
False
Accepter les caractères génériques:
False
-DisconnectUserFromDistributionPointMins
Type:
UInt32
Alias:
DisconnectUsersFromDistributionPointsMinutes
Position:
Named
Valeur par défaut:
None
Obligatoire:
False
Accepter l'entrée de pipeline:
False
Accepter les caractères génériques:
False
-DisconnectUserFromDistributionPointRetryCount
Type:
UInt32
Alias:
DisconnectUsersFromDistributionPointsRetries
Position:
Named
Valeur par défaut:
None
Obligatoire:
False
Accepter l'entrée de pipeline:
False
Accepter les caractères génériques:
False
-DistributionPointUpdateSchedule
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
-EnableBinaryDeltaReplication
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
-ForceWildcardHandling
ForceWildcardHandling traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Impossible de 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
-Id
Spécifie un tableau d’ID d’images de système d’exploitation.
Spécifie le nom d’une image de système d’exploitation.
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
-NewName
Spécifie le nouveau nom d’une image de système d’exploitation.
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
-PassThru
Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.
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
-Path
Spécifie le chemin d’accès réseau au fichier .wim source de l’image de système d’exploitation.
Type:
String
Alias:
PackageSourcePath
Position:
Named
Valeur par défaut:
None
Obligatoire:
False
Accepter l'entrée de pipeline:
False
Accepter les caractères génériques:
False
-PersistContentInCache
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
-PrestageBehavior
Type:
PrestageBehavior
Valeurs acceptées:
ManualCopy, DownloadDelta, OnDemand
Position:
Named
Valeur par défaut:
None
Obligatoire:
False
Accepter l'entrée de pipeline:
False
Accepter les caractères génériques:
False
-Priority
Spécifie une modification pour la priorité du type de déploiement.
Les valeurs valides sont les suivantes : Augmenter et Diminuer.
Type:
Priority
Valeurs acceptées:
High, Medium, Low
Position:
Named
Valeur par défaut:
None
Obligatoire:
False
Accepter l'entrée de pipeline:
False
Accepter les caractères génériques:
False
-Reload
S’applique à la version 2006 et ultérieure. Si vous modifiez les propriétés de l’image à l’aide d’un outil externe, utilisez cette option pour recharger les informations dans la base de données du site.
Type:
SwitchParameter
Alias:
ReloadImage
Position:
Named
Valeur par défaut:
None
Obligatoire:
False
Accepter l'entrée de pipeline:
False
Accepter les caractères génériques:
False
-SendToPreferredDistributionPoint
Type:
Boolean
Alias:
SendToPreferredDistributionPoints
Position:
Named
Valeur par défaut:
None
Obligatoire:
False
Accepter l'entrée de pipeline:
False
Accepter les caractères génériques:
False
-Version
Spécifie la version de l’image du système d’exploitation.
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.