Partager via

New-CMCaptureMedia

  • Référence
Module:
ConfigurationManager

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 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 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
  • Disque dur
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