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"