New-CMPrestageMedia

  • Referenz
Modul:
ConfigurationManager

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

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

-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 zum Abrufen eines Anwendungsobjekts das Cmdlet Get-CMApplication .

Type:IResultObject[]
Aliases:Applications
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

-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.

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

Type:String
Position:Named
Default value:None
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 den Inhalt für dieses Medium 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

-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 .

Type:IResultObject[]
Aliases:DriverPackages, PackageDriver, PackageDrivers
Position:Named
Default value:None
Required:False
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

-IncludeApplicationDependency

Fügen Sie diesen Parameter hinzu, um zugeordnete Anwendungsabhängigkeiten zu erkennen, und fügen Sie sie diesem Medium hinzu.

Type:SwitchParameter
Aliases:IncludeApplicationDependencies
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

-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

-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 .

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

-OperatingSystemImageIndex

Geben Sie den Imageindex im Imagepaket aus dem OperatingSystemImage-Parameter an.

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

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

-Path

Der Pfad zur zu erstellenden Mediendatei. Das Format ist entweder ein Laufwerks-/Verzeichnispfad oder ein gültiger Netzwerkpfad. Beispiel:

  • C:\media\prestaged1.wim
  • \\server\share\prestaged1.wim
Type:String
Aliases:MediaPath, OutputPath, DriveName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Aliases:PreExecCommandLine
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrestartPackage

Wenn Sie einen PrestartCommand angeben, verwenden Sie diesen Parameter, um bei Bedarf ein Paket für Prestart-Inhalte anzugeben.

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

-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 .

Type:IResultObject
Position:Named
Default value:None
Required:True
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 Hashtabelle von Tasksequenzvariablen an, die während der Tasksequenzbereitstellung von diesem Medium verwendet werden sollen.

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

Type:String
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:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Ausgaben

System.Object

Hinweise

Cmdlet-Aliase: New-CMPrestagedMedia