New-CMBootableMedia
Créer un média de démarrage.
Syntaxe
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 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 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 $ManagementPointParamè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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-BootImage
Spécifiez un objet image de démarrage. Pour obtenir cet objet, utilisez l’applet de commande Get-CMBootImage .
| Type: | IResultObject |
| Alias: | BootImagePackage |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| 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 |
-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 |
-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[] |
| Alias: | DistributionPoints |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| 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 |
-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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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[] |
| Alias: | ManagementPoints |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeurs acceptées: | Dynamic, SiteBased |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-MediaType
Spécifiez si le support est un cd/DVD ou un lecteur USB amovible.
| Type: | MediaInputType |
| Valeurs acceptées: | Usb, CdDvd |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Path
Si mediaType a la valeur 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 |
| Alias: | MediaPath, OutputPath, DriveName |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Alias: | PreExecCommandLine |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Alias: | TemporaryDirectory, StagingArea |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeurs acceptées: | DoNotAllow, AdministratorApproval, AutoApproval |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Alias: | TaskSequenceVariables, Variables |
| 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 n’est pas exécutée.
| 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
System.Object