如何在 Configuration Manager 中從 WIM 檔案新增開機映射

發行項
04/04/2023

您可以藉由建立 SMS_BootImagePackage 的實例，從 Windows 映像 (WIM) 檔案將開機映射新增至Configuration Manager。 ImagePath 屬性必須設定為通用命名慣例 (UNC) WIM 檔案的路徑。 ImageIndex 屬性是 WIM 檔案內所需映射的索引。

如果開機映射需要 Windows 驅動程式，您可以在屬性中 ReferencedDrivers 指定它們，也就是 SMS_Driver_Details陣列。

注意事項

例如，更新開機映射時，當Configuration Manager二進位或開機映射屬性變更時，必須呼叫SMS_BootImagePackage類別RefreshPkgSource方法來更新開機映射。

從 WIM 檔案新增開機映射

設定與 SMS 提供者的連線。如需詳細資訊，請參閱 SMS 提供者基本概念。
建立 SMS_BootImagePackage 的實例。
至少設定 Name、ImagePath 和 ImageIndex 屬性。
認可變更。

範例

下列範例方法會從 WIM 檔案新增開機映射。

如需呼叫範例程式碼的相關資訊，請參閱呼叫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;  
    }  
}

範例方法具有下列參數：

參數	Type	描述
`connection`	-管理： `WqlConnectionManager` - VBScript： SWbemServices	SMS 提供者的有效連線。
`name`	-管理： `String` - VBScript： `String`	新開機映射套件的名稱。
`description`	-管理： `String` - VBScript： `String`	開機映射套件的描述。
`pathToWIM`	-管理： `Integer` - VBScript： `Integer`	影像的 UNC 路徑。

正在編譯程式碼

C# 範例具有下列編譯需求：

命名空間

系統

System.Collections.Generic

System.Text

Microsoft。ConfigurationManagement.ManagementProvider

Microsoft。ConfigurationManagement.ManagementProvider.WqlQueryEngine

組件

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

健全的程式設計

如需錯誤處理的詳細資訊，請參閱關於Configuration Manager錯誤。

.NET Framework 安全性

如需保護Configuration Manager應用程式的詳細資訊，請參閱Configuration Manager角色型系統管理。

另請參閱

如何將套件指派給發佈點
 如何將 Windows 驅動程式新增至Configuration Manager開機映射套件
 如何將套件指派給發佈點
 關於映像管理

共用方式為