Comment ajouter une image de démarrage à partir d’un fichier WIM dans Configuration Manager

Article
04/04/2023

Vous ajoutez une image de démarrage à partir d’un fichier d’image Windows (WIM) à Configuration Manager en créant une instance de SMS_BootImagePackage. La propriété ImagePath doit être définie sur le chemin d’accès UNC (Universal Naming Convention) au fichier WIM. La propriété ImageIndex est l’index de l’image requise dans le fichier WIM.

Si l’image de démarrage nécessite des pilotes Windows, vous les spécifiez dans la ReferencedDrivers propriété , qui est un tableau de SMS_Driver_Details.

Remarque

Lorsque l’image de démarrage est mise à jour, par exemple, lorsqu’une propriété binaire ou d’image de démarrage Configuration Manager est modifiée, l’image de démarrage doit être mise à jour en appelant la méthode RefreshPkgSource de la classe SMS_BootImagePackage.

Pour ajouter une image de démarrage à partir d’un fichier WIM

Configurez une connexion au fournisseur SMS. Pour plus d’informations, consultez Notions de base du fournisseur SMS.
Créez une instance de SMS_BootImagePackage.
Définissez au moins les propriétés Name, ImagePath et ImageIndex.
Validez les modifications.

Exemple

L’exemple de méthode suivant ajoute une image de démarrage à partir d’un fichier WIM.

Pour plus d’informations sur l’appel de l’exemple de code, consultez Appel d’extraits de code 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;  
    }  
}

L’exemple de méthode a les paramètres suivants :

Paramètre	Type	Description
`connection`	-Géré: `WqlConnectionManager` - VBScript : SWbemServices	Connexion valide au fournisseur SMS.
`name`	-Géré: `String` -Vbscript: `String`	Nom du nouveau package d’image de démarrage.
`description`	-Géré: `String` -Vbscript: `String`	Description du package d’image de démarrage.
`pathToWIM`	-Géré: `Integer` -Vbscript: `Integer`	Chemin d’accès UNC à l’image.

Compilation du code

L’exemple C# présente les exigences de compilation suivantes :

Espaces de noms

Système

System.Collections.Generic

System.Text

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Programmation robuste

Pour plus d’informations sur la gestion des erreurs, consultez À propos des erreurs Configuration Manager.

Sécurité de .NET Framework

Pour plus d’informations sur la sécurisation des applications Configuration Manager, consultez Configuration Manager’administration basée sur les rôles.

Voir aussi

Comment affecter un package à un point de distribution
Comment ajouter un pilote Windows à un package d’image de démarrage Configuration Manager
Comment affecter un package à un point de distribution
À propos de la gestion des images

Partager via