Import-WdsBootImage
Import-WdsBootImage
Imports a boot image to the image store.
语法
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>]
详细说明
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.
参数
-AsJob
别名 |
无 |
是否为必需？ |
false |
位置？ |
named |
默认值 |
无 |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-CimSession<CimSession[]>
在远程会话中或在远程计算机上运行 cmdlet。输入计算机名称或会话对象，例如 New-CimSession 或 Get-CimSession cmdlet 的输出。默认为本地计算机上的当前会话。
别名 |
Session |
是否为必需？ |
false |
位置？ |
named |
默认值 |
无 |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-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.
别名 |
无 |
是否为必需？ |
false |
位置？ |
named |
默认值 |
无 |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-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.
别名 |
无 |
是否为必需？ |
true |
位置？ |
named |
默认值 |
无 |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-NewDescription<String>
Specifies a new description.
别名 |
无 |
是否为必需？ |
false |
位置？ |
named |
默认值 |
无 |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-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.
别名 |
无 |
是否为必需？ |
false |
位置？ |
named |
默认值 |
无 |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-NewImageName<String>
Specifies a name for the image.
别名 |
无 |
是否为必需？ |
false |
位置？ |
named |
默认值 |
无 |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-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.
别名 |
无 |
是否为必需？ |
true |
位置？ |
named |
默认值 |
无 |
是否接受管道输入？ |
True (ByValue) |
是否接受通配符？ |
false |
-SkipVerify
Indicates that Windows Deployment Services does not verify the source image file before adding it to the image store.
别名 |
无 |
是否为必需？ |
false |
位置？ |
named |
默认值 |
无 |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-ThrottleLimit<Int32>
指定可建立的用于运行此 cmdlet 的并发操作的最大数目。如果省略了此参数或输入了值 0，那么 Windows PowerShell® 将基于正在计算机上运行的 CIM cmdlet 的数目，计算 cmdlet 的最佳中止值。中止值仅适用于当前 cmdlet，而不适用于会话或计算机。
别名 |
无 |
是否为必需？ |
false |
位置？ |
named |
默认值 |
无 |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-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.
别名 |
无 |
是否为必需？ |
false |
位置？ |
named |
默认值 |
无 |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
<CommonParameters>
此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
输入
输入类型是指可通过管道传送给 cmdlet 的对象的类型。
输出
输出类型是 cmdlet 所发出对象的类型。
- Microsoft.Management.Infrastructure.CimInstance#MSFT_WdsBootImage
示例
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"