Freigeben über


New-CMCaptureMedia

Erstellt Aufnahmemedien.

Syntax

New-CMCaptureMedia
   [-AllowUacPrompt]
   -BootImage <IResultObject>
   -DistributionPoint <IResultObject[]>
   [-Force]
   [-FormatMedia]
   [-SiteCode <String>]
   -MediaType <MediaInputType>
   [-NoAutoRun]
   -Path <String>
   [-TemporaryFolder <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Die Cmdlets New-CMCaptureMedia erstellen Medien, die zum Erfassen eines Betriebssystembereitstellungsimages von einem Referenzcomputer verwendet werden.

HINWEIS: Für die Ausführung dieses Cmdlets sind erhöhte Berechtigungen erforderlich.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Erstellen von Aufnahmemedien

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

Der erste Befehl ruft das Startimageobjekt namens Boot image (x64) ab und speichert das Objekt in der variablen $BootImage.

Der zweite Befehl ruft das Verteilungspunktobjekt für den Standortcode mit dem Namen CM1 ab und speichert das Objekt in der variablen $DistributionPoint.

Der letzte Befehl erstellt ein Erfassungsmedium mithilfe des in $BootImage gespeicherten BootImage und des Verteilungspunkts, der in $DistributionPoint gespeichert ist.

Parameter

-AllowUacPrompt

Gibt an, dass Aufforderungen zur Benutzerkontensteuerung (User Account Control, UAC) zulässig sind.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BootImage

Gibt ein Startimageobjekt an. Verwenden Sie das Cmdlet Get-CMBootImage , um ein Startimageobjekt abzurufen.

Typ:IResultObject
Aliase:BootImagePackage
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DistributionPoint

Gibt ein Array von Verteilungspunktobjekten an. Verwenden Sie zum Abrufen eines Verteilungspunktobjekts das Cmdlet Get-CMDistributionPoint .

Typ:IResultObject[]
Aliase:DistributionPoints
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Erzwingt die Ausführung des Befehls ohne Benutzerbestätigung.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FormatMedia

Gibt an, dass das Cmdlet das Usb-Wechsellaufwerk (FAT32) formatiert und startbar macht.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MediaType

Gibt den Medienmodus an. Gültige Werte sind:

  • USB
  • CdDvd
  • Festplatte
Typ:MediaInputType
Zulässige Werte:Usb, CdDvd
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NoAutoRun

Verwenden Sie diesen Parameter, um die folgende Option im Assistenten zum Erstellen von Tasksequenzmedien zu konfigurieren: Einschließen der Datei autorun.inf auf Medien

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Path

Gibt den Namen und Pfad an, in den die Ausgabedateien geschrieben werden.

Typ:String
Aliase:MediaPath, OutputPath, DriveName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SiteCode

{{ Fill SiteCode Description }}

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TemporaryFolder

{{ Fill TemporaryFolder Description }}

Typ:String
Aliase:TemporaryDirectory, StagingArea
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

System.Object