Export (0) Print
Expand All
Expand Minimize

Publish-SCWindowsPE

Updated: April 29, 2014

Applies To: System Center 2012 R2 Virtual Machine Manager

Publish-SCWindowsPE

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

Syntax

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>]




Detailed Description

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.

Parameters

-ISOPath<String>

Specifies the destination path for an ISO file.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-IsUEFI

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-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*"


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RunAsynchronously

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-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).


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VMMServer<ServerConnection>

Specifies a VMM server object.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

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

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 2: Re-create the Windows PE image and update the VMM PXE servers

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
 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft