Herramienta OA 3.0: sintaxis de línea de comandos y archivo de configuración

La herramienta OA 3.0 es una herramienta de línea de comandos que admite el montaje, la generación de informes y la devolución de un identificador único para los equipos de la planta de fábrica. Puede ejecutar la herramienta OA 3.0 de dos maneras:

• Mediante el modo de auditoría en el equipo cliente totalmente ensamblado. Para obtener más información acerca de cómo ejecutar la herramienta OA 3.0 en modo auditoría, consulte la Información general del modo auditoría en Windows ADK.

• Mediante el uso del modo OOBE en el equipo cliente totalmente ensamblado. Cuando aparezca el primer mensaje en OOBE, presione Mayús + F10 para abrir un símbolo del sistema de administrador y ejecutar la herramienta OA3.0, y luego apague la máquina. La experiencia OOBE del usuario final debe ser coherente con la ejecución de la herramienta OA en modo auditoría y no desviarse del estándar.

Opción	Descripción
/Assemble	Recupera una clave de producto que tiene el estado Cumplido de la base de datos de la fábrica y luego ensambla el archivo OA3.bin y el archivo OA3.xml para un ordenador específico. Después del ensamblado, la herramienta de inyección de firmware proporcionada por OEM puede insertar el archivo OA3.bin en el firmware del equipo. Ejemplo: OA3Tool.exe /Assemble /Configfile=C:\OA3\OA3.cfg
/Report	Crea el valor hash de hardware para un equipo específico, asocia el valor con el identificador de clave de producto y, a continuación, envía el archivo OA3.xml al servidor de informes en la planta de fábrica. Esta opción de línea de comandos se usa generalmente en la planta de fábrica después de insertar la clave de producto en el nuevo ordenador. Importante Al usar la opción de línea de comandos /informar junto con un adaptador de red inalámbrico interno, debe ejecutar el sistema operativo completo. No puede usar Windows PE. Además, si ejecuta la opción /informar sin conexión de servidor, el informe resultante se guarda en la misma ubicación que el archivo OA3.xml que especifica el archivo de configuración. El archivo de informe se enviará al servidor de informes en la planta de fábrica la próxima vez que ejecute la opción /informar cuando el ordenador esté conectado. Ejemplo: OA3Tool.exe /Report /Configfile=C:\OA30\OA3.cfg Si la máquina no tiene ninguna clave de producto en el firmware, puede ejecutar /report /NoKeyCheck para generar un hash de hardware para la validación sin conexión. Pero se producirá un error en el envío de CBR si falta una clave de producto en el firmware. Ejemplo: OA3Tool.exe /Report /Configfile=C:\OA30\OA3.cfg /NoKeyCheck
/Devolver	Devuelve una clave de producto existente para la conciliación. Por ejemplo, puede usar esta opción si reemplaza una asociación de hardware insertada previamente por una nueva asociación para el mismo ordenador. Esta opción de línea de comandos se usa generalmente después de generar el informe de compilación del ordenador. No se admite en MDOS. Ejemplo: OA3Tool.exe /Return /Configfile=C:\OA30\OA3.cfg
/LogTrace=<OA3_log_file>	Registra los datos de seguimiento de diagnóstico de generación de hash de hardware de OA 3.0 en un archivo especificado en <OA3_log_file>. La ruta debe ser válida para que OA3Tool.exe pueda escribir. Se recomienda encarecidamente a los socios que utilicen este modificador cuando prueben los informes CBR de OA 3.0 y la tolerancia al hash del hardware. Ejemplo: OA3Tool.exe /Report /Configfile=C:\OA30\OA3.cfg /LogTrace=C:\OA30\OA3.log
/CheckEdition	Realiza una comprobación cruzada entre la clave de producto insertada y el sistema operativo de destino para la coincidencia de edición. Dos modos son posibles: Comprobación sin conexión en Windows PE. Debe usar /ImageDrive=<image_drive_letter> para especificar la letra de unidad donde se aplica la imagen. Antes de usar este modificador en Windows PE, asegúrese de que la versión más reciente de DISM.exe y todos los archivos de toda la carpeta DISM (aproximadamente de 7 a 9 MB) de Windows ADK más reciente deben copiarse en la misma carpeta donde reside Windows 10 OA3Tool.exe. Comprobación en línea del sistema operativo completo. En este caso, se debe especificar el modo /online. No se requiere información de letras de unidad. Este modificador solo está disponible si el sistema operativo de destino es el cliente de Windows 10.
/Configfile=<configfile_location>	Especifica la ubicación y el nombre del archivo de configuración, que contiene la ubicación del servidor del proveedor de claves; ubicaciones de rutas de archivos para archivos de registro, códigos de error y mensajes; y la ubicación de los directorios temporales necesarios para ensamblar la clave del producto en formatos binario y XML.
/DecodeHwHash	Se utiliza para decodificar el hash de hardware en un formato xml legible por humanos. /DecodeHwHash acepta una cadena (por ejemplo, si se almacena en una base de datos o se envía por correo electrónico) o una ruta de archivo al archivo XML completo generado en la etapa /Report. Ejemplo: OA3Tool /decodeHwhash=<Hardware Hash string>
/Validate	Realiza una pasada de validación para garantizar que la tabla MSDM exista, que el encabezado de la tabla MSDM incluya todos los campos obligatorios y que las entradas de la tabla MSDM existan y se ajusten a los formatos correctos. Ejemplo: OA3Tool.exe /Validate
/ValidateSMBIOS	Los valores TotalPhysicalRAM y PrimaryDiskTypeCapacity se obtienen de las estructuras SMBIOS del dispositivo. Es responsabilidad de los OEM inicializar adecuadamente estas estructuras. Para validar que estas estructuras estén inicializadas correctamente, OA3Tool RS3 o versión superior tiene una nueva opción /ValidateSMBIOS que itera sobre las tablas SMBIOS y garantiza que se inicialicen correctamente con respecto a estos dos atributos. Dos modos son posibles: Comprobación en línea del sistema operativo completo. Debe usar /ValidateSMBIOS sin el parámetro. Comprobación sin conexión en la tabla SMBIOS. El contenido de esta tabla se puede recopilar mediante el archivo de salida /Logtrace desde el comando /report. Hay un atributo (SMBIOSRawData) que contiene el contenido de la tabla SMBIOS. Este valor debe pasarse a la opción /ValidateSMBIOS para validar que el contenido es correcto. Ejemplo: OA3Tool.exe /Logtrace=trace.txt /Report /ConfigFile=<OA3 Config file> En trace.txt, extraiga el valor del atributo SMBIOSRawData OA3Toool.exe /ValidateSMBIOS = <SMBIOSRawData value>
/ValidateHwHash	Se utiliza para validar el elemento hash de hardware codificado en base64 con los criterios de calidad predefinidos para campos críticos e importantes. Los campos críticos son necesarios para que funcione la función Autopilot, mientras que los campos importantes se utilizan para calcular los honorarios de licencia de regalías. Esta función solo está disponible en la versión 18950 o posterior de la herramienta OA 3.0. La opción /ValidateHwHash acepta una cadena (si se almacena en una base de datos o se envía por correo electrónico, por ejemplo) o una ruta de acceso de archivo al archivo XML completo generado en la fase /Report. Ejemplo: OA3Tool.exe /ValidateHwhash=<Hardware Hash string>|<report_file.xml> Los campos críticos son: DiskSerialNumber TpmVersion EkPubHash MacAddress ProductKeyId SmbiosSystemFamily SmbiosSystemManufacturer SmbiosSystemProductName SmbiosSystemSerialNumber SmbiosUuid Los campos importantes son: ChassisTypes DigitalerSupportID DiskType DisplayResolution DisplaySize InternalDiskCount OsBuild OsCpuArchitecture OSType ProcessorCores ProcessorModel TotalDiskCapacity TotalPhysicalRAM

Nota:

La opción /ValidateHwash comprueba si hay errores, espacios en blanco o valores NULL en cualquiera de los campos del hash de hardware descodificado. Los campos adicionales que se van a comprobar se encuentran en la tabla siguiente.

Campo	Salida
Tipo de SO	La salida debe ser “FullOS”. Si el campo está vacío o representa "WinPE", no se utilizó un arranque completo del sistema operativo al crear el hash de hardware.
RAM física total	La salida debe representar la RAM en el dispositivo. (es decir, 4, 8, 16, etc.). Si el campo está vacío o "0", 65535, la RAM no se capturó correctamente.
Capacidad total del disco principal	La salida debe representar el disco principal en el dispositivo. (es decir, 128, 256, 1024, etc.)
Resolución de pantalla y tamaño de pantalla física	La salida debe representar la resolución de visualización interna y el tamaño físico. Si el campo es "0", el dispositivo debe tener un monitor externo, por ejemplo, como con un escritorio.
Campos SMBIOS	La salida no debe contener datos, estar en blanco o contener una cadena predeterminada, como "Para ser completado por O.E.M"
MacAddress	La salida no debe representar datos, en blanco, 00:00:00:00:00:00 o FF:FF:FF:FF:FF:FF:FF
ChassisTypes	La salida debe seguir la regla en la especificación de referencia de SMBIOS.