Page tree

You create the input parameters file to provide the CreateWinPE2_x.vbs or CreateWinPE5_1.vbs script with parameters for the boot image: architecture, location of image creation tools, location of the files to be included in the image, and image type.To create the input parameters file:

  1. In a text editor, create a new file with the name filename.ini.
    Use the following syntax to specify parameters in the input file.

    Parameter

    Description

    Arch

    (Required) Specifies the architecture of the server for which you are creating the boot image (x86 or x64).Note that WinPE 5.1 supports only x64 machines.

    BLDir

    (Required) Specifies the full path to the \provisioning\winpe subdirectory.
    For example: C:\BMC_BL\provisioning\winpe

    DestDir

    (Required) Specifies the path to the temporary local directory to hold the image files you are about to create. For example: C:\BMC_BL\tmp
    This directory must already exist before you run the CreateWinPE script.

    BootDir


    (Required) Specifies the boot image name, for example: boot_2_0_x86 or boot_2_0_x64 for WinPE 2.0 images, or boot_5_1_x64 for WinPE 5.1 images. This name is also the name of the directory containing the image files.
    Note that names containing spaces are not supported.
    In general, you can set BootDir to:
    boot_2_0 or boot_5_1
    so that you can use the default placeholders in provisioning.
    When you run the script, it creates a directory in the path specified by DestDir. This new directory has the name specified by BootDir and contains the image files.

    CustomScript

    (Optional) Specifies the path to an optional external script that you want to run when the image is mounted. Specify the script's full path and name.

    OverwriteFlag

    (Optional) If DestDir already exists and you want to overwrite it, specify OverwriteFlag=Y

    RSCDDir

    (Local boot image only) Specifies the path to the directory that contains the RSCD agent installer. For example: C:\Installers\RSCD
    The directory should contain the rscd.msi file.

    OSDrvDir

    (Local boot image only) Specifies the path to the directory that contains the driver files required for the operating system installation. For example: C:\Installers\Drivers

    BMIWinExe

    (Local boot image only) Specifies the path to the bmiwin.exe file you want to copy the local media. Specify a path name that includes the file name. For example: D:\DataStore\bmi\bmiwin.exe

    CopyToISO

    (Local boot image only) Specifies whether the script copies the configuration components (RSCD agent installer files, operating system driver files, and bmiwin.exe) to the WinPE ISO or to the LDS directory inside the WinPE image.
    Specify CopyToISO=Y to copy these files to the root of the WinPE ISO. This is the default.
    Specify CopyToISO=N to copy these files to the LDS directory.

    NetDetailsFile

    (Local boot image only) Specifies the path to the network.ini file.
    This file provides network details for each target server (static IP address, subnet mask, default gateway, WINS server) in provisioning environments where there is no DHCP server or where you want to map MAC addresses to static IPs.
    Specify a path name that includes the file name. For example: D:\Scripts\network.ini
    This file must already exist.

    AppServer

    (Local boot image only) Specifies the IP address of the Application Server that the target server contacts. Specify this parameter when a DHCP server is not present in the provisioning environment or if the DHCP server is not configured to provide the address.
    If you specify this parameter, the script includes the IP address in the WinPE image.

    AppServerPort

    (Local boot image only) Specifies the port number for the target server to use in contacting the Application Server. Specify this parameter when a DHCP server is not present in the provisioning environment or if the DHCP server is not configured to provide the address.
    If you specify this parameter, the script includes the port number in the WinPE image.

    CreatePXEFlag

    Specifies whether to generate PXE boot files for the image.
    Specify CreatePXEFlag=Y to generate the files. (This is the default.) The script creates the image files and puts them in a PXE bootable directory with the name you specified for BootDir. For example: boot_2_0_x86
    Specify CreatePXEFlag=N to suppress generation of the files.

    CreateISOFlag

    (Local boot image only) Specifies whether to generate ISO boot files for the image.
    Specify CreateISOFlag=Y to generate the files. The script creates the ISO file with the name you specified for BootDir, plus the .iso extension. For example: boot_2_0_x86.iso
    Specify CreateISOFlag=N to suppress generation of the files. (This is the default.)

    CreateUFDFilesFlag


    (Local boot image only) Specifies whether to create UFD image files for booting from a USB flash drive. UFD image files are not supported by WinPE 5.1.
    Specify CreateUFDFilesFlag=Y to generate the files. The script creates a directory with the name BootDir_UFD and puts in it the files for booting from a USB flash drive. For example: boot_2_0_x86_UFD
    Specify CreateUFDFilesFlag=N to suppress generation of UFD files. (This is the default.)

    WAIKRootDir
    or

    ADKRootDir

    Specifies a path to the Microsoft Windows Automated Installation Kit (WAIK) or Windows Assessment and Deployment Kit (ADK).
    Specify a value if you want to overwrite the default path. The default path for AIK is C:\Program Files\Windows AIK, and for ADK is C:\Program Files (x86)\Windows Kits\8.1\Assessment and Deployment Kit.

    Debug

    Specifies whether the script displays output messages as it runs.
    Specify Debug=Y to display this information.
    Specify Debug=N to suppress the display of this information. (This is the default.)

Examples

This example creates a WinPE 2.x x86 boot image for booting from the PXE server only.

Arch=x86
BLDir=D:\BladeExtract\winpe
DestDir=D:\WinPEImg\x86
BootDir=boot_2_0_x86
CustomScript=D:\Scripts\addADP.bat
CreatePXEFlag=Y
OverwriteFlag=Y
WAIKRootDir=C:\Program Files\WinAIK
Debug=N

This example creates two WinPE 2.x x86 boot images for booting from local media:

  • boot_2_0_x86.iso — An ISO image for booting from CD/DVD
  • boot_2_0_x86_UFD — A UFD image for booting from USB flash drive
Arch=x86
BLDir=D:\BladeExtract\winpe
DestDir=D:\WinPEImg\x86
BootDir=boot_2_0_x86
RSCDDir=D:\DataStore\RSCD\rscd_76_x86
OSDrvDir=D:\DataStore\Drivers
BMIWinExe=D:\DataStore\bmiwin.exe
CopyToISO=Y
CustomScript=D:\Scripts\addADP.bat
NetDetailsFile=D:\Scripts\network.ini
AppServer=190.165.33.1
AppServerPort=9831
CreatePXEFlag=N
CreateISOFlag=Y
CreateUFDFilesFlag=Y
OverwriteFlag=Y
WAIKRootDir=C:\Program Files\WinAIK
Debug=Y

This example creates two WinPE 5.1 x64 boot images — one for booting from the PXE server and the other an ISO image for booting from CD/DVD.

Arch=amd64
BLDir=C:\Users\Administrator\Downloads\8_7-provision\provisioning\winpe
DestDir=C:\Users\Administrator\Downloads\8_7-provision\provisioning\winpe\tmp
BootDir=boot_5_1_x64
Customscript=
ADKRootDir=C:\Program Files (x86)\Windows Kits\8.1\Assessment and Deployment Kit
AppServer=10.22.42.92
AppServerPort=9831
NetDetailsFile=
RSCDDir=
BMIWinExe=C:\Users\Administrator\Downloads\8_7-provision\provisioning\pxe\bmiwin.exe
OSDrvDir=
OverwriteFlag=Y
CreatePXEFlag=Y
CreateISOFlag=Y
CreateUFDFilesFlag=N
CopyToISO=Y