Import-WdsBootImage

Import-WdsBootImage

Imports a boot image to the image store.

Syntax

Parameter Set: AutoStart
Import-WdsBootImage -Multicast -Path <String> [-AsJob] [-CimSession <CimSession[]> ] [-DisplayOrder <UInt32> ] [-NewDescription <String> ] [-NewFileName <String> ] [-NewImageName <String> ] [-SkipVerify] [-ThrottleLimit <Int32> ] [-TransmissionName <String> ] [ <CommonParameters>]

Parameter Set: ImageFile
Import-WdsBootImage -Path <String> [-AsJob] [-CimSession <CimSession[]> ] [-DisplayOrder <UInt32> ] [-NewDescription <String> ] [-NewFileName <String> ] [-NewImageName <String> ] [-SkipVerify] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Detaillierte Beschreibung

The Import-WdsBootImage cmdlet imports a boot image from a Windows image file (.wim) to the Windows Deployment Services image store. You can assign the name, description, and file name of the image that you import. You can also enable a multicast transmission for the image.

Parameter

-AsJob

-CimSession<CimSession[]>

Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines Cmdlets New-CimSession oder Get-CimSession. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

-DisplayOrder<UInt32>

Specifies the order in which images appear in the menu on Pre-Boot Execution Environment (PXE) clients. The menu lists the boot images in ascending order, smallest number to largest number.

If two boot images have the same display order, the imported images appear in alphabetical order of file name. If you do not specify this parameter, the imported images appear in the middle of the list.

-Multicast

Indicates that the cmdlet enables an autocast transmission of the image. If you do not specify the TransmissionName parameter, Windows Deployment Services uses the image name of the imported image for the multicast.

-NewDescription<String>

Specifies a new description.

-NewFileName<String>

Specifies a new file name for the image file. Windows Deployment Services verifies that the source image file is unique before adding it to the image store.

If you do not specify this parameter, Windows Deployment Services uses the file name of the source image file for the imported image file.

-NewImageName<String>

Specifies a name for the image.

-Path<String>

Specifies the fully qualified path of the file that contains the boot image. The path must accessible to the Windows Deployment Services server.

-SkipVerify

Indicates that Windows Deployment Services does not verify the source image file before adding it to the image store.

-ThrottleLimit<Int32>

Gibt die maximale Anzahl von gleichzeitigen Vorgängen an, die zum Ausführen dieses Cmdlets eingerichtet werden können. Wenn dieser Parameter ausgelassen oder der Wert 0 eingegeben wird, berechnet Windows PowerShell® einen optimalen Drosselungsgrenzwert für das Cmdlet basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden. Die Drosselungsgrenze gilt nur für das aktuelle Cmdlet und nicht für die Sitzung oder den Computer.

-TransmissionName<String>

Specifies a name for the multicast transmission. If you do not specify this parameter, Windows Deployment Services uses the image name of the imported image for the multicast.

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

• Microsoft.Management.Infrastructure.CimInstance#MSFT_WdsBootImage

Beispiele

Example 1: Import a boot image

This command imports a boot image named boot.wim. The command specifies a new image name, description, and file name for the imported image. The command specifies that Windows Deployment Services does not verify the source image file before adding it to the image store.

PS C:\> Import-WdsBootImage -Path "E:\sources\boot.wim" -NewImageName "Fabrikam LOB setup (x86)" -NewDescription "Choose this image to install Fabrikam LOB on computers with x86 processors." -NewFileName "Fabrikamx86boot.wim" -SkipVerify

Example 2: Import a boot image and enable multicast

This command imports a boot image named winpe.wim. The command specifies the order in which boot images appear in the menu on PXE clients. The command enables a multicast transmission of the image and specifies the name for the multicast transmission.

PS C:\> Import-WdsBootImage -Path "D:\Images\BootImages\winpe.wim" -DisplayOrder 3 -Multicast -TransmissionName "Custom LOB multicast"

Verwandte Themen

Get-WdsBootImage

Set-WdsBootImage

Enable-WdsBootImage

Disable-WdsBootImage

Remove-WdsBootImage

Export-WdsBootImage