ExportDefaultBootImage Method in Class SMS_BootImagePackage

  • Article

Applies To: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

In Configuration Manager, the ExportDefaultBootImage Windows Management Instrumentation (WMI) class method finalizes a boot image and then exports the image from the specified source to the specified location.

The following syntax is simplified from Managed Object Format (MOF) code and defines the method.

SInt32 ExportDefaultBootImage(
     String Architecture,
     UInt32 ImageIndex,
     String ExportImagePath
);

Parameters

  • Architecture
    Data type: String

    Qualifiers: [in]

    Operating system architecture of the boot image. Possible values are:

    x86

    I386 32-bit microprocessor

    ia64

    Itanium 64-bit microprocessor

    x64

    X86-64 64-bit microprocessor

  • ImageIndex
    Data type: UInt32

    Qualifiers: [in]

    The index of the boot image in the Windows Automated Installation Kit source that is used by Configuration Manager setup.

  • ExportImagePath
    Data type: String

    Qualifiers: [in]

    The destination path of the boot image to export, for example, c:\winPE\boot.wim.

Return Values

An SInt32 data type that is 0 to indicate success or non-zero to indicate failure.

For information about handling returned errors, see About Configuration Manager Errors.

Remarks

Note

Because Configuration Manager uses this method in importing the operating system, be sure to use secure programming techniques in your application or script.

The ExportDefaultBootImage method is not thread-safe.

This method finalizes a boot image by adding components or deleting old components to reduce the image size. Each .wim file can contain multiple images, but the export occurs only for the boot image.

Requirements

Runtime Requirements

For more information, see Configuration Manager Server Runtime Requirements.

Development Requirements

For more information, see Configuration Manager Server Development Requirements.

See Also

Reference

SMS_BootImagePackage Server WMI Class

Concepts

Operating System Deployment Image Management