Hinzufügen eines Startabbilds aus einer WIM-Datei in Configuration Manager

Artikel
04/04/2023

Sie fügen ein Startimage aus einer Windows-Imagedatei (WIM) zu Configuration Manager hinzu, indem Sie eine Instanz von SMS_BootImagePackage erstellen. Die Eigenschaft ImagePath muss auf den UNC-Pfad (Universal Naming Convention) zur WIM-Datei festgelegt werden. Die Eigenschaft ImageIndex ist der Index für das erforderliche Image in der WIM-Datei.

Wenn das Startimage Windows-Treiber erfordert, geben Sie diese in der ReferencedDrivers -Eigenschaft an, die ein Array von SMS_Driver_Details ist.

Hinweis

Wenn das Startabbild aktualisiert wird, z. B. wenn eine Configuration Manager Binär- oder Startimageeigenschaft geändert wird, muss das Startimage durch Aufrufen der SMS_BootImagePackage Klasse RefreshPkgSource-Methode aktualisiert werden.

So fügen Sie ein Startimage aus einer WIM-Datei hinzu

Richten Sie eine Verbindung mit dem SMS-Anbieter ein. Weitere Informationen finden Sie unter Grundlagen des SMS-Anbieters.
Erstellen Sie eine Instanz von SMS_BootImagePackage.
Legen Sie mindestens die Eigenschaften Name, ImagePath und ImageIndex fest.
Committen Sie die Änderungen.

Beispiel

Die folgende Beispielmethode fügt ein Startimage aus einer WIM-Datei hinzu.

Informationen zum Aufrufen des Beispielcodes finden Sie unter Aufrufen von Configuration Manager Codeausschnitten.

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

Die Beispielmethode verfügt über die folgenden Parameter:

Parameter	Typ	Beschreibung
`connection`	-Verwalteten: `WqlConnectionManager` – VBScript: SWbemServices	Eine gültige Verbindung mit dem SMS-Anbieter.
`name`	-Verwalteten: `String` -Vbscript: `String`	Name für das neue Startabbildpaket.
`description`	-Verwalteten: `String` -Vbscript: `String`	Beschreibung für das Startabbildpaket.
`pathToWIM`	-Verwalteten: `Integer` -Vbscript: `Integer`	UNC-Pfad zum Image.

Kompilieren des Codes

Das C#-Beispiel hat die folgenden Kompilierungsanforderungen:

Namespaces

System

System.Collections.Generic

System.Text

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Robuste Programmierung

Weitere Informationen zur Fehlerbehandlung finden Sie unter Informationen zu Configuration Manager Fehlern.

.NET Framework-Sicherheit

Weitere Informationen zum Schützen Configuration Manager Anwendungen finden Sie unter Configuration Manager rollenbasierte Verwaltung.

Siehe auch

Zuweisen eines Pakets zu einem Verteilungspunkt
Hinzufügen eines Windows-Treibers zu einem Configuration Manager-Startabbildpaket
Zuweisen eines Pakets zu einem Verteilungspunkt
Informationen zur Imageverwaltung

Freigeben über