New-CMPrestageMedia
Créez un fichier multimédia préparé pour le déploiement du système d’exploitation.
Syntaxe
New-CMPrestageMedia
[-Application <IResultObject[]>]
[-Comment <String>]
[-CreatedBy <String>]
[-DriverPackage <IResultObject[]>]
[-IncludeApplicationDependency]
-OperatingSystemImage <IResultObject>
[-OperatingSystemImageIndex <Int32>]
[-Package <IResultObject[]>]
-TaskSequence <IResultObject>
[-Version <String>]
[-AllowUacPrompt]
[-AllowUnattended]
[-AllowUnknownMachine]
-BootImage <IResultObject>
[-CertificateExpireTime <DateTime>]
[-CertificatePassword <SecureString>]
[-CertificatePath <String>]
[-CertificateStartTime <DateTime>]
-DistributionPoint <IResultObject[]>
[-Force]
-ManagementPoint <IResultObject[]>
[-SiteCode <String>]
-MediaMode <MediaMode>
[-MediaPassword <SecureString>]
[-NoAutoRun]
-Path <String>
[-PrestartCommand <String>]
[-PrestartPackage <IResultObject>]
[-TemporaryFolder <String>]
[-UserDeviceAffinity <UserDeviceAffinityType>]
[-Variable <Hashtable>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
L’applet de commande New-CMPrestageMedia crée un fichier pour préparer une image de système d’exploitation sur un nouveau disque dur. Pour plus d’informations, consultez Planifier un média préparé.
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 préparé
La première commande obtient l’objet de point de gestion pour le serveur de système de site nommé mp01.contoso.com dans le code de site CM1 et stocke l’objet dans la variable $ManagementPoint .
La deuxième commande obtient l’objet d’image de démarrage nommé BootImage01 et stocke l’objet dans la variable $BootImage .
La troisième commande obtient l’objet de point de distribution pour le serveur de système de site nommé dist01.contoso.com dans le code de site CM1 et stocke l’objet dans la variable $DistributionPoint .
La quatrième commande obtient l’objet image du système d’exploitation nommé OSImagePkg01 et stocke l’objet dans la variable $OSImage .
La dernière commande crée un fichier multimédia préparé dynamique nommé PrestagedMedia.wim avec l’image de démarrage stockée dans $BootImage, le point de distribution stocké dans $DistributionPoint, le point de gestion stocké dans $ManagementPoint et l’image du système d’exploitation stockée dans $OSImage.
$ManagementPoint = Get-CMManagementPoint -SiteSystemServerName "mp01.contoso.com" -SiteCode "CM1"
$BootImage = Get-CMBootImage -Name "BootImage01"
$DistributionPoint = Get-CMDistributionPoint -SiteSystemServerName "dist01.contoso.com" -SiteCode "CM1"
$OSImage = Get-CMOperatingSystemImage -Name "OSImagePkg01"
New-CMPrestageMedia -MediaMode Dynamic -Path "\\server\share\PrestagedMedia.wim" -BootImage $BootImage -DistributionPoint $DistributionPoint -ManagementPoint $ManagementPoint -OperatingSystemImage $OSImageParamè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 |
-Application
Spécifiez un tableau d’objets d’application à inclure dans le fichier multimédia. Si la séquence de tâches fait référence à ce contenu, elle recherche d’abord le contenu localement. Si le contenu n’est pas dans le média, la séquence de tâches tente de le télécharger à partir du réseau comme d’habitude. Pour obtenir un objet d’application, utilisez l’applet de commande Get-CMApplication .
| Type: | IResultObject[] |
| Alias: | Applications |
| 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 |
-Comment
Chaîne facultative pour fournir des détails supplémentaires sur le média. Il est utile de décrire comment vous avez configuré ou comment vous allez utiliser ce média. 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 |
-Confirm
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
| Type: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-CreatedBy
Chaîne facultative pour spécifier qui a créé ce média, ce qui est utile à des fins de suivi. La longueur maximale est de 50 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 |
-DistributionPoint
Spécifiez un ou plusieurs objets de point de distribution vers lesquels vous avez distribué le contenu pour ce média. 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 |
-DriverPackage
Spécifiez un tableau d’objets de package de pilotes à inclure dans le fichier multimédia. Si la séquence de tâches fait référence à ce contenu, elle recherche le contenu localement. Si le contenu n’est pas dans le média, la séquence de tâches tente de le télécharger à partir du réseau comme d’habitude. Pour obtenir cet objet, utilisez l’applet de commande Get-CMDriverPackage .
| Type: | IResultObject[] |
| Alias: | DriverPackages, PackageDriver, PackageDrivers |
| 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 |
-IncludeApplicationDependency
Ajoutez ce paramètre pour détecter les dépendances d’application associées et ajoutez-les à ce média.
| Type: | SwitchParameter |
| Alias: | IncludeApplicationDependencies |
| 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 |
-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 |
-OperatingSystemImage
Spécifiez un objet de package d’image de système d’exploitation à inclure pour ce média. Utilisez le paramètre OperatingSystemImageIndex pour spécifier l’index d’image dans le package d’images. Pour obtenir cet objet, utilisez l’applet de commande Get-CMOperatingSystemImage .
| Type: | IResultObject |
| Alias: | OperatingSystemImagePackage |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-OperatingSystemImageIndex
Spécifiez l’index d’image dans le package d’image à partir du paramètre OperatingSystemImage .
| Type: | Int32 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Package
Spécifiez un tableau d’objets de package à inclure dans le fichier multimédia. Si la séquence de tâches fait référence à ce contenu, elle recherche le contenu localement. Si le contenu n’est pas dans le média, la séquence de tâches tente de le télécharger à partir du réseau comme d’habitude. Pour obtenir cet objet, utilisez l’applet de commande Get-CMPackage .
| Type: | IResultObject[] |
| Alias: | Packages |
| 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
Chemin d’accès au fichier multimédia à créer. Le format est un chemin d’accès lecteur/répertoire ou un chemin d’accès réseau valide. Par exemple :
C:\media\prestaged1.wim\\server\share\prestaged1.wim
| 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 ligne de commande à exécuter avant le démarrage de la séquence de tâches. Pour plus d’informations, consultez Commandes de prédémarrage pour le média de séquence de tâches.
| 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 spécifiez un PrestartCommand, utilisez ce paramètre pour spécifier un package pour le contenu de prédémarrage si nécessaire.
| 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 |
-TaskSequence
Spécifiez un objet de séquence de tâches pour ce média à exécuter. Pour obtenir cet objet, utilisez l’applet de commande Get-CMTaskSequence .
| Type: | IResultObject |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| 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 table de hachage des variables de séquence de tâches à utiliser pendant le déploiement de la séquence de tâches à partir de ce média.
| 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 |
-Version
Valeur de chaîne facultative permettant de spécifier une version pour ce média, ce qui est utile à des fins de suivi et de révision. 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: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Entrées
None
Sorties
System.Object
Notes
Alias d’applet de commande : New-CMPrestagedMedia