Set-CMBootImage

Référence

Module:: ConfigurationManager

Modifier une image de démarrage du système d’exploitation.

Syntaxe

Set-CMBootImage
   [-AddOptionalComponent <IResultObject[]>]
   [-BackgroundBitmapPath <String>]
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-DeployFromPxeDistributionPoint <Boolean>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-EnableCommandSupport <Boolean>]
   [-EnablePrestartCommand <Boolean>]
   [-Force]
   [-IncludeFilesForPrestart <Boolean>]
   [-InputLocale <String>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-PrestartCommandLine <String>]
   [-PrestartIncludeFilesDirectory <String>]
   [-Priority <Priority>]
   [-Reload]
   [-RemoveOptionalComponent <IResultObject[]>]
   [-ScratchSpace <UInt32>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMBootImage
   [-AddOptionalComponent <IResultObject[]>]
   [-BackgroundBitmapPath <String>]
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-DeployFromPxeDistributionPoint <Boolean>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-EnableCommandSupport <Boolean>]
   [-EnablePrestartCommand <Boolean>]
   [-Force]
   -Id <String>
   [-IncludeFilesForPrestart <Boolean>]
   [-InputLocale <String>]
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-PrestartCommandLine <String>]
   [-PrestartIncludeFilesDirectory <String>]
   [-Priority <Priority>]
   [-Reload]
   [-RemoveOptionalComponent <IResultObject[]>]
   [-ScratchSpace <UInt32>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMBootImage
   [-AddOptionalComponent <IResultObject[]>]
   [-BackgroundBitmapPath <String>]
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-DeployFromPxeDistributionPoint <Boolean>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-EnableCommandSupport <Boolean>]
   [-EnablePrestartCommand <Boolean>]
   [-Force]
   [-IncludeFilesForPrestart <Boolean>]
   [-InputLocale <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-PrestartCommandLine <String>]
   [-PrestartIncludeFilesDirectory <String>]
   [-Priority <Priority>]
   [-Reload]
   [-RemoveOptionalComponent <IResultObject[]>]
   [-ScratchSpace <UInt32>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour modifier une image de démarrage du système d’exploitation. Les images de démarrage sont des images de l’environnement de préinstallation Windows (Windows PE) dans lesquelles vous démarrez un ordinateur client avant d’installer un système d’exploitation.

Vous pouvez ajouter des pilotes de périphérique à une image de démarrage ou modifier ses propriétés. Avant de pouvoir ajouter un nouveau pilote de périphérique, vous devez d’abord importer le pilote dans le catalogue de pilotes Configuration Manager et l’activer.

Chaque version de Configuration Manager prend en charge une version spécifique du Kit de déploiement et d’évaluation Windows (Windows ADK). Vous pouvez traiter ou personnaliser des images de démarrage lorsqu’elles sont basées sur une version de Windows PE à partir de la version prise en charge de Windows ADK.

Pour plus d’informations, consultez Gérer les images de démarrage 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 : Renommer une image de démarrage

Cette commande obtient une image de démarrage par son ID de package, puis la renomme.

Set-CMBootimage -Id "CM100004" -NewName "Custom boot image"

Exemple 2 : Définir des propriétés descriptives

Cette commande obtient une image de démarrage par son nom, puis y ajoute une version et une description.

Set-CMBootImage -Name "Custom boot image (x64)" -Version "Contoso v2.1" -Description "Managed by jqpublic"

Exemple 3 : Définir la disposition du clavier

L’exemple suivant définit la disposition du clavier par défaut de l’image de démarrage en russe (Russie). Il identifie l’image de démarrage par son ID.

Set-CMBootimage -Id "CM100004" -InputLocale "ru-ru"

Exemple 4 : Ajouter des composants facultatifs

Cet exemple obtient les composants facultatifs .NET et PowerShell, puis les ajoute à l’image de démarrage.

$netfxOC = Get-CMWinPEOptionalComponentInfo -Architecture 'x64' -Name 'WinPE-NetFX' -LanguageId 1033
$pwshOC = Get-CMWinPEOptionalComponentInfo -Architecture 'x64' -Name 'WinPE-PowerShell' -LanguageId 1033
$OCs = @($netfxOC, $pwshOC)

Set-CMBootImage -Id 'XYZ00556' -AddOptionalComponent $OCs

Paramètres

-AddOptionalComponent

Spécifiez un tableau d’objets de composant facultatifs à ajouter à l’image de démarrage. Pour obtenir cet objet, utilisez l’applet de commande Get-CMWinPEOptionalComponentInfo .

Les composants suivants sont couramment utilisés :

Microsoft .NET (WinPE-NetFX) : ce composant est un prérequis pour PowerShell. Il s’agit de l’un des plus grands composants facultatifs.
Windows PowerShell (WinPE-PowerShell) : ce composant nécessite .NET et ajoute une prise en charge limitée de PowerShell. Si vous exécutez des scripts PowerShell personnalisés pendant la phase WinPE de votre séquence de tâches, ajoutez ce composant. D’autres composants peuvent être requis pour d’autres applets de commande PowerShell.
HTML (WinPE-HTA) : si vous exécutez des applications HTML personnalisées pendant la phase WinPE de votre séquence de tâches, ajoutez ce composant.

Pour plus d’informations, consultez Gérer les images de démarrage - composants facultatifs.

Type:	IResultObject[]
Alias:	AddOptionalComponents
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-BackgroundBitmapPath

Spécifiez le chemin d’accès au fichier réseau d’un fichier image d’arrière-plan personnalisé à utiliser dans Windows PE.

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

-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

-CopyToPackageShareOnDistributionPoint

Les clients peuvent toujours télécharger une image de démarrage à partir d’un point de distribution. Si vous définissez ce paramètre sur $true, le site le rend disponible via un partage réseau nommé sur les points de distribution. Utilisez CustomPackageShareName pour spécifier un nom de partage personnalisé.

Lorsque vous activez cette option, plus d’espace est nécessaire sur les points de distribution. Elle s’applique à tous les points de distribution auxquels vous distribuez cette image de démarrage.

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

Si vous activez CopyToPackageShareOnDistributionPoint, vous pouvez utiliser ce paramètre pour personnaliser le nom du partage. La longueur maximale est de 127 caractères et ne peut pas inclure les caractères suivants : " / [ ] : | < > + = ; , ? *. Vous pouvez spécifier un nom de partage et un nom de dossier, mais la valeur maximale de chacun est de 80 caractères. Par exemple : ShareName\FolderName.

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

-DeployFromPxeDistributionPoint

Définissez ce paramètre sur $true pour rendre cette image de démarrage disponible à partir d’un point de distribution compatible PXE. Pour plus d’informations, consultez Utiliser PXE pour déployer Windows sur le réseau.

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

-Description

Spécifiez une description facultative d’une image de démarrage pour vous aider à l’identifier.

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

Cette option est déconseillée. Elle définit la propriété ForcedDisconnectEnabled de l’image de démarrage.

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

Cette option est déconseillée. Elle définit la propriété ForcedDisconnectDelay de l’image de démarrage.

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

Cette option est déconseillée. Elle définit la propriété ForcedDisconnectNumRetries de l’image de démarrage.

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

Utilisez ce paramètre pour mettre à jour les points de distribution selon une planification. Pour obtenir un objet de planification, utilisez l’applet de commande New-CMSchedule .

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

Définissez ce paramètre sur $true pour activer la réplication différentielle binaire (BDR). Pour plus d’informations, consultez Concepts fondamentaux pour la gestion de contenu dans Configuration Manager.

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

-EnableCommandSupport

Dans les environnements de test hors production uniquement, vous pouvez définir ce paramètre sur $true pour activer la prise en charge des commandes. Lorsqu’un appareil démarre sur cette image, vous pouvez appuyer sur F8 pour ouvrir une invite de commandes d’administration. Cette option est utile pour résoudre les problèmes pendant que vous testez votre déploiement. L’utilisation de ce paramètre dans un déploiement de production n’est pas recommandée en raison de problèmes de sécurité.

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

-EnablePrestartCommand

Définissez ce paramètre sur $true pour activer une commande de prédémarrage. Cette ligne de commande s’exécute avant le démarrage de la séquence de tâches.

Configurez également les paramètres suivants : IncludeFilesForPrestart, PrestartCommandLine, PrestartIncludeFilesDirectory.

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

-Force

Exécutez la commande sans demander de confirmation.

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

-Id

Spécifiez un ID d’image de démarrage à configurer. Cette valeur est un ID de package standard, par exemple : XYZ00002.

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

-IncludeFilesForPrestart

Si vous activez EnablePrestartCommand, utilisez ce paramètre si votre commande de prédémarrage nécessite l’exécution d’autres fichiers. Utilisez ensuite le paramètre PrestartIncludeFilesDirectory pour spécifier l’emplacement des fichiers à inclure.

Par exemple, si vous souhaitez exécuter un script par lots, utilisez cette option pour inclure le fichier de script.

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

-InputLocale

Utilisez ce paramètre pour configurer la disposition du clavier par défaut pour une image de démarrage. Spécifiez la balise de langue. Par exemple, pour définir les paramètres régionaux d’entrée sur Russe (Russie), spécifiez la chaîne ru-ru. Pour plus d’informations, consultez [MS-LCID] : Référence LCID (Windows Language Code Identifier).

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

-InputObject

Spécifiez un objet d’image de démarrage à configurer. Pour obtenir cet objet, utilisez l’applet de commande Get-CMBootImage .

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

-Name

Spécifiez le nom d’une image de démarrage à configurer.

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écifiez un nouveau nom pour l’image de démarrage.

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écifiez le chemin d’accès réseau de l’image Windows PE utilisée par cette image de démarrage. Vous ne pouvez pas modifier le chemin d’accès pour les images de démarrage par défaut.

Type:	String
Alias:	ImagePath
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

Si vous ne souhaitez pas que le contenu de ce package sorte du cache du client afin de laisser de l’espace pour d’autres contenus, définissez ce paramètre sur $true pour le conserver dans le cache du client.

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

Spécifiez le comportement lorsque vous activez un point de distribution pour le contenu préparé :

ManualCopy: copiez manuellement le contenu de ce package sur le point de distribution
DownloadDelta: Télécharger uniquement les modifications de contenu sur le point de distribution
OnDemand: télécharger automatiquement le contenu lorsque des packages sont attribués à des points de distribution

Pour plus d’informations, consultez Utiliser du contenu préparé.

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

-PrestartCommandLine

Si vous activez EnablePrestartCommand, utilisez ce paramètre pour spécifier la ligne de commande à exécuter. La longueur maximale est de 4 096 caractères.

Si la ligne de commande nécessite des fichiers qui ne sont pas dans Windows PE, utilisez les paramètres IncludeFilesForPrestart et PrestartIncludeFilesDirectory .

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

-PrestartIncludeFilesDirectory

Si vous activez EnablePrestartCommand et IncludeFilesForPrestart, utilisez ce paramètre pour spécifier le chemin réseau des fichiers à inclure dans l’image de démarrage.

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

-Priority

Spécifiez l’ordre dans lequel le site envoie le contenu à d’autres sites et les points de distribution de ce site.

Le site envoie du contenu de haute priorité avant les packages de priorité moyenne ou basse. Les packages avec une priorité égale sont envoyés dans l’ordre dans lequel ils sont créés.

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 les versions des composants Windows ADK dans l’image de démarrage sont obsolètes, ajoutez ce paramètre pour recharger l’image de démarrage avec la version actuelle de Windows PE à partir de Windows ADK. Pour plus d’informations, consultez Mettre à jour les points de distribution avec l’image de démarrage.

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

-RemoveOptionalComponent

Spécifiez un tableau d’objets de composant facultatifs à supprimer de l’image de démarrage. Pour obtenir cet objet, utilisez l’applet de commande Get-CMWinPEOptionalComponentInfo .

Ne supprimez pas les composants suivants, qui sont requis par Configuration Manager :

Scripting (WinPE-Scripting)
Démarrage (WinPE-SecureStartup)
Réseau (WinPE-WDS-Tools)
Script (WinPE-WMI)

Type:	IResultObject[]
Alias:	RemoveOptionalComponents
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ScratchSpace

Configurez l’espace de travail Windows PE, qui est le stockage temporaire (lecteur RAM) utilisé par WinPE. Par exemple, lorsqu’une application est exécutée dans WinPE et doit écrire des fichiers temporaires, WinPE redirige les fichiers vers l’espace de travail en mémoire pour simuler la présence d’un disque dur. Par défaut, cette quantité est de 512 Mo pour les appareils avec plus de 1 Go de RAM, sinon la valeur par défaut est de 32 Mo.

Type:	UInt32
Valeurs acceptées:	32, 64, 128, 256, 512
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

Si vous souhaitez activer la distribution de contenu à la demande sur des points de distribution préférés, définissez ce paramètre sur $true. Lorsque vous activez ce paramètre, si un client demande le contenu pour le package et que le contenu n’est disponible sur aucun point de distribution, le point de gestion distribue le contenu. Pour plus d’informations, consultez Distribution de contenu à la demande.

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écifiez la version de l’image de démarrage. Cette valeur n’est pas la version du système d’exploitation, mais une chaîne que vous gérez.

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object

Partager via