DISM 앱 패키지 (.appx 또는 .appxbundle) 서비스 Command-Line 옵션

앱 패키지 서비스 명령을 사용 하 여 Windows 이미지에서 프로 비전 된 앱 패키지 (.appx 또는 .appxbundle)를 추가, 제거 및 나열할 수 있습니다. .Appxbundle는 지정 된 PC의 디스크 공간을 최소화 하면서 앱 환경을 보강 하는 데 함께 사용 되는 앱 및 리소스 패키지의 컬렉션입니다. .appxbundle 패키지 및 Microsoft Store 파이프라인에 대 한 자세한 내용은 앱 패키징을 참조 하세요. DISM을 사용 하 여 번들을 프로 비전 하면 .appxbundle 내에 있는 패키지의 하위 집합만 이미지에 추가 될 수 있습니다. 자세한 내용은 DISM이 이미지에 .Appxbundle 리소스 패키지를 추가 하는 방법 이해를 참조 하세요.

프로 비전 된 앱 패키지는 Windows 이미지에 추가 된 후 다음에 사용자가 로그온 할 때 모든 신규 또는 기존 사용자 프로필에 대해 설치 됩니다. 앱 패키지 프로 비전 요구 사항을 비롯 한 자세한 내용은 DISM을 사용 하 여 앱 테스트용으로 로드을 참조 하세요.

또한 PowerShell을 사용 하 여 Windows 설치에서 이미지 당 또는 사용자별로 앱 패키지 (.appx 또는 .appxbundle)를 추가, 제거 및 나열할 수 있습니다. 자세한 내용은 Windows PowerShell의 DISM (배포 이미지 서비스 관리) cmdlet 및 Windows PowerShell의 앱 설치 cmdlet을 참조 하세요.

DISM 서비스 구문

DISM을 사용 하 여 Windows 이미지를 서비스 하는 기본 구문은 다음과 같습니다.

DISM.exe {/Image:<path_to_image_directory>|/Online} [dism_global_options] {servicing_option} <servicing_argument>]

오프 라인 이미지에 대 한 옵션

오프 라인 이미지에 사용할 수 있는 앱 패키지 (.appx 또는 .appxbundle) 서비스 옵션은 다음과 같습니다.

DISM.exe /Image:<path_to_image_directory> [/Get-ProvisionedAppxPackages | /Add-ProvisionedAppxPackage | /Remove-ProvisionedAppxPackage | /Set-ProvisionedAppxDataFile | /StubPackageOption]

온라인 이미지에 대 한 옵션

실행 중인 운영 체제에 사용할 수 있는 앱 패키지 (.appx 또는 .appxbundle) 서비스 옵션은 다음과 같습니다.

DISM.exe /Online [/Get-ProvisionedAppxPackages | /Add-ProvisionedAppxPackage | /Remove-ProvisionedAppxPackage | /Set-ProvisionedAppxDataFile | /StubPackageOption]

/Get-Help /?

응용 프로그램 패키지 서비스 명령줄 옵션 바로 뒤에 사용 하는 경우 옵션 및 인수에 대 한 정보가 표시 됩니다. 이미지를 지정 하면 추가 항목이 사용 가능 해질 수 있습니다.

Dism /image:C:\test\offline /Add-ProvisionedAppxPackage /?

Dism /online /Get-ProvisionedAppxPackages /?

/Get-ProvisionedAppxPackages

각 새 사용자에 대해 설치 하도록 설정 된 이미지의 앱 패키지 (.appx 또는 .appxbundle)에 대 한 정보를 표시 합니다.

Dism /Image:C:\test\offline /Get-ProvisionedAppxPackages

/Add-ProvisionedAppxPackage

하나 이상의 앱 패키지를 이미지에 추가 합니다.

앱이 Windows 이미지에 추가 되 고 다음에 사용자가 로그인 할 때 각 기존 또는 새 사용자 프로필에 대해 등록 됩니다. 앱이 온라인 이미지에 추가 되는 경우 다음 번에 사용자가 로그인 할 때까지 현재 사용자에 대해 앱이 등록 되지 않습니다.

성공적인 설치를 위해 앱이 실행 되지 않도록 하는 동시에 정확히 동일한 파일 (디스크 공간 사용 최소화)을 포함 하는 앱에 대해 적절 한 하드 링크를 만들 수 있도록 감사 모드의 온라인 운영 체제에서 앱을 프로 비전 합니다.

구문:

dism.exe /Add-ProvisionedAppxPackage {/FolderPath:<App_folder_path> [/SkipLicense\] [/CustomDataPath:<custom_file_path>]  /PackagePath:<main_package_path> [/DependencyPackagePath:<dependency_package_path>] {[/LicenseFile:<license_file_path>] [/SkipLicense\]} [/CustomDataPath:<custom_file_path>]} [/Region:<region>]

• 를 사용 /FolderPath 하 여 주 패키지, 종속성 패키지 및 라이선스 파일이 포함 된 압축을 푼 응용 프로그램 파일의 폴더를 지정 합니다. 압축을 푼 앱 패키지에 대해서만 지원 됩니다.

• /PackagePath앱 패키지 (.appx 또는 .appxbundle)를 지정 하는 데 사용 합니다. Lob ( /PackagePath 기간 업무) 앱을 온라인으로 프로 비전 할 때를 사용할 수 있습니다.

  중요

  /PackagePath매개 변수를 사용 하 여 .appxbundle 패키지를 프로 비전 합니다. 또한 종속성 패키지는로 프로 비전 될 수 없으며 /PackagePath , /DependencyPackagePath 앱에 대 한 매개 변수로 프로 비전 되어야 합니다.

• /PackagePath는 WinPE (Windows 사전 설치 환경) 4.0, Windows Server 2008 R2 또는 이전 버전의 Windows를 실행 하는 호스트 PC에서 지원 되지 않습니다.

• /Region앱 패키지 (.appx 또는 .appxbundle)를 프로 비전 해야 하는 지역을 지정 하는 데 사용 합니다. Region 인수는 다음 중 하나일 수 있습니다.

  • all앱을 모든 지역에 대해 프로 비전 해야 함을 나타내는
  • 세미콜론으로 구분 된 지역 목록입니다. 지역은 iso 3166-1 알파-2 또는 iso 3166-1 alpha-3 코드형식입니다. 예를 들어 미국는 "US" 또는 "USA" (대/소문자 구분 안 함)로 지정할 수 있습니다. 영역 목록을 지정 하지 않으면 패키지는 시작 레이아웃에 고정 되어 있는 경우에만 프로 비전 됩니다.

• /DependencyPackagePath를 사용 하 여 앱을 프로 비전 하는 데 필요한 각 종속성 패키지를 지정 합니다. 앱의 필수 종속성 패키지는 <PackageDependency> 앱의 .appx 패키지 루트에 있는 AppxManifest.xml의 요소를 살펴보면 찾을 수 있습니다. 여러 앱이 모두 동일한 종속성을 공유 하는 경우 종속성 패키지의 각 주 버전에 대 한 최신 부 버전이 설치 되어야 합니다. 예를 들어 App1, App2 및 App3은 모두 Microsoft .NET Framework에 대 한 종속성을 갖습니다. App1은 부 버전 25512.0을 사용 하 여 App2을 지정 하 고, App3은 부 버전 25513.0을 지정 하 고,은 부 버전 24202.0를 사용 하 여를 지정 합니다. App1 및 App2 모두 종속성 25513.0 패키지의 주 버전을 동일 하 게 지정 하므로, App3는 종속성 패키지의 다른 주 버전을 지정 하는 반면,이 경우에도 설치 해야 합니다. 따라서 설치 해야 하는 종속성 패키지는 Microsoft. NET.TCP. 1.6.1.6. 버전 25513.0 및 부 버전 24202.0을 포함 하는 Microsoft .net framework.

  패키지에 아키텍처와 관련 된 종속성이 있는 경우 대상 이미지에 대 한 종속성에 대해 적용 가능한 모든 아키텍처를 설치 해야 합니다. 예를 들어 x64 대상 이미지에서 x86 및 x64 종속성 패키지에 대 한 경로를 포함 하거나 압축을 푼 응용 프로그램 파일의 폴더에 둘 다 포함 합니다. ARM 종속성 패키지도 지정 하거나 포함 하는 경우 DISM은 대상 x64 이미지에 적용 되지 않으므로 무시 합니다.

  컴퓨터 아키텍처	설치할 종속성:
  X64	x64 및 x86
  x86	x86
  ARM	ARM만

• /CustomDataPath를 사용 하 여 앱에 대 한 선택적 사용자 지정 데이터 파일을 지정 합니다. 모든 파일 이름을 지정할 수 있습니다. 이 파일은 이미지에 추가 될 때 사용자 지정. dat로 이름이 변경 됩니다.

• /LicensePath옵션과 함께 사용 /PackagePath 하 여 응용 프로그램 라이선스를 포함 하는 .xml 파일의 위치를 지정 합니다.

• 테스트용 로드를 사용 하는 /SkipLicense 컴퓨터에 대 한 라이선스가 필요 하지 않은 앱 에서만 사용 합니다. /SkipLicense다른 시나리오에서는를 사용 하 여 이미지를 손상 시킬 수 있습니다.

예:

Dism /Image:C:\test\offline /Add-ProvisionedAppxPackage /FolderPath:c:\Test\Apps\MyUnpackedApp /CustomDataPath:c:\Test\Apps\CustomData.xml

Dism /Online /Add-ProvisionedAppxPackage /PackagePath:C:\Test\Apps\MyPackedApp\MainPackage.appx /DependencyPackagePath:C:\Test\Apps\MyPackedApp\Framework-x86.appx /DependencyPackagePath:C:\Test\Apps\MyPackedApp\Framework-x64.appx /LicensePath:C:\Test\Apps\MyLicense.xml

Dism /Online /Add-ProvisionedAppxPackage /FolderPath:C:\Test\Apps\MyUnpackedApp /SkipLicense

Dism /Image:C:\test\offline /Add-ProvisionedAppxPackage /PackagePath:C:\Test\Apps\MyPackedApp\MainPackage.appxbundle /SkipLicense

Dism /Online /Add-ProvisionedAppxPackage /PackagePath:C:\Test\Apps\MyPackedApp\MainPackage.appxbundle /Region:"all"

Dism /Online /Add-ProvisionedAppxPackage /PackagePath:C:\Test\Apps\MyPackedApp\MainPackage.appxbundle /Region:"US;GB"

/Remove-ProvisionedAppxPackage

이미지에서 앱 패키지 (.appx 또는 .appxbundle)의 프로 비전을 제거 합니다. 앱 패키지는 생성 된 새 사용자 계정에 등록 되지 않습니다.

구문:

/Remove-ProvisionedAppxPackage /PackageName:<PackageName>

중요

이 옵션은 사용자 프로필에 등록 되어 있는 경우에만 패키지의 프로 비전을 제거 합니다. PowerShell에서 add-appxpackage cmdlet을 사용 하 여 이미지에서 앱을 완전히 제거 하기 위해 이미 등록 된 각 사용자에 대 한 앱을 제거 합니다. 앱이 사용자 프로필에 등록 되지 않은 경우이 /Remove-ProvisionedAppxPackage 옵션은 패키지를 완전히 제거 합니다. 데스크톱 환경이 설치 된 Windows Server 2012 이상 이미지에서 앱 패키지를 제거 하려면 데스크톱 경험을 제거 하기 전에 앱 패키지를 제거 해야 합니다. 데스크톱 환경은 /Remove-ProvisionedAppxPackage Windows server의 server Core 설치 옵션에 대 한 요구 사항입니다.

예:

Dism /Image:C:\test\offline /Remove-ProvisionedAppxPackage /PackageName:microsoft.devx.appx.app1_1.0.0.0_neutral_ac4zc6fex2zjp

/Optimize-ProvisionedAppxPackages

하드 링크를 사용 하 여 동일한 파일을 바꿔 이미지에서 프로 비전 된 패키지의 총 파일 크기를 최적화 합니다. 프로 비전 된 AppX 패키지가 있는 이미지가 온라인 상태 이면에서 /optimize-provisionedappxpackages 프로 비전 된 appx 패키지를 최적화할 수 없습니다. 이미지를 오프 라인으로 전환 하 고 패키지를 추가 하는 경우 이미지를 오프 라인으로 전환한 후 프로 비전 된 패키지만 최적화 됩니다.

이 명령은 온라인 이미지에 대해 지원 되지 않습니다.

DISM.exe /Image:C:\test\offline /Optimize-ProvisionedAppxPackages

/Set-ProvisionedAppxDataFile

지정 된 앱 패키지 (.appx 또는 .appxbundle)에 사용자 지정 데이터 파일을 추가 합니다.

구문

/Set-ProvisionedAppxDataFile [/CustomDataPath<custom_file_path>] /PackageName<PackageName>

이 옵션을 사용 하 여 사용자 지정 데이터 파일을 추가 하기 전에는 지정 된 앱 (.appx 또는 .appxbundle) 패키지를 이미지에 이미 추가 해야 합니다. 또한 옵션을 사용 하는 경우 사용자 지정 데이터 파일을 추가할 수 있습니다 /Add-ProvisionedAppxPackage .

• /CustomDataPath를 사용 하 여 앱에 대 한 선택적 사용자 지정 데이터 파일을 지정 합니다. 모든 파일 이름을 지정할 수 있습니다. 이 파일은 이미지에 추가 될 때 사용자 지정. dat로 이름이 변경 됩니다. 사용자 지정 .dat 파일이 이미 있는 경우 덮어씁니다.

• /Packagename 을 사용 하 여 앱 패키지 (.appx 또는 .appxbundle)를 지정 합니다.

예:

DISM.exe /Image:C:\test\offline /Set-ProvisionedAppxDataFile /CustomDataPath:c:\Test\Apps\Custom.dat /PackageName:microsoft.appx.app1_1.0.0.0_neutral_ac4zc6fex2zjp

/StubPackageOption

패키지의 스텁 기본 설정을 지정 하는 앱 패키지 서비스 옵션과 함께 사용 됩니다.

구문:

/StubPackageOption:{installstub | installfull}

• InstallStub 프로 비전 패키지를 스텁 버전으로 설정 합니다. 스텁 기본 설정을 스텁으로 암시적으로 설정합니다.
• InstallFull은 프로비전 패키지를 전체 버전 프로비전으로 설정합니다. 스텁 기본 설정을 full로 암시적으로 설정합니다.

프로비전된 패키지 버전보다 스텁 패키지 옵션이 지정되지 않은 경우 미리 정의된 스텁 기본 설정으로 설정됩니다.

예:

Dism /image:C:\test\offline /add-provisionedappxpackage /packagepath:"C:\dism\stub\appwithresources.appxbundle" /stubpackageoption:installstub

DISM이 이미지에 .appxbundle 리소스 패키지를 추가하는 방법 이해

.appxbundle이 이미지에 추가되면 번들 내의 모든 리소스 패키지를 적용할 수 없습니다. 예를 들어 스페인어(스페인) 기본 언어를 사용하여 앱이 Windows 이미지에 추가되는 경우 프랑스어(프랑스) 리소스는 포함되지 않아야 합니다. 이미지에 추가되는 리소스를 확인하기 위해 패키지 적용 가능성은 다음을 사용하여 결정됩니다.

• 언어 리소스 팩:운영 체제 언어가 없으면 해당 앱 언어 리소스 팩이 추가되지 않습니다. 예를 들어 영어(미국)를 기본 언어로 Windows 10 스페인어(스페인) 언어 팩이 포함된 이미지가 있을 수 있습니다. 영어(미국) 및 스페인어(스페인) 앱 리소스 팩이 이미지에 추가됩니다. 프랑스어(프랑스) 리소스 팩(또는 다른 언어)을 앱 번들에서 사용할 수 있는 경우 추가되지 않습니다.

• 크기 조정 및 DirectX(DXFL) 리소스 팩:DXFL(크기 조정 및 DirectX) 리소스 팩은 Windows 디바이스의 하드웨어 구성에 따라 달라집니다. DISM 명령이 실행될 때 대상 하드웨어 유형을 ’ 알 수 없으므로 프로비전 시 모든 규모 및 DXFL 리소스 패키지가 이미지에 추가됩니다. 크기 조정 리소스를 사용하여 앱을 개발하는 데 대한 자세한 내용은 픽셀 밀도(Microsoft Store 앱)로 크기 조정 지침을 참조하세요.

여러 언어 팩이 포함된 이미지의 경우 앱 리소스 패키지가 각 언어의 이미지에 추가됩니다. 첫 번째 사용자가 배포된 이미지를 사용하여 PC에 로그인하고 사용자가 OOBE 중에 언어를 선택하면 사용자 프로필 설정과 일치하지 않는 적용할 수 없는 리소스 패키지(언어 리소스 팩, 크기 조정 리소스 팩 및 DXFL 리소스 패키지)가 제거됩니다.

예를 들어 앱은 영어(미국), 프랑스어(프랑스) 및 스페인어(스페인) 언어를 지원할 수 있습니다. 앱이 영어(미국) 및 스페인어(스페인) 언어 팩이 있는 이미지에 추가되면 영어(미국) 및 스페인어(스페인) 리소스 팩만 이미지에 추가됩니다. 그런 다음, 사용자가 처음으로 로그인하고 OOBE 중에 운영 체제 언어로 영어(미국)를 선택하면 로그인이 완료된 후 스페인어(스페인) 리소스 패키지가 제거됩니다.

중요

이미지에서 언어 팩을 추가하거나 제거하는 경우 이미지에 잘못되거나 불완전한 리소스 패키지 집합이 남을 수 있는 적용 가능성 컨텍스트를 변경합니다. 언어 팩이 추가되거나 제거되면 이미지에 모든 .appxbundle 패키지(종속성 패키지 및 Microsoft Store 라이선스 파일 포함)를 다시 한 번 추가해야 합니다. 이렇게 하면 올바른 리소스 패키지 집합이 프로비전됩니다.

제한 사항

• Windows 8 앱을 지원하지 않는 운영 체제에는 앱 패키지(.appx)를 설치할 수 없습니다. Windows 8.1 이상의 ’ 앱을 지원하지 않는 운영 체제에는 앱 번들 패키지(.appxbundle)를 설치할 수 없습니다. 앱은 WinPE 4.0, Windows Server 2012 Server Core 설치 옵션 또는 Windows 8 및 Windows Server 2012 이전 버전의 Windows 지원되지 않습니다.

  Windows Server 2012 앱을 설치하고 실행하려면 데스크톱 환경을 설치해야 합니다.

• /FolderPath 옵션은 .appx 형식을 기반으로 하는 앱 패키지에 대해서만 지원됩니다.

• /PackagePath는 항상 .appxbundle 패키지에 사용해야 합니다.

관련 항목

DISM이란?

DISM 이미지 관리 Command-Line 옵션

DISM(배포 이미지 서비스 및 관리) Command-Line 옵션

DISM을 사용하여 앱을 테스트용으로 로드