New-CMPrestageMedia
Erstellen Sie eine vorab bereitgestellte Mediendatei für die Betriebssystembereitstellung.
Syntax
New-CMPrestageMedia
[-Application <IResultObject[]>]
[-Comment <String>]
[-CreatedBy <String>]
[-DriverPackage <IResultObject[]>]
[-IncludeApplicationDependency]
-OperatingSystemImage <IResultObject>
[-OperatingSystemImageIndex <Int32>]
[-Package <IResultObject[]>]
-TaskSequence <IResultObject>
[-Version <String>]
[-AllowUacPrompt]
[-AllowUnattended]
[-AllowUnknownMachine]
-BootImage <IResultObject>
[-CertificateExpireTime <DateTime>]
[-CertificatePassword <SecureString>]
[-CertificatePath <String>]
[-CertificateStartTime <DateTime>]
-DistributionPoint <IResultObject[]>
[-Force]
-ManagementPoint <IResultObject[]>
[-SiteCode <String>]
-MediaMode <MediaMode>
[-MediaPassword <SecureString>]
[-NoAutoRun]
-Path <String>
[-PrestartCommand <String>]
[-PrestartPackage <IResultObject>]
[-TemporaryFolder <String>]
[-UserDeviceAffinity <UserDeviceAffinityType>]
[-Variable <Hashtable>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Das Cmdlet New-CMPrestageMedia erstellt eine Datei, um ein Betriebssystemimage vorab auf einer neuen Festplatte bereitzustellen. Weitere Informationen finden Sie unter Planen vorab bereitgestellter Medien.
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 vorab bereitgestellter Medien
Der erste Befehl ruft das Verwaltungspunktobjekt für den Standortsystemserver mit dem Namen mp01.contoso.com im Standortcode CM1 ab und speichert das Objekt in der variablen $ManagementPoint .
Der zweite Befehl ruft das Startimageobjekt mit dem Namen BootImage01 ab und speichert das Objekt in der variablen $BootImage .
Der dritte Befehl ruft das Verteilungspunktobjekt für den Standortsystemserver mit dem Namen dist01.contoso.com im Standortcode CM1 ab und speichert das Objekt in der variablen $DistributionPoint .
Der vierte Befehl ruft das Betriebssystemimageobjekt mit dem Namen OSImagePkg01 ab und speichert das Objekt in der variablen $OSImage .
Der letzte Befehl erstellt eine dynamische vorab bereitgestellte Mediendatei mit dem Namen PrestagedMedia.wim mit dem in $BootImage gespeicherten Startimage, dem in $DistributionPoint gespeicherten Verteilungspunkt, dem in $ManagementPoint gespeicherten Verwaltungspunkt und dem in $OSImage gespeicherten Betriebssystemimage.
$ManagementPoint = Get-CMManagementPoint -SiteSystemServerName "mp01.contoso.com" -SiteCode "CM1"
$BootImage = Get-CMBootImage -Name "BootImage01"
$DistributionPoint = Get-CMDistributionPoint -SiteSystemServerName "dist01.contoso.com" -SiteCode "CM1"
$OSImage = Get-CMOperatingSystemImage -Name "OSImagePkg01"
New-CMPrestageMedia -MediaMode Dynamic -Path "\\server\share\PrestagedMedia.wim" -BootImage $BootImage -DistributionPoint $DistributionPoint -ManagementPoint $ManagementPoint -OperatingSystemImage $OSImageParameter
-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 |
-Application
Geben Sie ein Array von Anwendungsobjekten an, die als Teil der Mediendatei eingeschlossen werden sollen. Wenn die Tasksequenz auf diesen Inhalt verweist, sucht sie zuerst lokal nach dem Inhalt. Wenn sich der Inhalt nicht in den Medien befindet, versucht die Tasksequenz, ihn wie gewohnt aus dem Netzwerk herunterzuladen. Verwenden Sie das Cmdlet Get-CMApplication , um ein Anwendungsobjekt abzurufen.
| Typ: | IResultObject[] |
| Aliase: | Applications |
| 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 |
-Comment
Eine optionale Zeichenfolge, um weitere Details zu den Medien bereitzustellen. Es ist hilfreich zu beschreiben, wie Sie diese Medien konfiguriert haben oder wie Sie diese Medien verwenden werden. Die maximale Länge beträgt 127 Zeichen.
| Typ: | String |
| 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: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CreatedBy
Eine optionale Zeichenfolge, um anzugeben, wer dieses Medium erstellt hat, was für Nachverfolgungszwecke nützlich ist. Die maximale Länge beträgt 50 Zeichen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| 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 den Inhalt für dieses Medium 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 |
-DriverPackage
Geben Sie ein Array von Treiberpaketobjekten an, die als Teil der Mediendatei eingeschlossen werden sollen. Wenn die Tasksequenz auf diesen Inhalt verweist, sucht sie lokal nach dem Inhalt. Wenn sich der Inhalt nicht in den Medien befindet, versucht die Tasksequenz, ihn wie gewohnt aus dem Netzwerk herunterzuladen. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMDriverPackage .
| Typ: | IResultObject[] |
| Aliase: | DriverPackages, PackageDriver, PackageDrivers |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| 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 |
-IncludeApplicationDependency
Fügen Sie diesen Parameter hinzu, um zugeordnete Anwendungsabhängigkeiten zu erkennen, und fügen Sie sie diesem Medium hinzu.
| Typ: | SwitchParameter |
| Aliase: | IncludeApplicationDependencies |
| 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 |
-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 |
-OperatingSystemImage
Geben Sie ein Betriebssystemimagepaketobjekt an, das für dieses Medium eingeschlossen werden soll. Verwenden Sie den Parameter OperatingSystemImageIndex , um den Imageindex im Imagepaket anzugeben. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMOperatingSystemImage .
| Typ: | IResultObject |
| Aliase: | OperatingSystemImagePackage |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-OperatingSystemImageIndex
Geben Sie den Imageindex im Imagepaket aus dem OperatingSystemImage-Parameter an.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Package
Geben Sie ein Array von Paketobjekten an, die in die Mediendatei eingeschlossen werden sollen. Wenn die Tasksequenz auf diesen Inhalt verweist, sucht sie lokal nach dem Inhalt. Wenn sich der Inhalt nicht in den Medien befindet, versucht die Tasksequenz, ihn wie gewohnt aus dem Netzwerk herunterzuladen. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMPackage .
| Typ: | IResultObject[] |
| Aliase: | Packages |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Path
Der Pfad zur zu erstellenden Mediendatei. Das Format ist entweder ein Laufwerks-/Verzeichnispfad oder ein gültiger Netzwerkpfad. Zum Beispiel:
C:\media\prestaged1.wim\\server\share\prestaged1.wim
| Typ: | String |
| Aliase: | MediaPath, OutputPath, DriveName |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PrestartCommand
Geben Sie eine Befehlszeile an, die ausgeführt werden soll, bevor die Tasksequenz gestartet wird. Weitere Informationen finden Sie unter Prestart-Befehle für Tasksequenzmedien.
| Typ: | String |
| Aliase: | PreExecCommandLine |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PrestartPackage
Wenn Sie einen PrestartCommand angeben, verwenden Sie diesen Parameter, um bei Bedarf ein Paket für Prestart-Inhalte anzugeben.
| 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 |
-TaskSequence
Geben Sie ein Tasksequenzobjekt für dieses Medium an, das ausgeführt werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMTaskSequence .
| Typ: | IResultObject |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| 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 Hashtabelle von Tasksequenzvariablen an, die während der Tasksequenzbereitstellung von diesem Medium verwendet werden sollen.
| Typ: | Hashtable |
| Aliase: | TaskSequenceVariables, Variables |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Version
Ein optionaler Zeichenfolgenwert zum Angeben einer Version für dieses Medium, der für Nachverfolgungs- und Revisionszwecke nützlich ist. Die maximale Länge beträgt 32 Zeichen.
| Typ: | String |
| 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: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
None
Ausgaben
System.Object
Hinweise
Cmdlet-Aliase: New-CMPrestagedMedia