MSIXMGR 도구 매개 변수
이 문서에는 MSIXMGR 도구와 함께 사용할 수 있는 명령줄 매개 변수 및 구문이 포함되어 있습니다.
필수 조건
MSIXMGR 도구를 사용하려면 다음이 필요합니다.
- MSIXMGR 도구를 다운로드합니다.
- MSIX 패키지 애플리케이션(
.msix파일)을 가져옵니다. - MSIX 이미지를 만들 수 있는 관리 권한이 있는 Windows 디바이스입니다.
-AddPackage
지정된 파일 경로에 패키지를 추가합니다.
-AddPackage <Path to the MSIX package>
또는
-p <Path to the MSIX package>
다음은 -AddPackage 매개 변수를 사용하는 예제입니다.
msixmgr.exe -AddPackage "C:\MSIX\myapp.msix"
-RemovePackage
지정된 패키지의 전체 이름을 사용하여 패키지를 제거합니다.
-RemovePackage <Package name>
또는
-x <Package name>
다음은 -RemovePackage 매개 변수를 사용하는 예제입니다. PowerShell cmdlet Get-AppxPackage를 실행하여 패키지 전체 이름을 찾을 수 있습니다.
msixmgr.exe -RemovePackage myapp_0.0.0.1_x64__8wekyb3d8bbwe
-FindPackage
특정 패키지 전체 이름을 가진 패키지를 찾습니다.
-FindPackage <Package name>
다음은 -FindPackage 매개 변수를 사용하는 예제입니다. PowerShell cmdlet Get-AppxPackage를 실행하여 패키지 전체 이름을 찾을 수 있습니다.
msixmgr.exe -FindPackage myapp_0.0.0.1_x64__8wekyb3d8bbwe
-ApplyACLs
패키지 폴더(압축되지 않은 패키지)에 ACL을 적용합니다. 또한 다음과 같은 필수 하위 매개 변수를 지정해야 합니다.
| 필수 매개 변수 | 설명 |
|---|---|
-packagePath |
압축을 풀 패키지의 경로 또는 압축을 풀 수 있는 여러 패키지가 포함된 디렉터리의 경로입니다. |
-ApplyACLs -packagePath <Path to the package folder>
다음은 -ApplyACLs 매개 변수를 사용하는 예제입니다.
msixmgr.exe -ApplyACLs -packagePath "C:\MSIX\myapp_0.0.0.1_x64__8wekyb3d8bbwe"
-Unpack
파일 형식 .appx, .msix, .appxbundle, .msixbundle 중 하나로 패키지의 압축을 풀거나 폴더에 압축을 풉니다. 또한 다음과 같은 필수 하위 매개 변수를 지정해야 합니다.
| 필수 매개 변수 | 설명 |
|---|---|
-destination |
결과 패키지 폴더를 배치할 디렉터리입니다. |
-fileType |
패키지 압축을 풀 파일의 형식입니다. 유효한 파일 형식에는 .vhd, .vhdx, .cim이 포함됩니다. 이 매개 변수는 CIM 파일로 압축을 풀 때에만 필요합니다. |
-packagePath |
압축을 풀 패키지의 경로 또는 압축을 풀 수 있는 여러 패키지가 포함된 디렉터리의 경로입니다. |
-rootDirectory |
패키지의 압축을 풀 이미지의 루트 디렉터리를 지정합니다. 이 매개 변수는 새 CIM 파일과 기존 CIM 파일로 압축을 풀 때에만 필요합니다. |
-Unpack -packagePath <Path to package to unpack OR path to a directory containing multiple packages to unpack> -destination <Directory to place the resulting package folder(s) in> -fileType <VHD | VHDX | CIM> -rootDirectory <Root directory on image to unpack packages to>
다음은 -Unpack 매개 변수를 사용하는 몇 가지 예입니다.
패키지 압축을 디렉터리에 풀려면 다음을 수행합니다.
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp"패키지 압축을 VHDX 디스크 이미지로 풀려면 다음을 수행합니다.
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp\myapp.vhdx" -applyACLs -create -filetype VHDX -rootDirectory apps패키지 압축을 CIM 디스크 이미지로 풀려면 다음을 수행합니다.
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp\myapp.cim" -applyACLs -create -filetype CIM -rootDirectory apps
-Unpack 매개 변수와 함께 사용할 수 있는 선택적 매개 변수는 다음과 같습니다.
| 선택적 매개 변수 | 설명 | 예시 |
|---|---|---|
-applyACLs |
결과 패키지 폴더 및 해당 부모 폴더에 ACL을 적용합니다. | msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs |
-create |
지정된 파일 형식의 새 이미지를 만들고 해당 이미지에 패키지의 압축을 풉니다. 필요는 -filetype 매개 변수입니다. |
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType VHDX |
-fileType |
패키지 압축을 풀 파일의 형식입니다. 유효한 파일 형식에는 VHD, VHDX, CIM이 포함됩니다. 이 매개 변수는 CIM 파일로 압축을 풀 때 필요합니다. 필요는 -create 매개 변수입니다. |
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType CIM -rootDirectory apps |
-rootDirectory |
패키지의 압축을 풀 이미지의 루트 디렉터리를 지정합니다. 이 매개 변수는 새 CIM 파일과 기존 CIM 파일로 압축을 풀 때 필요합니다. | msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -filetype CIM -rootDirectory apps |
-validateSignature |
패키지 압축을 풀기 전에 패키지 서명 파일의 유효성을 검사합니다. 이 매개 변수를 사용하려면 패키지의 인증서가 컴퓨터에 설치되어 있어야 합니다. 자세한 내용은 인증서 저장소를 참조하세요. |
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\Myapp" -validateSignature -applyACLs |
-vhdSize |
.vhd 또는 .vhdx 파일의 원하는 크기(MB)입니다. 이는 5MB에서 2040000MB 사이여야 합니다. .vhd 또는 .vhdx 파일에만 사용합니다. -create 및 -filetype 매개 변수가 필요합니다. |
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -create -fileType VHDX -vhdSize 500 |
-MountImage
VHD, VHDX 또는 CIM 이미지를 탑재합니다. 또한 다음과 같은 필수 하위 매개 변수를 지정해야 합니다.
| 필수 매개 변수 | 설명 |
|---|---|
-fileType |
패키지 압축을 풀 파일의 형식입니다. 유효한 파일 형식에는 VHD, VHDX, CIM이 포함됩니다. |
-imagePath |
탑재할 이미지 파일의 경로입니다. |
-MountImage -imagePath <Path to the MSIX image> -fileType <VHD | VHDX | CIM>
다음은 -MountImage 매개 변수를 사용하는 예제입니다.
msixmgr.exe -MountImage -imagePath "C:\MSIX\myapp.cim" -fileType CIM
-MountImage 매개 변수와 함께 사용할 수 있는 선택적 매개 변수는 다음과 같습니다.
| 선택적 매개 변수 | 설명 | 예시 |
|---|---|---|
-readOnly |
이미지를 읽기 전용으로 탑재해야 하는지 여부를 나타내는 부울(true 또는 false)입니다. 지정하지 않으면 이미지는 기본적으로 읽기 전용으로 탑재됩니다. | msixmgr.exe -MountImage -imagePath "C:\MSIX\myapp.cim" -filetype CIM -readOnly false |
-UnmountImage
VHD, VHDX 또는 CIM 이미지 탑재를 해제합니다. 또한 다음과 같은 필수 하위 매개 변수를 지정해야 합니다.
| 필수 매개 변수 | 설명 |
|---|---|
-fileType |
패키지 압축을 풀 파일의 형식입니다. 유효한 파일 형식에는 VHD, VHDX, CIM이 포함됩니다. |
-imagePath |
탑재할 이미지 파일의 경로입니다. |
-UnmountImage -imagePath <Path to the MSIX image> -fileType <VHD | VHDX | CIM>
다음은 -UnmountImage 매개 변수를 사용하는 예제입니다.
msixmgr.exe -UnmountImage -imagePath "C:\MSIX\myapp.vhdx" -fileType VHDX
-UnmountImage 매개 변수와 함께 사용할 수 있는 선택적 매개 변수는 다음과 같습니다.
| 선택적 매개 변수 | 설명 | 예시 |
|---|---|---|
-volumeId |
탑재를 해제할 이미지와 연결된 볼륨의 GUID(중괄호 없이 지정됨)입니다. 이 매개 변수는 CIM 파일에 대해서만 선택 사항입니다. PowerShell cmdlet Get-Volume을 실행하여 볼륨 ID를 찾을 수 있습니다. | msixmgr.exe -UnmountImage -volumeId 199a2f93-99a8-11ee-9b0d-4c445b63adac -filetype CIM |
-quietUX
MSIXMGR 도구를 실행할 때 사용자 상호 작용을 표시하지 않습니다. 이 매개 변수는 선택 사항이며 다른 매개 변수와 함께 사용할 수 있습니다.
-quietUX 매개 변수와 함께 -AddPackage 매개 변수를 사용하는 예제는 다음과 같습니다.
msixmgr.exe -AddPackage "C:\MSIX\myapp.msix" -quietUX
다음 단계
MSIX 앱 연결에 대해 자세히 알아보려면 다음 문서를 확인하세요.