OA 3.0 도구: 명령줄 및 구성 파일 구문

  • 아티클
  • 읽는 데 10분 걸림

OA 3.0 도구는 공장 현장의 컴퓨터에 대한 고유 식별자 어셈블, 보고 및 반환을 지원하는 명령줄 도구입니다. 두 가지 방법으로 OA 3.0 도구를 실행할 수 있습니다.

  • 완전히 어셈블된 클라이언트 컴퓨터에서 감사 모드 사용 감사 모드에서 OA 3.0 도구를 실행하는 자세한 내용은 Windows ADK의 감사 모드 개요를 참조하세요.

  • 완전히 어셈블된 클라이언트 컴퓨터에서 OOBE 모드 사용 OOBE에 첫 번째 프롬프트가 표시되면 Shift + F10 키를 눌러 관리자 명령 프롬프트를 열고 OA3.0 도구를 실행한 다음 컴퓨터를 종료합니다. 최종 사용자 OOBE 환경은 감사 모드에서 OA 도구를 실행하는 것과 일치해야 하며 표준에서 벗어나지 않아야 합니다.

옵션 설명
/Assemble 공장 현장 데이터베이스에서 사용 중 상태인 제품 키를 검색한 다음 특정 컴퓨터에 대한 OA3.bin 파일과 OA3.xml 파일을 어셈블합니다. 어셈블리 후에 OEM 제공 펌웨어 삽입 도구는 OA3.bin 파일을 컴퓨터의 펌웨어에 삽입할 수 있습니다.

예제:

OA3Tool.exe /Assemble /Configfile=C:\OA3\OA3.cfg
/Report 특정 컴퓨터에 대한 하드웨어 해시 값을 만들고, 값을 제품 키 ID와 연결한 다음, 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
/Return 조정을 위해 기존 제품 키를 반환합니다. 예를 들어 이전에 삽입된 하드웨어 연결을 동일한 컴퓨터에 대한 새 연결로 바꾸는 경우 이 옵션을 사용할 수 있습니다. 이 명령줄 옵션은 일반적으로 컴퓨터 빌드 보고서가 생성된 후에 사용됩니다. 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 및 최신 Windows ADK의 전체 DISM 폴더(약 7~9MB)의 모든 파일을 Windows 10 OA3Tool.exe 있는 동일한 폴더에 복사해야 합니다.
  2. 전체 운영 체제에서 온라인 확인 이 경우 /online 모드를 지정해야 합니다. 드라이브 문자 정보는 필요하지 않습니다. 이 스위치는 대상 운영 체제가 클라이언트에 Windows 10 경우에만 사용할 수 있습니다.
/Configfile= configfile_location 키 공급자 서버의 위치를 포함하는 구성 파일의 위치와 이름을 지정합니다. 로그 파일, 오류 코드 및 메시지의 파일 경로 위치 및 제품 키를 이진 및 XML 형식으로 어셈블하는 데 필요한 임시 디렉터리 위치입니다.
/DecodeHwHash 하드웨어 해시를 사람이 읽을 수 있는 xml 형식으로 디코딩하는 데 사용됩니다. /DecodeHwHash는 문자열(예: 데이터베이스에 저장되거나 메일로 전송된 경우) 또는 /Report 단계에서 생성된 전체 XML 파일의 파일 경로를 허용합니다.

예제:

OA3Tool /decodeHwhash=<Hardware Hash string>
/Validate 유효성 검사 통과를 수행하여 MSDM 테이블이 있는지, MSDM 테이블 헤더에 필요한 모든 필드가 포함되는지, MSDM 테이블 항목이 존재하고 올바른 형식을 준수하는지 확인합니다.

예제:

OA3Tool.exe /Validate
/ValidateSMBIOS TotalPhysicalRAM 및 PrimaryDiskTypeCapacity 값은 디바이스의 SMBIOS 구조에서 얻습니다. 이러한 구조를 제대로 초기화하는 것은 OEM의 책임입니다. 이러한 구조체가 제대로 초기화되었는지 확인하기 위해 OA3Tool RS3 이상 버전에는 SMBIOS 테이블을 반복하고 이러한 두 특성과 관련하여 올바르게 초기화되는 /ValidateSMBIOS 옵션이 있습니다. 두 가지 모드가 가능합니다.
  1. 전체 운영 체제에서 온라인 확인 매개 변수 없이 /ValidateSMBIOS를 사용해야 합니다.
  2. SMBIOS 테이블의 오프라인 검사 이 테이블의 내용은 /report 명령의 /Logtrace 출력 파일을 사용하여 수집할 수 있습니다. SMBIOS 테이블 내용이 포함된 특성(SMBIOSRawData)이 있습니다. 콘텐츠가 실제로 올바른지 확인하려면 /ValidateSMBIOS 옵션에 이 값을 전달해야 합니다.

예제:
  1. OA3Tool.exe /Logtrace=trace.txt /Report /ConfigFile=<OA3 Config file>
  2. trace.txt SMBIOSRawData 특성 값 추출
  3. OA3Toool.exe /ValidateSMBIOS = <SMBIOSRawData value>
/ValidateHwHash 중요하고 중요한 필드에 대해 미리 정의된 품질 조건을 사용하여 base64로 인코딩된 하드웨어 해시 요소의 유효성을 검사하는 데 사용됩니다. Autopilot 기능이 작동하려면 중요한 필드가 필요하고, 중요한 필드는 사용료를 계산하는 데 사용됩니다.

이 함수는 18950 이상 OA 3.0 도구 버전에서만 사용할 수 있습니다.

/ValidateHwHash 옵션은 문자열(예: 데이터베이스에 저장되거나 메일로 전송된 경우) 또는 /Report 단계에서 생성된 전체 XML 파일의 파일 경로를 허용합니다.

예제:

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

중요한 필드는 DiskSerialNumber
TpmVersion
EkPubHash
MacAddress
ProductKeyId
SmbiosSystemFamily
SmbiosSystemManufacturer
SmbiosSystemProductName
SmbiosSystemSerialNumber
SmbiosUuid입니다.

중요한 필드는 ChassisTypes
DigitizerSupportID
DiskType
DisplayResolution
DisplaySize
InternalDiskCount

OsBuild OsCpuArchitecture
OSType
ProcessorCores
ProcessorModel
TotalDiskCapacity
TotalPhysicalRAM입니다.

참고

/ValidateHwash 옵션은 디코딩된 하드웨어 해시의 필드에 있는 오류, 공백 또는 null 값을 확인합니다. 확인할 추가 필드는 다음 표에 있습니다.

필드 출력
OS 유형 출력은 FullOS 여야 “” 합니다. 필드가 비어 있거나 WinPE를 나타내는 경우 “” 하드웨어 해시를 만들 때 OS의 전체 부팅이 활용되지 않았습니다.
총 실제 RAM 출력은 디바이스의 RAM을 나타내야 합니다. (예: 4, 8, 16 등). 필드가 비어 있거나 “ 0 ” , 65535이면 RAM이 올바르게 캡처되지 않았습니다.
주 디스크 총 용량 출력은 디바이스의 기본 디스크를 나타내야 합니다. (예: 128, 256, 1024 등)
디스플레이 해상도 및 실제 디스플레이 크기 출력은 내부 디스플레이 해상도 및 실제 크기를 나타내야 합니다. 필드가 “ 0이면 ” 데스크톱과 마찬가지로 디바이스에 외부 모니터가 있어야 합니다.
SMBIOS 필드 출력은 데이터를 포함하지 않거나, 비어 있거나, O.E.M으로 채워지는 것과 같은 기본 문자열을 포함해서는 안 “ 됩니다.”
MacAddress 출력은 데이터 없음, 공백, 00:00:00:00:00:00 또는 FF: FF: FF: FF: FF: FF를 나타내지 않아야 합니다.
ChassisTypes 출력은 SMBIOS 참조 사양의 규칙을 따라야 합니다.