Bagikan melalui


Alat OA 3.0: sintaks file baris perintah dan konfigurasi

Alat OA 3.0 adalah alat baris perintah yang mendukung perakitan, pelaporan, dan pengembalian pengidentifikasi unik untuk komputer di lantai pabrik. Anda dapat menjalankan alat OA 3.0 dengan dua cara:

  • Dengan menggunakan mode audit pada komputer klien yang sepenuhnya dirakit. Untuk informasi selengkapnya tentang menjalankan alat OA 3.0 dalam mode audit, lihat Gambaran Umum Mode Audit di Windows ADK.

  • Dengan menggunakan mode OOBE pada komputer klien yang sepenuhnya dirakit. Saat perintah pertama muncul di OOBE, tekan Shift + F10 untuk membuka perintah admin dan menjalankan alat OA3.0, lalu matikan komputer. Pengalaman OOBE pengguna akhir harus konsisten dengan menjalankan alat OA dalam Mode Audit dan tidak menyimpang dari standar.

Opsi Deskripsi
/Merakit Mengambil kunci produk yang memiliki status Terpenuhi dari database lantai pabrik, lalu merakit file OA3.bin dan file OA3.xml untuk komputer tertentu. Setelah perakitan, alat injeksi firmware yang disediakan OEM dapat menyuntikkan file OA3.bin ke dalam firmware komputer.

Contoh:

OA3Tool.exe /Assemble /Configfile=C:\OA3\OA3.cfg
/Laporan Membuat nilai hash perangkat keras untuk komputer tertentu, mengaitkan nilai dengan ID kunci produk, lalu mengirim file OA3.xml ke server pelaporan di lantai pabrik. Opsi baris perintah ini umumnya digunakan di lantai pabrik setelah kunci produk disuntikkan ke komputer baru.

Penting

Saat Anda menggunakan opsi baris perintah /report bersama dengan adaptor jaringan nirkabel internal, Anda harus menjalankan sistem operasi penuh. Anda tidak dapat menggunakan Windows PE. Selain itu, jika Anda menjalankan opsi /report tanpa koneksi server, laporan yang dihasilkan disimpan ke lokasi yang sama dengan file OA3.xml yang ditentukan file konfigurasi Anda. File laporan akan dikirim ke server pelaporan di lantai pabrik saat Anda menjalankan opsi /report saat komputer tersambung.

Contoh:

OA3Tool.exe /Report /Configfile=C:\OA30\OA3.cfg

Jika komputer tidak memiliki kunci produk di firmware, Anda dapat menjalankan /report /NoKeyCheck untuk menghasilkan Hash Perangkat Keras untuk validasi offline. Tetapi pengiriman CBR akan gagal jika kehilangan kunci produk di firmware.

Contoh:

OA3Tool.exe /Report /Configfile=C:\OA30\OA3.cfg /NoKeyCheck
/Kembali Mengembalikan kunci produk yang ada untuk rekonsiliasi. Misalnya, Anda dapat menggunakan opsi ini jika Anda mengganti asosiasi perangkat keras yang disuntikkan sebelumnya dengan asosiasi baru untuk komputer yang sama. Opsi baris perintah ini umumnya digunakan setelah Laporan Build Komputer dibuat. Ini tidak didukung di MDOS.

Contoh:

OA3Tool.exe /Return /Configfile=C:\OA30\OA3.cfg
/LogTrace=<OA3_log_file> Mencatat data pelacakan diagnostik pembuatan hash perangkat keras OA 3.0 ke dalam file yang ditentukan dalam <OA3_log_file>. Jalur harus valid agar OA3Tool.exe menulis. Kami sangat menyarankan mitra menggunakan sakelar ini saat menguji pelaporan OA 3.0 CBR dan toleransi hash perangkat keras.

Contoh:

OA3Tool.exe /Report /Configfile=C:\OA30\OA3.cfg /LogTrace=C:\OA30\OA3.log
/CheckEdition Melakukan pemeriksaan silang antara kunci produk yang disuntikkan dan sistem operasi target untuk kecocokan edisi. Dua mode dimungkinkan:
  1. Pemeriksaan offline di Windows PE. Anda harus menggunakan image_drive_letter> /ImageDrive=<untuk menentukan huruf kandar tempat gambar diterapkan.

    Sebelum Anda menggunakan sakelar ini di Windows PE, pastikan bahwa versi terbaru DISM.exe dan semua file dari seluruh folder DISM (sekitar 7 hingga 9 MB) dari Windows ADK terbaru harus disalin ke folder yang sama tempat Windows 10 OA3Tool.exe berada.
  2. Pemeriksaan online dalam sistem operasi penuh. Dalam hal ini mode /online harus ditentukan. Tidak diperlukan informasi huruf kandar. Sakelar ini hanya tersedia jika sistem operasi target adalah klien Windows 10.
/Configfile=<configfile_location> Menentukan lokasi dan nama file konfigurasi, yang berisi lokasi server penyedia kunci; lokasi jalur file untuk file log, kode kesalahan, dan pesan; dan lokasi direktori sementara yang diperlukan untuk merakit kunci produk ke dalam format biner dan XML.
/DecodeHwHash Digunakan untuk mendekode hash perangkat keras ke dalam format xml yang dapat dibaca manusia. /DecodeHwHash menerima string (misalnya jika disimpan dalam database atau dikirim dalam email) atau jalur file ke file XML lengkap yang dihasilkan pada tahap /Report.

Contoh:

OA3Tool /decodeHwhash=<Hardware Hash string>
/Memvalidasi Melakukan lulus validasi untuk memastikan bahwa tabel MSDM ada, bahwa header tabel MSDM menyertakan semua bidang yang diperlukan, dan bahwa entri tabel MSDM ada dan sesuai dengan format yang benar.

Contoh:

OA3Tool.exe /Validate
/ValidateSMBIOS Nilai TotalPhysicalRAM dan PrimaryDiskTypeCapacity diperoleh dari struktur SMBIOS perangkat. Merupakan tanggung jawab OEM untuk menginisialisasi struktur ini dengan benar. Untuk memvalidasi bahwa struktur ini diinisialisasi dengan benar, OA3Tool RS3 atau versi di atasnya memiliki opsi baru /ValidateSMBIOS yang melakukan iterasi pada tabel SMBIOS dan memastikan bahwa struktur tersebut diinisialisasi dengan benar sehubungan dengan dua atribut ini. Dua mode dimungkinkan:
  1. Pemeriksaan online dalam sistem operasi penuh. Anda harus menggunakan /ValidateSMBIOS tanpa parameter .
  2. Pemeriksaan offline dalam tabel SMBIOS. Konten tabel ini dapat dikumpulkan menggunakan file output /Logtrace dari perintah /report . Ada atribut (SMBIOSRawData) yang berisi konten tabel SMBIOS. Nilai ini kemudian perlu diteruskan ke opsi /ValidateSMBIOS untuk memvalidasi bahwa konten memang benar.

Contoh:
  1. OA3Tool.exe /Logtrace=trace.txt /Report /ConfigFile=<OA3 Config file>
  2. Dari trace.txt ekstrak nilai atribut SMBIOSRawData
  3. OA3Toool.exe /ValidateSMBIOS = <SMBIOSRawData value>
/ValidateHwHash Digunakan untuk memvalidasi elemen hash perangkat keras yang dikodekan base64 dengan kriteria kualitas yang telah ditentukan sebelumnya untuk bidang penting dan penting. Bidang penting diperlukan agar fitur Autopilot berfungsi, sementara bidang penting digunakan untuk menghitung biaya lisensi royalti.

Fungsi ini hanya tersedia pada 18950 atau lebih tinggi versi alat OA 3.0.

Opsi /ValidateHwHash menerima string (jika disimpan dalam database atau dikirim dalam email, misalnya) atau jalur file ke file XML lengkap yang dihasilkan pada tahap /Report.

Contoh:

OA3Tool.exe /ValidateHwhash=<Hardware Hash string>|<report_file.xml>

Bidang penting adalah:
DiskSerialNumber
TpmVersion
EkPubHash
MacAddress
ProductKeyId
SmbiosSystemFamily SmbiosSystemManufacturer
SmbiosSystemProductName
SmbiosSystemSerialNumber
SmbiosUuid

Bidang pentingnya adalah:
ChassisTypes
DigitizerSupportID
DiskType
DisplayResolution
DisplaySize
InternalDiskCount
OsBuild
OsCpuArchitecture
OSType
ProcessorCores
ProcessorModel
TotalDiskCapacity
TotalPhysicalRAM

Catatan

Opsi /ValidateHwash memeriksa kesalahan, kosong, atau nilai null apa pun di salah satu bidang Hash Perangkat Keras yang didekodekan. Bidang tambahan untuk diperiksa ada dalam tabel berikut.

Bidang Hasil
Jenis OS Output harus "FullOS". Jika bidang kosong atau mewakili "WinPE", boot lengkap OS tidak digunakan saat membuat Hash Perangkat Keras.
Total RAM Fisik Output harus mewakili RAM di perangkat. (yaitu 4, 8, 16, dll.). Jika bidang kosong atau "0", 65535, RAM tidak ditangkap dengan benar.
Kapasitas Total Disk Primer Output harus mewakili Disk Utama di perangkat. (yaitu 128, 256, 1024, dll.)
Resolusi Tampilan dan Ukuran Tampilan Fisik Output harus mewakili resolusi tampilan internal dan ukuran fisik. Jika bidang adalah "0", perangkat harus memiliki monitor eksternal, misalnya, seperti halnya desktop.
Bidang SMBIOS Output tidak boleh berisi data, kosong, atau berisi string default, seperti "Untuk diisi oleh O.E.M"
MacAddress Output tidak boleh mewakili data, kosong, 00:00:00:00:00:00 atau FF:FF:FF:FF:FF:FF:FF:FF
ChassisTypes Output harus mengikuti aturan dalam Spesifikasi Referensi SMBIOS .