您可以藉由建立 SMS_BootImagePackage 的實例,將開機映射從 Windows 映像 (WIM) 檔案新增至 Configuration Manager。 ImagePath 屬性必須設定為 WIM 檔案的通用命名約定 (UNC) 路徑。 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 開機映射套件如何將套件指派給發佈點關於映像管理