Bagikan melalui

Referensi XML ResetConfig

  • Artikel

Referensi ini menjelaskan semua elemen XML yang digunakan untuk menulis file ResetConfig.xml, digunakan untuk mengonfigurasi fitur reset tombol Dorong Lingkungan Pemulihan Windows.

ResetConfig XML

Berikut adalah ResetConfig.xml kosong yang bisa Anda gunakan sebagai titik awal:

<?xml version="1.0" encoding="utf-8"?>
<Reset>
 <Run Phase="BasicReset_BeforeImageApply">
   <Path></Path>
   <Duration></Duration>
 </Run>
 <Run Phase="BasicReset_AfterImageApply">
   <Path></Path>
   <Param></Param>
   <Duration></Duration>
 </Run>
 <Run Phase="FactoryReset_AfterDiskFormat">
   <Path></Path>
   <Duration></Duration>
 </Run>
 <Run Phase="FactoryReset_AfterImageApply">
   <Path></Path>
   <Param></Param>
   <Duration></Duration>
 </Run>
 <SystemDisk>
   <MinSize></MinSize>
   <DiskpartScriptPath> </DiskpartScriptPath>
   <OSPartition></OSPartition>
   <RestoreFromIndex></RestoreFromIndex>
   <WindowsREPartition></WindowsREPartition>
   <WindowsREPath></WindowsREPath>
   <Compact></Compact>
 </SystemDisk>
</Reset>

Mengatur ulang

Elemen Reset XML dapat berisi elemen: <Run> dan <SystemDisk>.

jalankan

Elemen <Run> XML digunakan untuk menambahkan skrip kustom ke fitur reset tombol dorong.

Anda dapat menentukan hingga empat Run elemen dalam satu file ResetConfig.xml. Setiap Run elemen harus berisi nilai yang berbeda [ExtPoint] untuk atributnya Phase .

Tabel berikut ini menjelaskan elemen valid yang bisa ditambahkan ke Run elemen :

Elemen Deskripsi

Run Phase="[ExtPoint]""

Setiap Run elemen menentukan titik ekstensibilitas yang akan digunakan, skrip yang dijalankan pada titik ekstensibilitas tersebut, dan perkiraan durasi waktu dalam hitungan menit.

Atribut Phase tersebut diperlukan. Ini hanya menerima nilai berikut untuk [ExtPoint]:

  • BasicReset_BeforeImageApply. Menjalankan program yang ditentukan pada titik ekstensibilitas A.

  • BasicReset_AfterImageApply. Menjalankan program yang ditentukan pada titik ekstensibilitas B

  • FactoryReset_AfterDiskFormat. Menjalankan program yang ditentukan pada titik ekstensibilitas C

  • FactoryReset_AfterImageApply. Menjalankan program yang ditentukan pada titik ekstensibilitas D

Anda dapat menentukan hingga empat Run bagian dalam satu file ResetConfig.xml. Namun, setiap Run bagian harus berisi nilai yang berbeda untuk atribut fase.

Path

Menentukan lokasi skrip untuk bagian tertentu Run .

Jalur harus merupakan jalur relatif skrip dari folder yang berisi ResetConfig.xml (biasanya ini adalah C:\Recovery\OEM).

Duration

Menentukan perkiraan waktu, dalam menit, yang Anda harapkan untuk dijalankan oleh skrip kustom. Perkiraan ini digunakan untuk menampilkan informasi kemajuan di GUI.

Durasi harus berupa bilangan bulat dan harus antara 1 dan 5.

Param

Menentukan parameter baris perintah yang akan digunakan saat Anda menjalankan skrip kustom atau file yang dapat dieksekusi. Nilai diperlakukan sebagai string, dan dapat berisi beberapa parameter.

Param tidak mendukung elemen kosong. Jika skrip Anda tidak memerlukan parameter, maka jangan sertakan elemen ini. Misalnya, lihat Menggunakan ResetConfig.xml nanti dalam topik ini.

SystemDisk

Elemen ini SystemDisk menyesuaikan fungsionalitas pemulihan bare metal. Untuk informasi selengkapnya, lihat Membuat Media untuk Menjalankan fitur Push-Button Reset.

Anda dapat menentukan satu <SystemDisk> bagian. Berikut adalah elemen yang diperlukan dan opsional:

Elemen Deskripsi
MinSize

Wajib diisi. Menentukan ukuran minimum yang diperlukan untuk hard drive utama, dalam megabyte.

Pemulihan bare metal tidak akan dilanjutkan jika disk sistem tidak memenuhi persyaratan ukuran ini.

DiskpartScriptPath

Wajib diisi. Jalur ke skrip Diskpart relatif terhadap C:\Recovery\OEM. Skrip harus mengasumsikan bahwa semua partisi yang ada telah dihapus, dan disk sistem memiliki fokus di Diskpart.

Misalnya, jika skrip pemulihan terletak di C:\Recovery\OEM\Scripts\RecreatePartitions.dps, gunakan nilai \Scripts\RecreatePartitions.dps.

OSPartition

Wajib diisi. Partisi tempat OS harus dipulihkan. ESP atau partisi aktif harus berada di disk yang sama dengan OS.

WindowsREPartition

Wajib diisi. Menentukan partisi tempat gambar boot Windows RE diinstal.

WindowsREPath

Wajib diisi. Menentukan jalur folder tempat gambar boot Winre.wim disalin dan ditahapkan, relatif terhadap akar partisi yang ditentukan dalam WindowsREPartition elemen .

RestoreFromIndex

Pilihan. Indeks gambar dalam install.wim yang akan diterapkan selama pemulihan bare metal. Elemen ini bersifat opsional dan hanya diperlukan pada media pemulihan yang dibuat produsen

Compact

Pilihan. Menentukan apakah gambar pemulihan harus diterapkan dengan pemadatan per file diaktifkan. Elemen ini bersifat opsional dan hanya diperlukan pada media pemulihan yang dibuat produsen.

Compact menerima nilai berikut:

  • True: File yang diterapkan dari gambar dikompresi satu per satu.
  • False (nilai default): Pemadatan tidak digunakan.

RecoveryImagePartition

Pengaturan ini tidak digunakan lagi di Windows 10.

RecoveryImagePath

Pengaturan ini tidak digunakan lagi di Windows 10.

RecoveryImageIndex

Pengaturan ini tidak digunakan lagi di Windows 10.

WIMBoot

Pengaturan ini tidak digunakan lagi di Windows 10.

Menggunakan ResetConfig.xml

Jika Anda menggunakan editor teks untuk menulis file .xml, Anda harus menyimpan dokumen dengan ekstensi nama file .xml, dan menggunakan pengodean UTF-8. Jangan gunakan ANSI atau pengodean lainnya.

File-file ini harus ditempatkan di folder C:\Recovery\OEM sehingga dapat secara otomatis terdeteksi oleh fitur reset tombol Push.

Contoh

Ini adalah contoh kode untuk file ResetConfig.xml.

<?xml version="1.0" encoding="utf-8"?>
<Reset>
 <Run Phase="BasicReset_BeforeImageApply">
   <Path>Fabrikam\CopyFiles.cmd</Path>
   <Duration>2</Duration>
 </Run>
 <Run Phase="BasicReset_AfterImageApply">
   <Path>Fabrikam\InstallDrivers.cmd</Path>
   <Param>/allDrivers</Param>
   <Duration>2</Duration>
 </Run>
 <Run Phase="FactoryReset_AfterDiskFormat">
   <Path>Fabrikam\FixPartitions.exe</Path>
   <Duration>2</Duration>
 </Run>
 <Run Phase="FactoryReset_AfterImageApply">
   <Path>Fabrikam\InstallDrivers.cmd</Path>
   <Param>/allDrivers</Param>
   <Duration>2</Duration>
 </Run>
 <SystemDisk>
   <MinSize>75000</MinSize>
   <DiskpartScriptPath>Fabrikam\CreatePartition.txt </DiskpartScriptPath>
   <OSPartition>4</OSPartition>
   <RestoreFromIndex>2</RestoreFromIndex>
   <WindowsREPartition>1</WindowsREPartition>
   <WindowsREPath>Recovery\WindowsRE</WindowsREPath>
   <Compact>False</Compact>
 </SystemDisk>
</Reset>

Gambaran Umum Pengaturan Ulang Tombol Pendorongan

Membuat Media untuk Menjalankan Fitur Reset Push-Button