Cómo agregar una imagen de arranque desde un archivo WIM en Configuration Manager

Artículo
04/04/2023

Para agregar una imagen de arranque desde un archivo de imagen de Windows (WIM) a Configuration Manager, cree una instancia de SMS_BootImagePackage. La propiedad ImagePath debe establecerse en la ruta de acceso de convención de nomenclatura universal (UNC) al archivo WIM. La propiedad ImageIndex es el índice de la imagen necesaria en el archivo WIM.

Si la imagen de arranque requiere controladores de Windows, debe especificarlos en la ReferencedDrivers propiedad , que es una matriz de SMS_Driver_Details.

Nota:

Cuando se actualiza la imagen de arranque, por ejemplo, cuando se cambia una propiedad de imagen binaria o de arranque de Configuration Manager, la imagen de arranque debe actualizarse llamando al método RefreshPkgSource de la clase SMS_BootImagePackage.

Para agregar una imagen de arranque desde un archivo WIM

Configure una conexión con el proveedor de SMS. Para obtener más información, consulte Aspectos básicos del proveedor de SMS.
Cree una instancia de SMS_BootImagePackage.
Establezca al menos las propiedades Name, ImagePath e ImageIndex.
Confirme los cambios.

Ejemplo

El siguiente método de ejemplo agrega una imagen de arranque de un archivo WIM.

Para obtener información sobre cómo llamar al código de ejemplo, vea Llamar a fragmentos de código de Configuration Manager.

Sub AddBootImagePackage(connection, name, description, pathToWim)  

    Dim bootImagePackage   

    Set bootImagePackage = connection.Get("SMS_BootImagePackage").SpawnInstance_()  
    ' Populate the new package properties.  
    bootImagePackage.Name = name  
    bootImagePackage.Description = description  

    bootImagePackage.ImagePath = pathToWim  'UNC path to WIM file.  
    bootImagePackage.ImageIndex = 1 ' Index into WIM file for image  

    bootImagePackage.Put_  

End Sub

public void AddBootImage(  
    WqlConnectionManager connection,   
    string name,   
    string description,   
    string pathToWim)  
{  
    try  
    {  
        // Create new boot image package object.  
        IResultObject bootImagePackage = connection.CreateInstance("SMS_BootImagePackage");  

        // Populate new boot image package properties.  
        bootImagePackage["Name"].StringValue = name;  
        bootImagePackage["Description"].StringValue = description;  
        bootImagePackage["ImagePath"].StringValue = pathToWim; // UNC path required.  
        bootImagePackage["ImageIndex"].IntegerValue = 1; // Index into WIM file for image.  

        // Save new package and new package properties.  
        bootImagePackage.Put();  
    }  
    catch (SmsException e)  
    {  
        Console.WriteLine();  
        Console.WriteLine("Failed to create package. Error: " + e.Message);  
        throw;  
    }  
}

El método de ejemplo tiene los parámetros siguientes:

Parámetro	Tipo	Descripción
`connection`	-Administrado: `WqlConnectionManager` - VBScript: SWbemServices	Una conexión válida al proveedor de SMS.
`name`	-Administrado: `String` -Vbscript: `String`	Nombre del nuevo paquete de imagen de arranque.
`description`	-Administrado: `String` -Vbscript: `String`	Descripción del paquete de imagen de arranque.
`pathToWIM`	-Administrado: `Integer` -Vbscript: `Integer`	Ruta de acceso UNC a la imagen.

Compilar el código

El ejemplo de C# tiene los siguientes requisitos de compilación:

Espacios de nombres

System

System.Collections.Generic

System.Text

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Ensamblado

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Programación sólida

Para obtener más información sobre el control de errores, consulte Acerca de los errores de Configuration Manager.

Seguridad de .NET Framework

Para obtener más información sobre la protección de aplicaciones Configuration Manager, consulte Configuration Manager administración basada en roles.

Consulta también

Asignación de un paquete a un punto de distribución
Cómo agregar un controlador de Windows a un paquete de imagen de arranque de Configuration Manager
Asignación de un paquete a un punto de distribución
Información de la administración de imágenes

Compartir a través de