New-CMBootableMedia

  • Referenz
Modul:
ConfigurationManager

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 Startabbild, 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-Websitelaufwerk aus, z. PS XYZ:\>B. . 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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowUnknownMachine

Fügen Sie diesen Parameter hinzu, damit Configuration Manager unbekannte Computer bereitstellen können. Ein unbekannter Computer ist ein Computer, den der Standort noch nicht gefunden hat.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BootImage

Geben Sie ein Startimageobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMBootImage .

Type:IResultObject
Aliases:BootImagePackage
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Beispiel:

$date = [datetime]::p arseexact("16.11.2021", 'MM/tt/yyyy', $null)

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Beispiel:

$date = [datetime]::p arseexact("16.11.2020", 'MM/tt/yyyy', $null)

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:IResultObject[]
Aliases:DistributionPoints
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

Führen Sie den Befehl aus, ohne zur Bestätigung zu fragen.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FormatMedia

Wenn MediaType den Wert hat Usb, können Sie diesen Parameter hinzufügen, um das Wechseldatenträger als FAT32 zu formatieren und startbar zu machen.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:IResultObject[]
Aliases:ManagementPoints
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:MediaMode
Accepted values:Dynamic, SiteBased
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MediaType

Geben Sie an, ob es sich bei dem Medium um einen CD/DVD-Satz oder einen USB-Wechseldatenträger handelt.

Type:MediaInputType
Accepted values:Usb, CdDvd
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Wenn mediaType istCdDvd, geben Sie den Namen und Pfad an, in den Configuration Manager die Ausgabedateien schreibt. Beispiel: C:\output\boot.iso.

Type:String
Aliases:MediaPath, OutputPath, DriveName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Aliases:PreExecCommandLine
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:IResultObject
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SiteCode

Gilt für Version 2010 und höher. Verwenden Sie diesen Parameter mit dem ManagementPoint-Parameter , um den Websitecode anzugeben.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 bei der Speicherung dieser temporären Dateien zu bieten.

Type:String
Aliases:TemporaryDirectory, StagingArea
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:UserDeviceAffinityType
Accepted values:DoNotAllow, AdministratorApproval, AutoApproval
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Hashtable
Aliases:TaskSequenceVariables, Variables
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Ausgaben

System.Object