共用方式為


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

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

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

注意事項

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

從 WIM 檔案新增開機映像

  1. 設定與SMS提供者的連線。 如需詳細資訊,請 參閱SMS提供者基本概念

  2. 建立 SMS_BootImagePackage的實例。

  3. 至少設定 Name、ImagePath 和 ImageIndex 屬性。

  4. 認可變更。

範例

下列範例方法會從 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 開機映射套件如何將套件指派給發佈點關於映像管理