Microsoft MVP성태의 닷넷 이야기
Windows: 127. Convert-WindowsImage.ps1 사용 방법 정리 [링크 복사], [링크+제목 복사],
조회: 22960
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 
(연관된 글이 1개 있습니다.)

Convert-WindowsImage.ps1 사용 방법 정리

WIM 이미지를 vhd 설치 파일로 변환해주는 PowerShell 스크립트가 있습니다.

Convert-WindowsImage.ps1 - WIM2VHD for Windows 10 (also Windows 8 and 8.1)
; https://gallery.technet.microsoft.com/scriptcenter/Convert-WindowsImageps1-0fe23a8f
; https://www.powershellgallery.com/packages/Convert-WindowsImage/10.0

이 스크립트를 다음과 같은 식으로 그냥 사용하시면 아무 동작도 안 합니다.

PS C:\temp> .\Convert-WindowsImage.ps1 -WIM 'c:\temp\nanoserver\NanoServer.wim' -VHD 'c:\temp\vhd\nanoserver.vhd' -DiskType Fixed -VHDFormat VHD -SizeBytes 10GB -Edition 1

PS C:\temp> 

왜냐하면 Convert-WindowsImage.ps1은 내부에서 Convert-WindowsImage 메서드를 정의만 해두기 때문입니다. 따라서, 다음과 같이 ImportModule을 한 후에 Convert-WindowsImage 메서드를 호출하는 식으로 사용해야 합니다.

Import-Module .\Convert-WindowsImage.ps1

Convert-WindowsImage -WIM 'c:\temp\nanoserver\NanoServer.wim' -VHD 'c:\temp\vhd\nanoserver.vhd' -DiskType Fixed -VHDFormat VHD -SizeBytes 10GB -Edition 1




그런데 다음과 같이 명령을 내려 보면, 웬일인지 예외가 발생합니다.

PS C:\temp> Convert-WindowsImage -WIM 'c:\temp\nanoserver\NanoServer.wim' -VHD 'c:\temp\vhd\nanoserver.vhd' -DiskType Fixed -VHDFormat VHD -SizeBytes 10GB -Edition 1

Windows(R) Image to Virtual Hard Disk Converter for Windows(R) 10
Copyright (C) Microsoft Corporation.  All rights reserved.
Version 10.0.9000.0.amd64fre.fbl_core1_hyp_dev(mikekol).141224-3000 Beta

ERROR  : Cannot convert the "System.String[]" value of type "System.String[]" to type "System.Int32".
INFO   : Log folder is %USERPROFILE%\AppData\Local\Temp\Convert-WindowsImage\6977f150-4e06-4eff-8123-d35b0e37e8e2

INFO   : Closing Windows image...
INFO   : Done.

예외가 발생하는 위치는 Convert-WindowsImage.ps1의 $Edition을 열거하는 코드인데,

$Edition | ForEach-Object -Process {

    $Edition = $PSItem
    
    if ([Int32]::TryParse($Edition, [ref]$null)) {
        $openImage = $openWim[[Int32]$Edition]  // 예외 발생
    } else {
        $openImage = $openWim[$Edition]
    }    

    if ($null -eq $openImage) {
        Write-W2VError "The specified edition does not appear to exist in the specified WIM."
        Write-W2VError "Valid edition names are:"
        $openWim.Images | %{ Write-W2VError "  $($_.ImageFlags)" }
        throw
    }

    ...[생략]...
}

"$Edition = $PSItem" 설정하면서 열거형 변수가 $PSItem으로 겹쳐써져 오류가 발생하는 듯합니다. 그래서 다음과 같이 바꿔주면 정상적으로 동작합니다.

$Edition | ForEach-Object -Process {

    $nEdition = $PSItem
    
    if ([Int32]::TryParse($Edition, [ref]$null)) {
        $openImage = $openWim[[Int32]$nEdition]
    } else {
        $openImage = $openWim[$Edition]
    }    

    if ($null -eq $openImage) {
        Write-W2VError "The specified edition does not appear to exist in the specified WIM."
        Write-W2VError "Valid edition names are:"
        $openWim.Images | %{ Write-W2VError "  $($_.ImageFlags)" }
        throw
    }

    ...[생략]...
}




그 외에, Edition 인자로 숫자(인덱스) 말고 이름을 주는 방법이 있습니다. 이를 위해 WIM 파일에 포함된 Edition 이름을 알아야 하는데, 이는 imagex.exe를 이용해 나열할 수 있습니다.

C:\Program Files (x86)\Windows Kits\10\Tools\bin\i386>imagex /info e:\temp\NanoServer\NanoServer.wim

ImageX Tool for Windows
Copyright (C) Microsoft Corp. All rights reserved.
Version: 6.1.7600.16385

WIM Information:
----------------
Path:        e:\temp\NanoServer\NanoServer.wim
GUID:        {371880ba-0afa-4c84-a233-f1ba2d142e09}
Image Count: 2
Compression: LZX
Part Number: 1/1
Attributes:  0x8
             Relative path junction


Available Image Choices:
------------------------
<WIM>
  <TOTALBYTES>172753493</TOTALBYTES>
  <IMAGE INDEX="1">
    ...[생략]...
    <WINDOWS>
      <ARCH>9</ARCH>
      <PRODUCTNAME>Microsoft® Windows® Operating System</PRODUCTNAME>
      <EDITIONID>ServerStandardNano</EDITIONID>
      ...[생략]...
    </WINDOWS>
    <NAME>Windows Server 2016 SERVERSTANDARDNANO</NAME>
  </IMAGE>
  <IMAGE INDEX="2">
    ...[생략]...
    <WINDOWS>
      <ARCH>9</ARCH>
      <PRODUCTNAME>Microsoft® Windows® Operating System</PRODUCTNAME>
      <EDITIONID>ServerDatacenterNano</EDITIONID>
      ...[생략]...
    </WINDOWS>
    <NAME>Windows Server 2016 SERVERDATACENTERNANO</NAME>
  </IMAGE>
</WIM>

따라서 실행은 이렇게 하시면 됩니다.

Convert-WindowsImage -WIM 'e:\temp\nanoserver\NanoServer.wim' -VHD 'e:\temp\vhd\nanoserver.vhd' -DiskType Fixed -VHDFormat VHD -SizeBytes 10GB -Edition "Windows Server 2016 SERVERSTANDARDNANO"




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 7/17/2021]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
14006정성태8/23/2025273Linux: 121. Linux - snap 패키지 관리자로 설치한 소프트웨어의 디렉터리 접근 제한
14005정성태8/21/2025486오류 유형: 982. sudo: unable to load /usr/libexec/sudo/sudoers.so: libssl.so.3: cannot open shared object file: No such file or directory
14004정성태8/21/2025634오류 유형: 981. dotnet 실행 시 No usable version of the libssl was found
14003정성태8/21/2025628닷넷: 2357. C# 14 - (9) 새로운 지시자 추가 (Ignored directives)
14002정성태8/20/20251160오류 유형: 980. C# - appsettings.json 파일의 설정값이 적용 안 된다면?
14001정성태8/19/20251374닷넷: 2356. .NET SDK 10 - 단일 소스 코드 파일을 빌드/실행하는 기능을 "dotnet" 명령어에 추가
14000정성태8/18/20251233오류 유형: 979. ERROR: failed to solve: failed to read dockerfile: open Dockerfile: no such file or directory
13999정성태8/15/20251480닷넷: 2355. C# 14 - (8) null 조건부 연산자 개선 - 대입문에도 사용 가능파일 다운로드1
13998정성태8/14/20251333닷넷: 2354. C# 14 - (7) 확장 메서드에 정적 메서드와 속성 지원을 위한 전용 구문 추가파일 다운로드1
13997정성태8/14/20251431Linux: 120. docker 컨테이너로 매핑된 볼륨에 컨테이너 측의 사용자 ID를 유지하면서 복사하는 방법
13996정성태8/13/2025991오류 유형: 978. Unable to find the requested .Net Framework Data Provider.
13995정성태8/13/2025994개발 환경 구성: 754. Visual C++ - 리눅스 빌드를 위한 Ubuntu 18 docker 컨테이너 설정
13994정성태8/12/2025961오류 유형: 977. SQL Server - User, group, or role '...' already exists in the current database. (Microsoft SQL Server, Error: 15023)
13993정성태8/11/20251515오류 유형: 976. Microsoft.ML.OnnxRuntimeGenAI 패키지 사용 시 "cublasLt64_12.dll" which is missing. (Error 126: "The specified module could not be found.") 오류
13992정성태8/11/20251660닷넷: 2353. C# - Foundry Local을 이용한 gpt-oss-20b 모델 사용파일 다운로드1
13991정성태8/9/20251481오류 유형: 975. winget - Foundry Local 패키지 업데이트가 안 되는 문제
13990정성태8/8/20251123Windows: 283. Time zone 설정이 없는 Windows Server 2025
13989정성태8/8/20251619닷넷: 2352. C# - Windows S-mode 환경인지 체크하는 방법파일 다운로드1
13988정성태8/8/20251731오류 유형: 974. 비주얼 스튜디오 업데이트 시 잠김 파일 경고 - Visual Studio Standard Collector Service 150 (VSStandardCollectorService150)
13987정성태8/7/20251392닷넷: 2351. C# 14 - (6) event와 생성자에도 partial 메서드 적용파일 다운로드1
13986정성태8/6/20251400닷넷: 2350. C# 14 - (5) 람다 매개 변수에 접근자가 있는 경우에도 타입 생략 가능파일 다운로드1
13985정성태8/6/20251950오류 유형: 973. "wsl --install" 명령어 수행 시 "The server name or address could not be resolved"
13984정성태8/6/20251663Windows: 282. 윈도우 운영체제에 추가된 ssh 서버(Win32-OpenSSH)
13983정성태8/4/20251933오류 유형: 972. Microsoft.Data.SqlClient 6.1.0 버전부터 .NET 8 이상만 지원
13982정성태8/2/20252116개발 환경 구성: 753. CentOS 7 컨테이너 내에서 openssh 서버 호스팅
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...