유효성 검사 OS 이미지 작성기를 사용하여 OS 사용자 지정 유효성 검사

아티클
05/30/2024

드라이버 패키지 및 유효성 검사 OS 사용자 지정 패키지를 추가하여 유효성 검사 OS가 시나리오에 맞게 앱을 부팅하고 지원할 수 있는지 확인할 수 있습니다. 사용자 지정 패키지를 사용하여 문서의 뒷부분에서 설명하는 여러 주문형 기능에 대한 지원을 추가할 수 있습니다.

유효성 검사 OS는 받은 편지함 드라이버와 함께 제공되지 않으므로 PC에 이미지를 적용하기 전에 드라이버를 추가해야 합니다.

전체 프로세스

유효성 검사 OS 이미지 작성기를 사용하여 유효성 검사 OS 이미지를 만드는 전체 프로세스는 다음과 같습니다.

유효성 검사 OS ISO 파일을 기술자 PC 파일 시스템의 특정 위치에 탑재합니다.
기술자 PC(x64 또는 arm64)의 기본 아키텍처에 따라 적절한 ValidationOSImageBuilder.exe 시작합니다.
유효성 검사 OS ImageBuilder의 단계를 따릅니다.
1. [선택 사항] 생성된 유효성 검사 OS 이미지의 위치를 선택합니다.
2. [선택 사항] 탑재된 유효성 검사 OS 이미지에 드라이버를 추가합니다.
3. [선택 사항] 하나 이상의 원하는 주문형 기능을 추가합니다.
4. [선택 사항] 유효성 검사 OS 이미지에서 레지스트리 키를 설정/재정의합니다.
5. [선택 사항] 유효성 검사 OS 이미지에 사용자 지정 이진 파일/애플리케이션을 포함합니다.
6. [선택 사항] 생성된 유효성 검사 OS 이미지와 일치하는 SDK에 대한 참조를 사용하여 Visual Studio 솔루션을 만듭니다.

유효성 검사 OS 이미지 작성기 시작

유효성 검사 OS Image Builder는 특정 시나리오에 대한 사용자 지정 유효성 검사 OS 이미지를 쉽게 생성할 수 있는 GUI 도구입니다. 추가할 수 있습니다.

오디오, Bluetooth, 카메라, 멀티미디어, USB 등과 같은 선택적 패키지
특정 하드웨어용 드라이버
유효성 검사 OS 이미지에 포함하려는 다른 소프트웨어 애플리케이션
시작할 때 유효성 검사 OS 이미지에서 사용하도록 설정하려는 레지스트리 키
OS 시작 시 실행하려는 시작 명령

또한 생성되는 특정 유효성 검사 OS 이미지에 사용할 수 있는 SDK를 생성할 수 있습니다.

사용 가능한 선택적 featuire 패키지 목록은 다음에서 찾을 수 있습니다. 기능 패키지

유효성 검사 OS 이미지 작성기 사용

다음은 유효성 검사 OS ISO 패키지에서 유효성 검사 OS Image Builder의 기본 흐름에 대한 단계별 사용 가이드입니다.

유효성 검사 OS ISO 패키지를 탑재하고 ISO가 탑재된 드라이브가 있는 <ISO_ROOT>: 폴더로 이동합니다<ISO_ROOT>:\ImageBuilder.
ValidationOSImageBuilder.exe 실행하여 유효성 검사 OS Image Builder를 시작하고 관리이스트레이터 권한으로 프로그램을 실행하라는 메시지가 표시되는 프롬프트를 수락합니다.
"시작"을 클릭하여 기능 화면으로 이동합니다.
기능 화면에서 유효성 검사 OS 이미지에 추가하려는 기능을 선택하고 다음을 클릭하여 드라이버 화면으로 이동합니다(위 섹션의 사용 가능한 기능 목록 참조).
선택적 드라이버 화면에서 디바이스의 드라이버가 있는 폴더를 선택합니다.
이 화면에서는 필요에 따라 이미지에 다음 구성 요소를 추가할 수도 있습니다.
1. 선택적 소프트웨어 폴더: 유효성 검사 OS 이미지에 포함될 선택적 .EXE 파일이 포함된 folderthat을 포함할 수 있습니다.
2. 레지스트리 파일: 이렇게 하면 .를 업로드할 수 있습니다. 부팅 시 유효성 검사 OS 이미지에 포함될 레지스트리 항목을 포함하는 REG 파일
3. 시작 명령: 부팅 시 실행되는 유효성 검사 OS 이미지에 .EXE 파일을 추가할 수 있습니다.
[다음]을 클릭하여 출력 화면으로 이동합니다.
출력 화면에서 다음을 수행할 수 있습니다.
1. 출력 WIM 파일 및 기타 구성 요소가 생성될 폴더를 선택합니다(기본값은 C:\ValidationOS).
2. WIM(유효성 검사 OS 이미지)이 USB 드라이브 또는 하드 드라이브에서 부팅되는지 여부를 지정합니다(기본값: USB).
3. 유효성 검사 OS Image Builder가 생성된 사용자 지정 유효성 검사 OS 이미지에 대해 연결된 SDK를 생성할지 여부를 선택합니다.
4. 나중에 사용할 템플릿 파일에 가장 최근에 사용한 유효성 검사 OS Image Builder 설정을 저장합니다.
[다음]을 클릭하여 마지막으로 선택한 모든 기능, 드라이버 및 출력 설정을 표시하는 검토 및 완료 화면으로 이동합니다.
만들기를 클릭하여 유효성 검사 OS 이미지를 생성합니다.
유효성 검사 OS 이미지가 생성되면 새로 생성된 ValidationOS.wim이 표시되는 출력 폴더로 이동하는 옵션이 표시됩니다.

참고 항목

ValidationOS-2.wim 도 GenImageOutput 폴더에 생성됩니다. 드라이버 화면에서 선택한 부팅 유형과 관련된 파티션만 포함하는 최적화된 이미지입니다.

유효성 검사 OS 이미지 작성기 명령줄 사용

유효성 검사 OS Image Builder GUI에서 사용할 수 있는 모든 기능은 유효성 검사 OS Image Builder 명령줄을 통해서도 사용할 수 있습니다. 유효성 검사 OS Image Builder 명령 ine을 사용하려면 ISO가 탑재된 드라이브가 있는 <ISO_ROOT>: 폴더로 이동합니다<ISO_ROOT>:\IBCLI.

유효성 검사 OS Image Builder 명령줄 유틸리티를 호출 ValidationOSImageBuilderCLI.exe합니다.

다음은 사용 가능한 명령줄 옵션 목록입니다.

-l, --list List all features included in the ISO

-i, --info <info> Get the description of a specific feature

-rp, --resolve <resolve> List all packages included by a set of features

-f, --features <features> Specify features to include

-d, --drivers <drivers> Specify the driver folder path

-s, --software <software> Specify the software folder path

-r, --registry <registry> Specify the registry file path

-sc, --startup-command <startup-command> Specify the startup command file path

-o, --output <output> Specify the output folder path

-sdk, --generate-sdk Generate SDK solution

-st, --save-template Save settings to a template

-g, --generate-image Trigger image generation

-api, --generate-api Generate API Surface from features

-lt, --load-template <load-template> Load a template file

-bt, --boottype <boottype> Specify the boot type (USB/InternalDisk).
        Default is USB

--version Show version information

-?, -h, --help Show help and usage information

명령줄 옵션을 사용하는 방법의 예는 실행할 때 표시됩니다. ValidationOSImageBuilderCLI -h

생성된 SDK 사용

생성된 SDK를 사용하려면 컴퓨터에 Microsoft Visual Studio가 설치되어 있어야 합니다.

탐색기에서 출력 폴더(일반적으로 이름이 지정C:\ValdationOS<Date-Time of image creation>됨)로 이동하면 sdk라는 폴더가 표시됩니다. 이 폴더 안에는 .sln 파일이 표시됩니다. 이 파일을 두 번 클릭하여 Visual Studio에서 엽니다.

Visual Studio의 솔루션 탐색기 보기에는 .cpp 파일이 표시됩니다. 코드를 사용하여 이 파일을 편집하거나 이 프로젝트에 사용자 고유의 코드 파일을 추가할 수 있습니다. 프로젝트 참조 Nuget 패키지를 보려면 솔루션 탐색기 보기에서 참조를 마우스 오른쪽 단추로 클릭하고 Nuget 패키지 관리를 선택할 수 있습니다.

솔루션을 빌드하려면 기본 메뉴에서 빌드를 선택하고 사용자 지정 유효성 검사 OS 이미지에 대해 이 코드에서 .exe 파일을 생성하는 솔루션 빌드를 선택합니다.

apisurface.xml APIValidator 사용

Image Builder는 ValidationOS.wim 이미지와 함께 api 폴더에 apisurface.xml 파일을 생성합니다. 이 파일에는 사용자 지정 ValidationOS.wim 이미지가 지원하는 모든 API 함수의 참조 목록이 포함되어 있습니다.

.exe 파일과 이 apisurface.xml 파일을 입력으로 APIValidator.exe 도구를 사용하여 .exe 파일과 사용자 지정 ValidationOS.wim 이미지 간에 비호환성이 있는지 확인할 수 있습니다.

APIValidator.exe 설치하려면 파일 <ISO_ROOT>:\SDK\ValidationOS_System_Kit-APIValidator_Usage.txt의 지침을 참조하세요. 먼저 WDK를 설치해야 합니다. 설치되면 API 표면 파일에 대해 파일을 분석 .exe 하는 일반적인 명령은 다음과 같습니다.

Apivalidator.exe -BinaryPath:"<Path to .exe file>" -SupportedApiXmlFiles:"<Path to apisurface.xml file>"

출력에 호환되지 않는 종속성의 세부 정보와 함께 오류 목록이 표시됩니다(있는 경우).

유효성 검사 OS Image Builder SDK 샘플

유효성 검사 OS Image Builder와 함께 제공되는 다양한 기능을 사용하는 코드 샘플을 여기에서 볼 수 있습니다. https://github.com/microsoft/validation-OS

다음을 통해 공유