New-IsoImage
This cmdlet generates an ISO image by using the specified software depot and software specification at the specified file path. Optionally, you can pass additional kernel options, create a live image instead, overwrite existing files, or check acceptance levels for individual VIBs used during the creation of the image.
Syntax
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required
|
SoftwareSpec | String | 1 |
|
Specifies a software specification to use for the creation of the image. The software specification describes what building blocks to use when creating the ISO. All requirements in the specification need to be satisfied by the specified software depots. |
| required
|
Depots | String[] | named |
|
Specifies one or more locations of software depots that contain the payloads to create the image. The value can be either a file path to an offline depot in the format of "C:\<depot>.zip" or an URL address to the index file of the online depot in the format of "https://<address-to-depot>/index.xml". |
| required
|
Destination | String | named |
|
Indicates that you want to store the newly created image at the specified destination. |
| optional | CheckAcceptance | SwitchParameter | named |
|
Indicates that you want to validate the acceptance level of individual VIBs used for the creation of the image. |
| optional | KernelOptions | String[] | named |
|
Indicates that you want to set additional kernel options for the image. The value must be a comma-separated array in the format of "<option>=<value>". |
| optional | LiveImage | SwitchParameter | named |
|
Indicates that you want to create a live image instead of an installer image. |
| optional | Overwrite | SwitchParameter | named |
|
Indicates that you want to overwrite existing files when writing the image. |
| optional | ProgressAction | ActionPreference | named |
|
Output
Examples
Example 1
New-IsoImage "C:\<depot>.zip", "https://<address-to-depot>/index.xml" "C:\<spec>.json" -Destination "C:\<image-name>.iso"
Creates a new ISO image by using the depots located at "C:\<depot>.zip" and "https://<address-to-depot>/index.xml" (one offline and one online depot, can be used in any number and combination). Uses the software specification located at "C:\<spec>.json" to construct the image and saves it to "C:\<image-name>.iso" afterwards.
Example 2
New-IsoImage "C:\<depot>.zip", "https://<address-to-depot>/index.xml" "C:\<spec>.json" -Destination "C:\<image-name>.iso" -KernelOptions "option1=value1", "option2=value2"
Creates a new ISO image by using the depots located at "C:\<depot>.zip", "https://<address-to-depot>/index.xml" (one offline and one online depot, can be used in any number and combination). Uses the software specification located at "C:\<spec>.json" to construct the image and include the additional kernel options "option1=value1", "option2=value2" provided with -KernelOptions. Saves the image to "C:\<image-name>.iso" afterwards.
Related Commands
IsoImage
This cmdlet generates an ISO image by using the specified software depot and software specification at the specified location.