Ferramenta OA 3.0: sintaxe de arquivo de configuração e linha de comando

A ferramenta OA 3.0 é uma ferramenta de linha de comando que dá suporte à montagem, a relatórios e ao retorno de um identificador exclusivo para os computadores na fábrica. Você pode executar a ferramenta OA 3.0 de duas maneiras:

• Usando o modo de auditoria no computador cliente totalmente montado. Para obter mais informações sobre como executar a ferramenta OA 3.0 no modo de auditoria, confira Visão geral do modo de auditoria no ADK do Windows.

• Usando o modo OOBE no computador cliente totalmente montado. Quando o primeiro prompt aparecer no OOBE, pressione Shift + F10 para abrir um prompt de comando de administrador e executar a ferramenta OA3.0 e, em seguida, desligue o computador. A experiência OOBE do usuário final deve ser consistente com a execução da ferramenta OA no Modo de Auditoria e não desviar-se do padrão.

Opção	Descrição
/Assemble	Recupera uma chave do produto que tem um estado de Fulfilled do banco de dados de chão de fábrica e, em seguida, monta o arquivo OA3.bin e o arquivo OA3.xml para um computador específico. Após o assembly, a ferramenta de injeção de firmware fornecida pelo OEM pode injetar o arquivo OA3.bin no firmware do computador. Exemplo: OA3Tool.exe /Assemble /Configfile=C:\OA3\OA3.cfg
/Report	Cria o valor de hash de hardware para um computador específico, associa o valor à ID da chave do produto e envia o arquivo OA3.xml para o servidor de relatórios na fábrica. Essa opção de linha de comando geralmente é usada na fábrica depois que a chave do produto (Product Key) é injetada no novo computador. Importante Ao usar a opção /report da linha de comando junto com um adaptador de rede sem fio interno, você deve executar o sistema operacional completo. Você não pode usar o Windows PE. Além disso, se você executar a opção /report sem uma conexão de servidor, o relatório resultante será salvo no mesmo local que o arquivo OA3.xml especificado pelo arquivo de configuração. O arquivo de relatório será enviado ao servidor de relatórios na fábrica na próxima vez que você executar a opção /report quando o computador estiver conectado. Exemplo: OA3Tool.exe /Report /Configfile=C:\OA30\OA3.cfg Se o computador não tiver uma chave do produto (Product Key) no firmware, você poderá executar /report /NoKeyCheck para gerar um Hash de Hardware para a validação offline. No entanto, o envio do CBR falhará se não houver uma chave do produto (Product Key) no firmware. Exemplo: OA3Tool.exe /Report /Configfile=C:\OA30\OA3.cfg /NoKeyCheck
/Return	Retorna uma chave do produto (Product Key) existente para reconciliação. Por exemplo, você poderá usar essa opção se substituir uma associação de hardware injetada anteriormente por uma nova associação para o mesmo computador. Essa opção de linha de comando geralmente é usada depois que o Relatório de Build do Computador é gerado. Não há suporte para ela no MDOS. Exemplo: OA3Tool.exe /Return /Configfile=C:\OA30\OA3.cfg
/LogTrace=<OA3_log_file>	Registra dados de rastreamento de diagnóstico de geração de hash de hardware do OA 3.0 em um arquivo especificado em <OA3_log_file>. O caminho deve ser válido para o OA3Tool.exe gravar. É altamente recomendável que os parceiros usem essa opção ao testar relatórios CBR do OA 3.0 e tolerância a hash de hardware. Exemplo: OA3Tool.exe /Report /Configfile=C:\OA30\OA3.cfg /LogTrace=C:\OA30\OA3.log
/CheckEdition	Executa uma verificação cruzada entre a chave do produto injetada e o sistema operacional de destino para correspondência de edição. Dois modos são possíveis: Verificação offline no Windows PE. Você deve usar /ImageDrive=<image_drive_letter> para especificar a letra da unidade em que a imagem é aplicada. Antes de usar essa opção no Windows PE, verifique se a versão mais recente do DISM.exe e todos os arquivos de toda a pasta DISM (aproximadamente 7 a 9 MB) do ADK mais recente do Windows devem ser copiados para a mesma pasta em que reside o OA3Tool.exe do Windows 10. Verificação online no sistema operacional completo. Nesse caso, o modo /online deve ser especificado. Nenhuma informação de letra da unidade é necessária. Essa opção só estará disponível se o sistema operacional de destino for o cliente Windows 10.
/Configfile=<configfile_location>	Especifica o local e o nome do arquivo de configuração, que contém o local do servidor do provedor de chaves; locais do caminho do arquivo para arquivos de log, códigos de erro e mensagens; e o local dos diretórios temporários necessários para montar a chave do produto em formatos binários e XML.
/DecodeHwHash	Usado para decodificar o hash de hardware em um formato XML legível por humanos. O /DecodeHwHash aceita uma cadeia de caracteres (por exemplo, se ela for armazenada em um banco de dados ou enviada por email) ou um caminho de arquivo para o arquivo XML completo gerado no estágio /Report. Exemplo: OA3Tool /decodeHwhash=<Hardware Hash string>
/Validate	Executa um passe de validação para garantir que a tabela MSDM exista, que o cabeçalho da tabela MSDM inclua todos os campos necessários e que as entradas da tabela MSDM existam e estejam em conformidade com os formatos corretos. Exemplo: OA3Tool.exe /Validate
/ValidateSMBIOS	Os valores TotalPhysicalRAM e PrimaryDiskTypeCapacity são obtidos das estruturas SMBIOS do dispositivo. É responsabilidade dos OEMs inicializar corretamente essas estruturas. Para validar se essas estruturas são inicializadas corretamente, o OA3Tool RS3 ou versão superior tem uma nova opção /ValidateSMBIOS que itera sobre as tabelas SMBIOS e garante que elas sejam inicializadas corretamente em relação a esses dois atributos. Dois modos são possíveis: Verificação online no sistema operacional completo. Você deve usar /ValidateSMBIOS sem o parâmetro. Verificação offline na tabela SMBIOS. O conteúdo desta tabela pode ser coletado usando o arquivo de saída /Logtrace do comando /report. Há um atributo (SMBIOSRawData) que contém o conteúdo da tabela SMBIOS. Em seguida, esse valor precisa ser passado para a opção /ValidateSMBIOS para validar se o conteúdo está realmente correto. Exemplo: OA3Tool.exe /Logtrace=trace.txt /Report /ConfigFile=<OA3 Config file> De trace.txt, extraia o valor do atributo SMBIOSRawData OA3Toool.exe /ValidateSMBIOS = <SMBIOSRawData value>
/ValidateHwHash	Usado para validar o elemento hash de hardware codificado em base64 com os critérios de qualidade predefinidos para campos críticos e importantes. Campos críticos são necessários para que o recurso do Autopilot funcione, enquanto campos importantes são usados para calcular a taxa de licença de royalties. Essa função só está disponível na versão 18950 ou versão posterior à ferramenta OA 3.0. A opção /ValidateHwHash aceita uma cadeia de caracteres (se ela for armazenada em um banco de dados ou enviada por email, por exemplo) ou um caminho de arquivo para o arquivo XML completo gerado no estágio /Report. Exemplo: OA3Tool.exe /ValidateHwhash=<Hardware Hash string>|<report_file.xml> Os campos importantes são: DiskSerialNumber TpmVersion EkPubHash MacAddress ProductKeyId SmbiosSystemFamily SmbiosSystemManufacturer SmbiosSystemProductName SmbiosSystemSerialNumber SmbiosUuid Os campos importantes são: ChassisTypes DigitizerSupportID DiskType DisplayResolution DisplaySize InternalDiskCount OsBuild OsCpuArchitecture OSType ProcessorCores ProcessorModel TotalDiskCapacity TotalPhysicalRAM

Observação

A opção /ValidateHwash verifica se há erros, espaços em branco ou valores nulos em qualquer um dos campos do Hash de Hardware decodificado. Campos adicionais a serem verificados estão na tabela a seguir.

Campo	Saída
Tipo de sistema operacional	A saída deve ser "FullOS". Se o campo estiver vazio ou representar "WinPE", uma inicialização completa do sistema operacional não foi utilizada ao criar o Hash de Hardware.
Total de RAM física	A saída deve representar a RAM no dispositivo. (ou seja, 4, 8, 16, etc.). Se o campo estiver vazio ou "0", 65535, a RAM não foi capturada corretamente.
Capacidade total do disco primário	A saída deve representar o Disco Primário no dispositivo. (ou seja, 128, 256, 1024, etc.)
Resolução de exibição e tamanho de exibição física	A saída deve representar a resolução de exibição interna e o tamanho físico. Se o campo for "0", o dispositivo deverá ter um monitor externo, por exemplo, como em uma área de trabalho.
Campos SMBIOS	A saída não deve conter dados, ficar em branco ou conter uma cadeia de caracteres padrão, como "A ser preenchido pelo O.E.M."
MacAddress	A saída não deve representar nenhum dado, em branco, 00:00:00:00:00:00 ou FF:FF:FF:FF:FF:FF:FF
ChassisTypes	A saída deve seguir a regra na Especificação de Referência do SMBIOS.