New-CMBootableMedia
Erstellen Sie startbare Medien.
Syntax
New-CMBootableMedia
[-AllowUacPrompt]
[-AllowUnattended]
[-AllowUnknownMachine]
-BootImage <IResultObject>
[-CertificateExpireTime <DateTime>]
[-CertificatePassword <SecureString>]
[-CertificatePath <String>]
[-CertificateStartTime <DateTime>]
-DistributionPoint <IResultObject[]>
[-Force]
[-FormatMedia]
-ManagementPoint <IResultObject[]>
[-SiteCode <String>]
-MediaMode <MediaMode>
[-MediaPassword <SecureString>]
-MediaType <MediaInputType>
[-NoAutoRun]
-Path <String>
[-PrestartCommand <String>]
[-PrestartPackage <IResultObject>]
[-TemporaryFolder <String>]
[-UserDeviceAffinity <UserDeviceAffinityType>]
[-Variable <Hashtable>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Dieses Cmdlet erstellt Medien, die zum Bereitstellen eines Betriebssystems verwendet werden. Startbare Medien enthalten das Startimage, optionale Prestartbefehle und zugehörige Dateien sowie Configuration Manager-Dateien. Verwenden Sie startbare Medien, um eine neue Version von Windows auf einem neuen Computer (Bare-Metal) zu installieren oder einen vorhandenen Computer zu ersetzen und Einstellungen zu übertragen.
Hinweis
Dieses Cmdlet erfordert erhöhte Berechtigungen für die Ausführung.
Weitere Informationen finden Sie unter Übersicht über Tasksequenzmedien.
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 startbaren Medien
Der erste Befehl ruft das Startimageobjekt namens Boot image (x64) ab und speichert es in der variablen $BootImage . Der zweite Befehl ruft die Verteilungspunktrolle für SiteServer01.Contoso.com ab und speichert sie in der variablen $DistributionPoint . Der dritte Befehl ruft die Verwaltungspunktrolle für SiteServer02.Contoso.com ab und speichert sie in der variablen $ManagementPoint . Der letzte Befehl erstellt startbare Medien im dynamischen Modus. Es verwendet die in den vorherigen Variablen gespeicherten Objekte.
$BootImage = Get-CMBootImage -Name "Boot image (x64)"
$DistributionPoint = Get-CMDistributionPoint -SiteCode CM1
$ManagementPoint = Get-CMManagementPoint -SiteSystemServerName "SiteSystemServer02.Contoso.com"
New-CMBootableMedia -MediaMode Dynamic -MediaType CdDvd -Path "\\Server\share\test.iso" -AllowUnknownMachine -BootImage $BootImage -DistributionPoint $DistributionPoint -ManagementPoint $ManagementPoint
Parameter
-AllowUacPrompt
Fügen Sie diesen Parameter hinzu, damit Windows Sie auffordern kann, Ihre Administratorberechtigungen mit der Benutzerkontensteuerung (User Account Control, UAC) zu erhöhen. Dieses Cmdlet erfordert erhöhte Berechtigungen für die Ausführung.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-AllowUnattended
Fügen Sie diesen Parameter hinzu, um eine unbeaufsichtigte Betriebssystembereitstellung zu ermöglichen. Eine unbeaufsichtigte Betriebssystembereitstellung fordert keine Netzwerkkonfiguration oder optionale Tasksequenzen an.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-AllowUnknownMachine
Fügen Sie diesen Parameter hinzu, damit Configuration Manager unbekannte Computer bereitstellen kann. Ein unbekannter Computer ist ein Computer, den der Standort noch nicht gefunden hat.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-BootImage
Geben Sie ein Startimageobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMBootImage .
Typ: | IResultObject |
Aliase: | BootImagePackage |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-CertificateExpireTime
Wenn Sie ein selbstsigniertes Medienzertifikat für die HTTP-Kommunikation erstellen, gibt dieser Parameter das Ablaufdatum und die Uhrzeit des Zertifikats an. Geben Sie einen datetime-Wert in ausreichender Weise in der Zukunft an. Wenn dieses Zertifikat abläuft, können Sie die startbaren Medien nicht mehr verwenden. Verwenden Sie den Parameter -CertificateStartTime , um das Startdatum festzulegen.
Zum Beispiel:
$date = [datetime]::p arseexact("16.11.2021", 'MM/tt/yyyy', $null)
Typ: | DateTime |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-CertificatePassword
Wenn Sie den Parameter -CertificatePath verwenden, um ein PKI-Zertifikat für die HTTPS-Kommunikation zu importieren, verwenden Sie diesen Parameter, um das Kennwort für die Zertifikatdatei anzugeben.
Typ: | SecureString |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-CertificatePath
Geben Sie den Pfad zu einem zu importierenden PKI-Zertifikat an. Verwenden Sie den Parameter -CertificatePassword , um das Kennwort für diese Zertifikatdatei anzugeben. Verwenden Sie diese Parameter, wenn Sie den Standort für die HTTPS-Clientkommunikation konfigurieren.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-CertificateStartTime
Um ein selbstsigniertes Zertifikat für die HTTP-Kommunikation zu erstellen, gibt dieser Parameter das Startdatum und die Startzeit des Zertifikats an. Verwenden Sie den Parameter -CertificateExpireTime , um das Ablaufdatum festzulegen. Sie können die startbaren Medien bis zu diesem Datum nicht verwenden.
Zum Beispiel:
$date = [datetime]::p arseexact("16.11.2020", 'MM/tt/yyyy', $null)
Typ: | DateTime |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
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
Geben Sie mindestens ein Verteilungspunktobjekt an, an das Sie das Startimage verteilt haben. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMDistributionPoint .
Typ: | IResultObject[] |
Aliase: | DistributionPoints |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Force
Führen Sie den Befehl aus, ohne zur Bestätigung zu fragen.
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
Wenn MediaType den Wert aufweist Usb
, können Sie diesen Parameter hinzufügen, um das Usb-Wechsellaufwerk als FAT32 zu formatieren und startfähig zu machen.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ManagementPoint
Geben Sie ein oder mehrere Verwaltungspunktobjekte an, die das Medium bei der ersten Kommunikation verwendet. Verwenden Sie den Parameter -MediaMode , um zu bestimmen, wie das Medium bei der Ausführung kommuniziert. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMManagementPoint .
Typ: | IResultObject[] |
Aliase: | ManagementPoints |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-MediaMode
Geben Sie an, wie der Client einen Verwaltungspunkt findet, um Bereitstellungsinformationen abzurufen:
Dynamic
: Das Medium kontaktiert einen Verwaltungspunkt, der den Client basierend auf dem Clientstandort in den Standortgrenzen an einen anderen Verwaltungspunkt umleitet.SiteBased
: Das Medium kommuniziert den mit dem Parameter -ManagementPoint angegebenen Verwaltungspunkt.
Typ: | MediaMode |
Zulässige Werte: | Dynamic, SiteBased |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-MediaPassword
Geben Sie ein sicheres Zeichenfolgenkennwort an, um die Tasksequenzmedien zu schützen. Wenn Sie ein Gerät mit diesem Medium starten, müssen Sie das Kennwort eingeben, um den Vorgang fortzusetzen.
Typ: | SecureString |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-MediaType
Geben Sie an, ob es sich bei dem Medium um einen CD/DVD-Satz oder einen USB-Wechseldatenträger handelt.
Typ: | MediaInputType |
Zulässige Werte: | Usb, CdDvd |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-NoAutoRun
Fügen Sie diesen Parameter hinzu, um die Datei autorun.inf auf den Medien einzuschließen. Configuration Manager fügt sie standardmäßig nicht hinzu. Diese Datei wird häufig von Antischadsoftwareprodukten blockiert. Weitere Informationen zum AutoRun-Feature von Windows finden Sie unter Creating an AutoRun-enabled CD-ROM Application( Erstellen einer CD-ROM-Anwendung mit Aktiviertem Automatisch ausführen). Falls für Ihr Szenario noch erforderlich, fügen Sie diesen Parameter hinzu, um die Datei einzuschließen.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Path
Wenn mediaType ist CdDvd
, geben Sie den Namen und Pfad an, in den Configuration Manager die Ausgabedateien schreibt. Beispiel: C:\output\boot.iso
.
Typ: | String |
Aliase: | MediaPath, OutputPath, DriveName |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-PrestartCommand
Geben Sie einen Prestart-Befehl an, der vor der Tasksequenz ausgeführt wird. Ein Prestart-Befehl ist ein Skript oder eine ausführbare Datei, die mit dem Benutzer in Windows PE interagieren kann, bevor die Tasksequenz ausgeführt wird, um das Betriebssystem zu installieren. Wenn der Befehl nicht nativ für Windows PE ist, verwenden Sie prestartPackage , um Dateien für den Befehl einzuschließen.
Typ: | String |
Aliase: | PreExecCommandLine |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-PrestartPackage
Wenn Sie den PrestartCommand-Parameter verwenden, verwenden Sie diesen Parameter, um ein Paket anzugeben, das Dateien für den prestart-Befehl enthält. Verwenden Sie zum Abrufen des Paketobjekts das Cmdlet Get-CMPackage .
Typ: | IResultObject |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SiteCode
Gilt für Version 2010 und höher. Verwenden Sie diesen Parameter mit dem ManagementPoint-Parameter , um den Websitecode anzugeben.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-TemporaryFolder
Der Medienerstellungsprozess kann viel temporären Speicherplatz auf dem Laufwerk erfordern. Standardmäßig verwendet Configuration Manager das temporäre Verzeichnis des aktuellen Benutzers: $env:temp
. Beispiel: C:\Users\jqpublic\AppData\Local\Temp\
. Geben Sie einen benutzerdefinierten Speicherort für das Staging temporärer Daten an, um Ihnen mehr Flexibilität beim Speichern dieser temporären Dateien zu bieten.
Typ: | String |
Aliase: | TemporaryDirectory, StagingArea |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-UserDeviceAffinity
Um die benutzerorientierte Verwaltung in Configuration Manager zu unterstützen, geben Sie an, wie die Medien Benutzer dem Zielcomputer zuordnen sollen. Weitere Informationen dazu, wie die Betriebssystembereitstellung die Affinität zwischen Benutzer und Gerät unterstützt, finden Sie unter Zuordnen von Benutzern zu einem Zielcomputer.
DoNotAllow
: Affinität zwischen Benutzer und Gerät nicht zulassen. Die Medien ordnen dem Zielcomputer keine Benutzer zu. In diesem Szenario ordnet die Tasksequenz dem Zielcomputer keine Benutzer zu, wenn sie das Betriebssystem bereitstellt.AdministratorApproval
: Affinität zwischen Benutzer und Gerät ausstehender Genehmigung durch den Administrator zulassen. Die Medien ordnen Benutzer dem Zielcomputer zu, nachdem Sie die Genehmigung erteilt haben. Diese Funktionalität basiert auf dem Bereich der Tasksequenz, die das Betriebssystem bereitstellt. In diesem Szenario erstellt die Tasksequenz eine Beziehung zwischen den angegebenen Benutzern und dem Zielcomputer. Anschließend wird auf die Genehmigung durch einen Administrator gewartet, bevor das Betriebssystem bereitgestellt wird.AutoApproval
: Affinität zwischen Benutzer und Gerät mit automatischer Genehmigung zulassen. Die Medien ordnen Benutzer automatisch dem Zielcomputer zu. Diese Funktionalität basiert auf den Aktionen der Tasksequenz, die das Betriebssystem bereitstellt. In diesem Szenario erstellt die Tasksequenz eine Beziehung zwischen den angegebenen Benutzern und dem Zielcomputer, wenn das Betriebssystem auf dem Zielcomputer bereitgestellt wird.
Typ: | UserDeviceAffinityType |
Zulässige Werte: | DoNotAllow, AdministratorApproval, AutoApproval |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Variable
Geben Sie eine oder mehrere Tasksequenzvariablen und -werte in einer Hashtabelle an. Eine Tasksequenzvariable ist ein Name-Wert-Paar, das während der Bereitstellung der Tasksequenz verwendet wird.
Typ: | Hashtable |
Aliase: | TaskSequenceVariables, Variables |
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