Como adicionar uma imagem de inicialização de um arquivo WIM no Configuration Manager

Artigo
04/04/2023

Você adiciona uma imagem de inicialização de um arquivo WIM (Windows Image) a Configuration Manager criando uma instância de SMS_BootImagePackage. A propriedade ImagePath deve ser definida como o caminho da UNC (Convenção Universal de Nomenclatura) para o arquivo WIM. A propriedade ImageIndex é o índice para a imagem necessária no arquivo WIM.

Se a imagem de inicialização exigir drivers do Windows, especifique-os ReferencedDrivers na propriedade, que é uma matriz de SMS_Driver_Details.

Observação

Quando a imagem de inicialização é atualizada, por exemplo, quando uma Configuration Manager propriedade binária ou de imagem de inicialização é alterada, a imagem de inicialização deve ser atualizada chamando o método RefreshPkgSource da classe SMS_BootImagePackage.

Para adicionar uma imagem de inicialização de um arquivo WIM

Configure uma conexão com o Provedor de SMS. Para obter mais informações, confira Os fundamentos do Provedor de SMS.
Crie uma instância de SMS_BootImagePackage.
Defina pelo menos as propriedades Nome, ImagePath e ImageIndex.
Confirme as alterações.

Exemplo

O método de exemplo a seguir adiciona uma imagem de inicialização de um arquivo WIM.

Para obter informações sobre como chamar o código de exemplo, consulte Chamando Configuration Manager Snippets de Código.

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 de exemplo tem os seguintes parâmetros:

Parâmetro	Tipo	Descrição
`connection`	-Gerenciado: `WqlConnectionManager` - VBScript: SWbemServices	Uma conexão válida com o provedor de SMS.
`name`	-Gerenciado: `String` -Vbscript: `String`	Nome do novo pacote de imagem de inicialização.
`description`	-Gerenciado: `String` -Vbscript: `String`	Descrição do pacote de imagem de inicialização.
`pathToWIM`	-Gerenciado: `Integer` -Vbscript: `Integer`	Caminho UNC para a imagem.

Compilando o código

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

Namespaces

System

System.Collections.Generic

System.Text

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Programação robusta

Para obter mais informações sobre o tratamento de erros, consulte Sobre erros de Configuration Manager.

Segurança do .NET Framework

Para obter mais informações sobre como proteger aplicativos Configuration Manager, consulte Configuration Manager administração baseada em função.

Confira também

Como atribuir um pacote a um ponto de distribuição
Como adicionar um Driver do Windows a um pacote de imagem de inicialização Configuration Manager
Como atribuir um pacote a um ponto de distribuição
Sobre o gerenciamento das imagens

Compartilhar via