이 문서에는 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"
-풀고
파일 형식, , .msix.appxbundle또는 .msixbundle중 하나로 패키지의 압축을 .appx풀고 해당 내용을 폴더에 추출합니다. 또한 다음과 같은 필수 하위 매개 변수를 지정해야 합니다.
| 필수 매개 변수 | 설명 |
|---|---|
-destination |
결과 패키지 폴더를 배치할 디렉터리입니다. |
-fileType |
패키지의 압축을 풀 파일 형식입니다. 유효한 파일 형식에는 , , 가 .vhdx.cim있습니다.vhd. 이 매개 변수는 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 |
패키지의 압축을 풀 파일 형식입니다. 유효한 파일 형식에는 , , 가 VHDXCIM있습니다VHD. 이 매개 변수는 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 |
또는 .vhdx 파일의 원하는 크기(.vhdMB)입니다. 5MB에서 2040000MB 사이여야 합니다. 또는 .vhdx 파일에만 .vhd 사용합니다. 및 -filetype 매개 변수가 -create 필요합니다. |
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -create -fileType VHDX -vhdSize 500 |
-MountImage
VHD, VHDX 또는 CIM 이미지를 탑재합니다. 또한 다음과 같은 필수 하위 매개 변수를 지정해야 합니다.
| 필수 매개 변수 | 설명 |
|---|---|
-fileType |
패키지의 압축을 풀 파일 형식입니다. 유효한 파일 형식에는 , , 가 VHDXCIM있습니다VHD. |
-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 of false)입니다. 지정하지 않으면 이미지는 기본적으로 읽기 전용으로 탑재됩니다. | msixmgr.exe -MountImage -imagePath "C:\MSIX\myapp.cim" -filetype CIM -readOnly false |
-UnmountImage
VHD, VHDX 또는 CIM 이미지를 분리합니다. 또한 다음과 같은 필수 하위 매개 변수를 지정해야 합니다.
| 필수 매개 변수 | 설명 |
|---|---|
-fileType |
패키지의 압축을 풀 파일 형식입니다. 유효한 파일 형식에는 , , 가 VHDXCIM있습니다VHD. |
-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
다음 단계
App Attach에 대해 자세히 알아보려면 다음 문서를 검사.