Publish-SCWindowsPE

Publish-SCWindowsPE

Publishes an updated Windows PE image for use by all PXE servers in your VMM environment.

構文

Parameter Set: UseCustomizedWinPE
Publish-SCWindowsPE -Path <String> [-ISOPath <String> ] [-IsUEFI] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: UseDefaultImage
Publish-SCWindowsPE -UseDefaultImage [-ISOPath <String> ] [-IsUEFI] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

詳細説明

The Publish-SCWindowsPE cmdlet publishes an updated Windows Preinstallation Environment (Windows PE) image for use by all Pre-Boot Execution Environment (PXE) servers in your Virtual Machine Manager (VMM) environment.

Note: This cmdlet must be run on the VMM management server.

Scenarios that require an updated Windows PE image include the following:

-- The Windows Automated Installation Kit (AIK) is patched, or Microsoft issues a new version of Windows AIK.
-- The VMM agent binaries are patched.
-- You add your own drivers, or other custom files, to Windows PE.

Note: Customize the Windows PE image by adding drivers or custom files using standard Windows tools and then use this cmdlet to publish the updated Windows PE boot WIM image on a library share.

Each scenario requires that you use this cmdlet not only to add the updated Windows PE image to VMM but also to rebuild it.

Tasks that you perform by using this cmdlet include the following:

-- Specify the source Windows PE image.

Option 1: Start from the standard Windows PE image from the Windows AIK that is currently installed on the VMM management server. In this case, both x86 and x64 versions of Windows PE must be processed.

Option 2: Start from an existing Windows PE image on a VMM library share. In this case, only the specified Windows PE image, which is either x86 or x64, is processed.

Note: The Windows PE image chosen must not already contain the VMM agent. If such a Windows PE image is chosen, an error is returned and the Windows PE image is not imported.

-- Specify the Library Resource Folder in which to store the updated Windows PE image.

Note: VMM creates a folder named Boot WIMS with Agent on the target Library Resource Folder, if it does not already exist.

-- Construct a new Windows PE image from the source Windows PE image as follows:

---- Copy the source Windows PE image into a temporary location on the VMM management server.
---- Mount the Windows PE image.
---- Copy the agent files from the fixed location on the VMM management server into a fixed location in the Windows PE image. Overwrite any files that already exist in the Windows PE image, but do not otherwise delete any files or directories.
---- Perform Windows PE configuration tasks, such as setting the RAM disk size, ensuring that optional features like WMI are installed, and so on.
---- Unmount the image and commit changes.
---- Copy the updated Windows PE image into the Boot WIMs with Agent folder.

-- Force discovery on the Library Resource Folder, and confirm that the newly placed Windows PE image appears in your VMM environment.

-- Use Publish-SCWindowsPE to copy all Windows PE images in the Boot WIMs with Agent folder to all PXE servers, and to extract Windows network boot programs (NBP) on each PXE server.

パラメーター

-ISOPath<String>

Specifies the destination path for an ISO file.

-IsUEFI

Indicates that the computer on which the operating system will be installed is Unified Extensible Firmware Interface (UEFI)-based.

-Path<String>

Specifies the destination path for the operation.

Example formats:

Local: -Path "F:\"

UNC: -Path "\\Library\Templates"

Volume GUID: -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"

VMware ESX: -Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"

Citrix XenServer: -Path "Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]"

Wildcards are supported for Get- cmdlets and when you specify the UNC path.

Example format:

UNC: -Path "\\VMHostServer\MyVMs\*VM*"

-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

-UseDefaultImage

Indicates that new or updated Windows Preinstallation Environment (Windows PE) images are published by using the standard Windows PE images from the latest Windows Automated Deployment Kit (Windows ADK).

-VMMServer<ServerConnection>

Specifies a VMM server object.

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

Example Example 1: Update the Windows PE image with a custom Windows PE image base.d

This command uses a customized base image to create a Windows PE image and updates all VMM PXE servers.

PS C:\> Publish-SCWindowsPE -Path "\\LibraryServer02\VMMWinPE\ContosoIT.wim"

Example Example 2: Re-create the Windows PE image and update the VMM PXE servers.d

This command re-creates the Windows PE image by using the Windows PE image from or updated by the Windows ADK. It then updates all VMM PXE servers.

PS C:\> Publish-SCWindowsPE -UseDefaultImage