New-CMCaptureMedia
Crée un média de capture.
Syntaxe
New-CMCaptureMedia
[-AllowUacPrompt]
-BootImage <IResultObject>
-DistributionPoint <IResultObject[]>
[-Force]
[-FormatMedia]
[-SiteCode <String>]
-MediaType <MediaInputType>
[-NoAutoRun]
-Path <String>
[-TemporaryFolder <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Les applets de commande New-CMCaptureMedia créent un média utilisé pour capturer une image de déploiement de système d’exploitation à partir d’un ordinateur de référence.
REMARQUE : Cette applet de commande nécessite des autorisations élevées pour s’exécuter.
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 capture
PS XYZ:\> $BootImage = Get-CMBootImage -Name "Boot image (x64)"
PS XYZ:\> $DistributionPoint = Get-CMDistributionpoint -SiteCode CM1
PS XYZ:\> New-CMCaptureMedia -MediaType CdDvd -Path "\\server\share\CaptureMedia.iso" -BootImage $BootImage -DistributionPoint $DistributionPoint
La première commande obtient l’objet image de démarrage nommé Image de démarrage (x64) et stocke l’objet dans la variable $BootImage.
La deuxième commande obtient l’objet de point de distribution pour le code de site nommé CM1 et stocke l’objet dans la variable $DistributionPoint.
La dernière commande crée un média de capture à l’aide de l’image de démarrage stockée dans $BootImage et du point de distribution stocké dans $DistributionPoint.
Paramètres
-AllowUacPrompt
Indique que les invites de contrôle de compte d’utilisateur (UAC) sont autorisées.
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écifie un objet image de démarrage. Pour obtenir un objet image de démarrage, 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 |
-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écifie un tableau d’objets de point de distribution. Pour obtenir un objet de point de distribution, 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
Force l’exécution de la commande sans demander la confirmation de l’utilisateur.
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
Indique que l’applet de commande met en forme le lecteur USB amovible (FAT32) et le rend 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 |
-MediaType
Spécifie le mode multimédia. Les valeurs valides sont les suivantes :
- Usb
- CdDvd
- Hd
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
Utilisez ce paramètre pour configurer l’option suivante à partir de l’Assistant Création d’un média de séquence de tâches : Inclure le fichier autorun.inf sur le média
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écifie le nom et le chemin d’accès où les fichiers de sortie sont écrits.
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 |
-SiteCode
{{ Fill SiteCode Description }}
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
{{ Fill TemporaryFolder Description }}
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 |
-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
None
Sorties
System.Object
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour