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