Como adicionar uma imagem de boot a partir de um ficheiro WIM no Gestor de Configuração

Artigo
08/12/2021

Adicione uma imagem de arranque de um ficheiro de Windows Image (WIM) ao Gestor de Configuração, criando uma instância de SMS_BootImagePackage. A propriedade ImagePath deve ser definida para o caminho da Convenção Universal de Nomeação (UNC) para o ficheiro WIM. A propriedade ImageIndex é o índice da imagem necessária dentro do ficheiro WIM.

Se a imagem de arranque requer Windows condutores, especifique-os na ReferencedDrivers propriedade, que é um conjunto de SMS_Driver_Details.

Nota

Quando a imagem de arranque é atualizada, por exemplo, quando uma propriedade binária ou de imagem de arranque do Gestor de Configuração é alterada, a imagem de arranque deve ser atualizada chamando o método refreshPkgsource de classe SMS_BootImagePackage.

Para adicionar uma imagem de arranque a partir de um ficheiro WIM

Configurar uma ligação com o Fornecedor DE SMS. Para mais informações, consulte os fundamentos do Fornecedor de SMS.
Criar um exemplo de SMS_BootImagePackage.
Defina pelo menos as propriedades Nome, ImagePath e ImageIndex.
Cometa as mudanças.

Exemplo

O método de exemplo a seguir adiciona uma imagem de arranque a partir de um ficheiro WIM.

Para obter informações sobre a chamada do código de amostra, consulte o Código de Identificação do Gestor de Chamadas.

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;  
    }  
}

O método da amostra tem os seguintes parâmetros:

Parâmetro	Tipo	Description
`connection`	- Gerido: `WqlConnectionManager` - VBScript: SWbemServices	Uma ligação válida ao Fornecedor de SMS.
`name`	- Gerido: `String` - VBScript: `String`	Nome para o novo pacote de imagem de arranque.
`description`	- Gerido: `String` - VBScript: `String`	Descrição para o pacote de imagem de arranque.
`pathToWIM`	- Gerido: `Integer` - VBScript: `Integer`	Caminho da UNC para a imagem.

A Compilar o Código

O exemplo C# tem os seguintes requisitos de compilação:

Espaços de nomes

Sistema

System.Collections.Generic

System.Text

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assemblagem

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Programação Robusta

Para obter mais informações sobre o tratamento de erros, consulte Sobre erros do Gestor de Configuração.

Segurança do .NET Framework

Para obter mais informações sobre a segurança das aplicações do Gestor de Configuração, consulte a administração baseada em funções do Gestor de Configuração.

Consulte também

Como atribuir um pacote a um ponto de distribuição
Como adicionar um Windows driver a um pacote de imagem de boot manager de configuração
Como atribuir um pacote a um ponto de distribuição
About image management (Acerca da gestão de imagens)

Partilhar via