Поделиться через


Средство OA 3.0: синтаксис файла командной строки и конфигурации

Средство OA 3.0 — это средство командной строки, которое поддерживает сборку, отчеты и возврат уникального идентификатора компьютеров на фабрике. Средство OA 3.0 можно запустить двумя способами:

  • С помощью режима аудита на полностью собранном клиентском компьютере. Дополнительные сведения о запуске средства OA 3.0 в режиме аудита см. в разделе "Обзор режима аудита" в Windows ADK.

  • С помощью режима OOBE на полностью собранном клиентском компьютере. Когда первая строка появится в OOBE, нажмите клавиши SHIFT + F10, чтобы открыть командную строку администратора и запустить средство OA3.0, а затем завершить работу компьютера. Интерфейс OOBE пользователя должен быть согласован с запуском средства OA в режиме аудита и не отклоняться от стандартного.

Вариант Описание
/Собрать Извлекает ключ продукта, имеющий состояние "Выполнено" из базы данных уровня фабрики, а затем собирает файл OA3.bin и файл OA3.xml для определенного компьютера. После сборки средство внедрения встроенного ПО oem может внедрить файл OA3.bin в встроенное ПО компьютера.

Пример:

OA3Tool.exe /Assemble /Configfile=C:\OA3\OA3.cfg
/Отчет Создает хэш-значение оборудования для определенного компьютера, связывает значение с идентификатором ключа продукта, а затем отправляет файл OA3.xml на сервер отчетов на фабрике. Этот параметр командной строки обычно используется на фабрике после внедрения ключа продукта на новый компьютер.

Важно!

При использовании параметра командной строки /report вместе с внутренним беспроводным сетевым адаптером необходимо запустить полную операционную систему. Нельзя использовать Windows PE. Кроме того, при запуске параметра /report без подключения к серверу результирующий отчет сохраняется в том же расположении, что и файл OA3.xml, указанный в файле конфигурации. Файл отчета будет отправлен на сервер отчетов на заводской площадке при следующем запуске параметра /report при подключении компьютера.

Пример:

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

Если компьютер не имеет ключа продукта в встроенном ПО, можно запустить /report /NoKeyCheck, чтобы создать хэш оборудования для автономной проверки. Но отправка CBR завершится ошибкой, если отсутствует ключ продукта в встроенном ПО.

Пример:

OA3Tool.exe /Report /Configfile=C:\OA30\OA3.cfg /NoKeyCheck
/Вернуться Возвращает существующий ключ продукта для выверки. Например, этот параметр можно использовать, если вы заменяете ранее внедренное аппаратное сопоставление новым сопоставлением для того же компьютера. Этот параметр командной строки обычно используется после создания отчета сборки компьютера. Он не поддерживается в MDOS.

Пример:

OA3Tool.exe /Return /Configfile=C:\OA30\OA3.cfg
/LogTrace=<OA3_log_file> Записывает данные диагностики диагностики хэша оборудования OA 3.0 в файл, указанный в <OA3_log_file>. Путь должен быть допустимым для записи OA3Tool.exe. Мы настоятельно рекомендуем партнерам использовать этот коммутатор при тестировании отчетов OA 3.0 CBR и аппаратного хэш-отказоустойчивости.

Пример:

OA3Tool.exe /Report /Configfile=C:\OA30\OA3.cfg /LogTrace=C:\OA30\OA3.log
/CheckEdition Выполняет кросс-проверка между внедренным ключом продукта и целевой операционной системой для соответствия выпуска. Возможны два режима:
  1. Автономное проверка в Windows PE. Чтобы указать букву диска, в которой применяется изображение, необходимо использовать /ImageDrive=<image_drive_letter.>

    Прежде чем использовать этот переключатель в Windows PE, убедитесь, что последняя версия DISM.exe и все файлы из всей папки DISM (приблизительно 7–9 МБ) из последней версии Windows ADK должны быть скопированы в ту же папку, где находится Windows 10 OA3Tool.exe.
  2. Проверка в сети в полной операционной системе. В этом случае необходимо указать режим /online . Никаких сведений о букве диска не требуется. Этот параметр доступен только в том случае, если целевая операционная система — клиент Windows 10.
/Configfile=<configfile_location> Указывает расположение и имя файла конфигурации, содержащего расположение сервера поставщика ключей; расположения пути к файлам журнала, кодам ошибок и сообщениям; и расположение временных каталогов, необходимых для сборки ключа продукта в двоичные и XML-форматы.
/DecodeHwHash Используется для декодирование хэша оборудования в xml-формат, доступный для чтения. /DecodeHwHash принимает строку (например, если она хранится в базе данных или отправляется по электронной почте) или путь к полному XML-файлу, созданному на этапе /Report.

Пример:

OA3Tool /decodeHwhash=<Hardware Hash string>
/Проверить Выполняет проверку, чтобы убедиться, что таблица MSDM существует, что заголовок таблицы MSDM включает все обязательные поля и что записи таблицы MSDM существуют и соответствуют правильным форматам.

Пример:

OA3Tool.exe /Validate
/ValidateS МБ IOS Значения TotalPhysicalRAM и PrimaryDiskTypeCapacity получены из структур S МБ IOS устройства. Это ответственность изготовителей оборудования для правильной инициализации этих структур. Чтобы проверить правильность инициализации этих структур, OA3Tool RS3 или более поздней версии имеет новый параметр /ValidateS МБ IOS, который выполняет итерацию по таблицам S МБ IOS и гарантирует правильность их инициализации в отношении этих двух атрибутов. Возможны два режима:
  1. Проверка в сети в полной операционной системе. Необходимо использовать /ValidateS МБ IOS без параметра.
  2. Автономное проверка в таблице S МБ IOS. Содержимое этой таблицы можно собирать с помощью выходного файла /Logtrace из команды /report . Существует атрибут (S МБ IOSRawData), содержащий оглавление таблицы S МБ IOS. Затем это значение необходимо передать в параметр /ValidateS МБ IOS, чтобы убедиться, что содержимое действительно правильно.

Пример:
  1. OA3Tool.exe /Logtrace=trace.txt /Report /ConfigFile=<OA3 Config file>
  2. Из trace.txt извлеките значение атрибута S МБ IOSRawData
  3. OA3Toool.exe /ValidateSMBIOS = <SMBIOSRawData value>
/ValidateHwHash Используется для проверки хэш-элемента аппаратного хэша в кодировке Base64 с предопределенными критериями качества для критически важных и важных полей. Критически важные поля необходимы для работы функции Autopilot, в то время как важные поля используются для вычисления платы за лицензию royalty.

Эта функция доступна только в 18950 или более поздней версии средства OA 3.0.

Параметр /ValidateHwHash принимает строку (если она хранится в базе данных или отправляется по электронной почте, например) или путь к полному XML-файлу, созданному на этапе /Report.

Пример:

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

Важные поля:
DiskSerialNumber
TpmVersion
EkPubHash
MacAddress
ProductKeyId
Sm биография sSystemFamily
Sm биография sSystemManufacturer
Sm биография sSystemProductName
Sm биография sSystemSerialNumber
Sm биография sUuid

Важные поля :
ChassisTypes
DigitizerSupportID
DiskType
DisplayResolution
DisplaySize
InternalDiskCount
OsBuild
OsCpuArchitecture
OSType
ProcessorCores
ProcessorModel
TotalDiskCapacity
TotalPhysicalRAM

Примечание.

Параметр /ValidateHwash проверка для любых ошибок, пустых или пустых значений в любом из полей декодированного хэша оборудования. Дополнительные поля для проверка приведены в следующей таблице.

Поле Выходные данные
Тип ОС Выходные данные должны иметь значение FullOS. Если поле пусто или представляет "WinPE", полная загрузка ОС не использовалась при создании хэша оборудования.
Общая физическая память Выходные данные должны представлять ОЗУ на устройстве. (т. е. 4, 8, 16 и т. д.). Если поле пусто или "0", 65535, ОЗУ не было записано правильно.
Общая емкость основного диска Выходные данные должны представлять основной диск на устройстве. (т. е. 128, 256, 1024 и т. д.)
Разрешение дисплея и размер физического дисплея Выходные данные должны представлять внутреннее разрешение дисплея и физический размер. Если поле равно "0", устройство должно иметь внешний монитор, например рабочий стол.
Поля S МБ IOS Выходные данные не должны содержать данных, быть пустыми или содержать строку по умолчанию, например "Заполнено O.E.M".
MacAddress Выходные данные не должны представлять никаких данных, пустых, 00:00:00:00:00 или FF:FF:FF:FF
ШассиTypes Выходные данные должны соответствовать правилу в спецификации справочника S МБ IOS.