New-CMPrestageMedia

Référence

Module:: ConfigurationManager

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 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 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 $OSImage

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
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’images à 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

Partager via