Partager via

New-CMBootableMedia

  • Référence
Module:
ConfigurationManager

Créer un média de démarrage.

Syntax

New-CMBootableMedia
   [-AllowUacPrompt]
   [-AllowUnattended]
   [-AllowUnknownMachine]
   -BootImage <IResultObject>
   [-CertificateExpireTime <DateTime>]
   [-CertificatePassword <SecureString>]
   [-CertificatePath <String>]
   [-CertificateStartTime <DateTime>]
   -DistributionPoint <IResultObject[]>
   [-Force]
   [-FormatMedia]
   -ManagementPoint <IResultObject[]>
   [-SiteCode <String>]
   -MediaMode <MediaMode>
   [-MediaPassword <SecureString>]
   -MediaType <MediaInputType>
   [-NoAutoRun]
   -Path <String>
   [-PrestartCommand <String>]
   [-PrestartPackage <IResultObject>]
   [-TemporaryFolder <String>]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-Variable <Hashtable>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cette applet de commande crée un média utilisé pour déployer un système d’exploitation. Le média de démarrage contient l’image de démarrage, les commandes de prédémarrage facultatives et les fichiers associés, ainsi que les fichiers Configuration Manager. Utilisez un support de démarrage pour installer une nouvelle version de Windows sur un nouvel ordinateur (nu) ou pour remplacer un ordinateur existant et transférer les paramètres.

Remarque

Cette applet de commande nécessite des autorisations élevées pour s’exécuter.

Pour plus d’informations, consultez Vue d’ensemble du média de séquence de tâches.

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 un média de démarrage

La première commande obtient l’objet image de démarrage nommé Image de démarrage (x64) et le stocke dans la variable $BootImage . La deuxième commande obtient le rôle de point de distribution pour SiteServer01.Contoso.com et le stocke dans la variable $DistributionPoint . La troisième commande obtient le rôle de point de gestion pour SiteServer02.Contoso.com et le stocke dans la variable $ManagementPoint . La dernière commande crée un média de démarrage en mode dynamique. Il utilise les objets stockés dans les variables précédentes.

$BootImage = Get-CMBootImage -Name "Boot image (x64)"
$DistributionPoint = Get-CMDistributionPoint -SiteCode CM1
$ManagementPoint = Get-CMManagementPoint -SiteSystemServerName "SiteSystemServer02.Contoso.com"

New-CMBootableMedia -MediaMode Dynamic -MediaType CdDvd -Path "\\Server\share\test.iso" -AllowUnknownMachine -BootImage $BootImage -DistributionPoint $DistributionPoint -ManagementPoint $ManagementPoint

Paramètres

-AllowUacPrompt

Ajoutez ce paramètre pour permettre à Windows de vous inviter à élever vos autorisations d’administrateur avec le contrôle de compte d’utilisateur (UAC). Cette applet de commande nécessite des autorisations élevées pour s’exécuter.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowUnattended

Ajoutez ce paramètre pour autoriser un déploiement de système d’exploitation sans assistance. Un déploiement de système d’exploitation sans assistance n’invite pas à configurer le réseau ou à effectuer des séquences de tâches facultatives.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowUnknownMachine

Ajoutez ce paramètre pour permettre à Configuration Manager de provisionner des ordinateurs inconnus. Un ordinateur inconnu est un ordinateur que le site n’a pas encore découvert.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BootImage

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

Type:IResultObject
Aliases:BootImagePackage
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CertificateExpireTime

Si vous créez un certificat multimédia auto-signé pour la communication HTTP, ce paramètre spécifie la date et l’heure d’expiration du certificat. Spécifiez une datetime suffisamment à l’avenir. Lorsque ce certificat expire, vous ne pouvez pas utiliser le média de démarrage. Utilisez le paramètre -CertificateStartTime pour définir la date de début.

Par exemple :

$date = [datetime]::p arseexact(« 16/11/2021 », 'MM/jj/aaaa', $null)

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CertificatePassword

Si vous utilisez le paramètre -CertificatePath pour importer un certificat PKI pour la communication HTTPS, utilisez ce paramètre pour spécifier le mot de passe du fichier de certificat.

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CertificatePath

Spécifiez le chemin d’accès à un certificat PKI à importer. Utilisez le paramètre -CertificatePassword pour spécifier le mot de passe de ce fichier de certificat. Utilisez ces paramètres si vous configurez le site pour la communication client HTTPS.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CertificateStartTime

Pour créer un certificat auto-signé pour la communication HTTP, ce paramètre spécifie la date et l’heure de début du certificat. Utilisez le paramètre -CertificateExpireTime pour définir la date d’expiration. Vous ne pouvez pas utiliser le média de démarrage avant cette date.

Par exemple :

$date = [datetime]::p arseexact(« 16/11/2020 », 'MM/jj/aaaa', $null)

Type:DateTime
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:False
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

-DistributionPoint

Spécifiez un ou plusieurs objets de point de distribution sur lesquels vous avez distribué l’image de démarrage. Pour obtenir cet objet, utilisez l’applet de commande Get-CMDistributionPoint .

Type:IResultObject[]
Aliases:DistributionPoints
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

Exécutez la commande sans demander de confirmation.

Type:SwitchParameter
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

-FormatMedia

Si mediaType a la valeur Usb, vous pouvez ajouter ce paramètre pour mettre en forme le lecteur USB amovible en FAT32 et le rendre démarrable.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ManagementPoint

Spécifiez un ou plusieurs objets de point de gestion que le média utilise dans la communication initiale. Utilisez le paramètre -MediaMode pour déterminer la façon dont le média communique lors de son exécution. Pour obtenir cet objet, utilisez l’applet de commande Get-CMManagementPoint .

Type:IResultObject[]
Aliases:ManagementPoints
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MediaMode

Spécifiez comment le client trouve un point de gestion pour obtenir les informations de déploiement :

  • Dynamic: le média contacte un point de gestion, qui redirige le client vers un autre point de gestion en fonction de l’emplacement du client dans les limites du site.

  • SiteBased: le média communique le point de gestion spécifié avec le paramètre -ManagementPoint .

Type:MediaMode
Accepted values:Dynamic, SiteBased
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MediaPassword

Spécifiez un mot de passe de chaîne sécurisée pour protéger le média de séquence de tâches. Lorsque vous démarrez un appareil avec ce média, vous devez entrer le mot de passe pour continuer.

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MediaType

Spécifiez si le support est un cd/DVD ou un lecteur USB amovible.

Type:MediaInputType
Accepted values:Usb, CdDvd
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoAutoRun

Ajoutez ce paramètre pour inclure le fichier autorun.inf sur le média. Configuration Manager ne l’ajoute pas par défaut. Ce fichier est généralement bloqué par les produits anti-programme malveillant. Pour plus d’informations sur la fonctionnalité d’exécution automatique de Windows, consultez Création d’une application CD-ROM compatible avec l’exécution automatique. Si nécessaire pour votre scénario, ajoutez ce paramètre pour inclure le fichier.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Si mediaType est CdDvd, spécifiez le nom et le chemin d’accès où Configuration Manager écrit les fichiers de sortie. Par exemple : C:\output\boot.iso.

Type:String
Aliases:MediaPath, OutputPath, DriveName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PrestartCommand

Spécifiez une commande de prédémarrage qui s’exécute avant la séquence de tâches. Une commande de prédémarrage est un script ou un exécutable qui peut interagir avec l’utilisateur dans Windows PE avant l’exécution de la séquence de tâches pour installer le système d’exploitation. Si la commande n’est pas native de Windows PE, utilisez le PrestartPackage pour inclure des fichiers pour la commande.

Type:String
Aliases:PreExecCommandLine
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrestartPackage

Si vous utilisez le paramètre PrestartCommand , utilisez ce paramètre pour spécifier un package qui contient des fichiers pour la commande de prédémarrage. Pour obtenir l’objet package, utilisez l’applet de commande Get-CMPackage .

Type:IResultObject
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SiteCode

S’applique à la version 2010 et ultérieure. Utilisez ce paramètre avec le paramètre ManagementPoint pour spécifier le code du site.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TemporaryFolder

Le processus de création de média peut nécessiter beaucoup d’espace disque temporaire. Par défaut, Configuration Manager utilise le répertoire temporaire de l’utilisateur actuel : $env:temp. Par exemple : C:\Users\jqpublic\AppData\Local\Temp\. Pour vous offrir une plus grande flexibilité quant à l’emplacement de stockage de ces fichiers temporaires, spécifiez un emplacement personnalisé pour les données temporaires intermédiaires.

Type:String
Aliases:TemporaryDirectory, StagingArea
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserDeviceAffinity

Pour prendre en charge la gestion centrée sur l’utilisateur dans Configuration Manager, spécifiez comment vous souhaitez que le média associe les utilisateurs à l’ordinateur de destination. Pour plus d’informations sur la façon dont le déploiement du système d’exploitation prend en charge l’affinité entre les utilisateurs et les appareils, consultez Associer des utilisateurs à un ordinateur de destination.

  • DoNotAllow: n’autorisez pas l’affinité entre l’utilisateur et l’appareil. Le média n’associe pas les utilisateurs à l’ordinateur de destination. Dans ce scénario, la séquence de tâches n’associe pas les utilisateurs à l’ordinateur de destination lors du déploiement du système d’exploitation.

  • AdministratorApproval: autoriser l’affinité entre utilisateur et appareil en attente d’approbation de l’administrateur. Le média associe les utilisateurs à l’ordinateur de destination une fois que vous avez accordé l’approbation. Cette fonctionnalité est basée sur l’étendue de la séquence de tâches qui déploie le système d’exploitation. Dans ce scénario, la séquence de tâches crée une relation entre les utilisateurs spécifiés et l’ordinateur de destination. Il attend ensuite l’approbation d’un utilisateur administratif avant de déployer le système d’exploitation.

  • AutoApproval: autoriser l’affinité entre l’utilisateur et l’appareil avec l’approbation automatique. Le média associe automatiquement les utilisateurs à l’ordinateur de destination. Cette fonctionnalité est basée sur les actions de la séquence de tâches qui déploie le système d’exploitation. Dans ce scénario, la séquence de tâches crée une relation entre les utilisateurs spécifiés et l’ordinateur de destination lorsqu’il déploie le système d’exploitation sur l’ordinateur de destination.

Type:UserDeviceAffinityType
Accepted values:DoNotAllow, AdministratorApproval, AutoApproval
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Variable

Spécifiez une ou plusieurs variables et valeurs de séquence de tâches dans une table de hachage. Une variable de séquence de tâches est une paire nom/valeur utilisée pendant le déploiement de la séquence de tâches.

Type:Hashtable
Aliases:TaskSequenceVariables, Variables
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 n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

None

Sorties

System.Object