DISM 운영 체제 패키지(.cab 또는 .msu) 서비스 Command-Line 옵션

  • 아티클
  • 읽는 데 17분 걸림

Windows 캐비닛(.cab) 또는 Windows 독립 실행형 설치 관리자(.msu) 파일과 함께 DISM을 사용하여 업데이트, 서비스 팩, 언어 팩을 설치하거나 제거하고 Windows 기능을 사용하거나 사용하지 않도록 설정합니다. 기능은 핵심 운영 체제에 대한 선택적 구성 요소입니다.

구문

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

오프라인 이미지에 사용할 수 있는 운영 체제 패키지 서비스 옵션은 다음과 같습니다.

DISM.exe /Image:<path_to_image_directory> [/Get-Packages | /Get-PackageInfo | /Add-Package | /Remove-Package ] [/Get-Features | /Get-FeatureInfo | /Enable-Feature | /Disable-Feature ] [/Cleanup-Image]

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

DISM.exe /Online [/Get-Packages | /Get-PackageInfo | /Add-Package | /Remove-Package ] [/Get-Features | /Get-FeatureInfo | /Enable-Feature | /Disable-Feature ] [/Cleanup-Image]

/Get-Help /?

패키지 서비스 명령줄 옵션 바로 후에 사용할 경우 옵션 및 인수에 대한 정보가 표시됩니다.

이미지를 지정하면 추가 항목을 사용할 수 있습니다.

구문:

Dism /Get-Help

예:

Dism /Image:C:\test\offline /Add-Package /?

Dism /Online /Get-Packages /?

/Get-Packages

이미지의 모든 패키지에 대한 기본 정보를 표시합니다. 또는 /Format:Table 인수를 사용하여 /Format:List 출력을 테이블 또는 목록으로 표시합니다.

구문:

Dism /Get-Packages [/Format:{Table | List}]

예:

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

Dism /Image:C:\test\offline /Get-Packages /Format:Table

Dism /Online /Get-Packages

/Get-PackageInfo

.cab 파일로 제공된 패키지에 대한 자세한 정보를 표시합니다. .cab 파일만 지정할 수 있습니다. 이 명령을 사용하여 .msu 파일에 대한 패키지 정보를 가져올 수 없습니다. /PackagePath:<path_to_package> 는 .cab 파일 또는 폴더를 가리킬 수 있습니다.

옵션을 사용하여 /Get-Packages 이미지에서 패키지의 이름을 찾거나 .cab 파일의 경로를 지정할 수 있습니다. .cab 파일의 경로는 오프라인 이미지에 파일이 설치된 위치가 아니라 패키지의 원래 원본을 가리킵니다.

구문:

Dism /Get-PackageInfo {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}

예:

Dism /Image:C:\test\offline /Get-PackageInfo /PackagePath:C:\packages\package.cab

Dism /Image:C:\test\offline /Get-PackageInfo /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

/Add-Package

이미지에 지정된 .cab 또는 .msu 패키지를 설치합니다. .msu 패키지는 대상 이미지가 오프라인(탑재 또는 적용)된 경우에만 지원됩니다.

하나의 명령줄에서 여러 패키지를 추가할 수 있습니다. 각 패키지의 적용 가능성이 확인됩니다. 패키지를 지정된 이미지에 적용할 수 없는 경우 오류 메시지가 표시됩니다. 각 패키지의 적용 가능성을 확인하지 않고 명령을 처리하려면 /IgnoreCheck 인수를 사용합니다.

구문:

Dism /Add-Package /PackagePath:<path_to_cabfile> [/IgnoreCheck] [/PreventPending]

  • /PackagePath 는 다음을 가리킬 수 있습니다.

    • 단일 .cab 또는 .msu 파일입니다.
    • 확장된 단일 .cab 파일이 들어 있는 폴더입니다.
    • 단일 .msu 파일이 포함된 폴더입니다.
    • 여러 .cab 또는 .msu 파일이 포함된 폴더입니다.

  • /PackagePath가 루트에 .cab 또는 .msu 파일이 포함된 폴더를 가리키는 경우 하위 폴더에서 .cab 및 .msu 파일도 재귀적으로 확인됩니다.

  • 패키지 또는 Windows 이미지에 보류 중인 온라인 작업이 있는 경우 옵션을 사용하여 /PreventPending 패키지 설치를 건너뜁니다.

참고

/Add-Package 은 패키지의 적용 가능성 및 의존성에 대한 전체 검사를 실행하지 않습니다. dependencies가 있는 패키지를 추가하는 경우 패키지를 추가할 때 모든 dependencies가 설치되어 있는지 확인합니다.

예:

Dism /Image:C:\test\offline /LogPath:AddPackage.log /Add-Package /PackagePath:C:\packages\package.msu

Dism /Image:C:\test\offline /Add-Package /PackagePath:C:\packages\package1.cab /PackagePath:C:\packages\package2.cab /IgnoreCheck

Dism /Image:C:\test\offline /Add-Package /PackagePath:C:\test\packages\package.cab /PreventPending

/Remove-Package

이미지에서 지정된 .cab 파일 패키지를 제거합니다. .cab 파일만 지정할 수 있습니다. 이 명령을 사용하여 .msu 파일을 제거할 수 없습니다.

참고

이 명령을 사용하여 오프라인 이미지에서 패키지를 제거해도 이미지 크기는 줄어들지 않습니다.

구문:

/Remove-Package {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}
  • 를 사용하여 /PackagePath 패키지의 원래 원본을 가리키거나, CAB 파일의 경로를 지정하거나, 이미지에 나열된 대로 이름으로 패키지를 지정합니다. 옵션을 /Get-Packages 사용하여 이미지에서 패키지의 이름을 찾습니다.

예:

Dism /Image:C:\test\offline /LogPath:C:\test\RemovePackage.log /Remove-Package /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

Dism /Image:C:\test\offline /LogPath:C:\test\RemovePackage.log /Remove-Package /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0 /PackageName:Microsoft-Windows-MediaPlayer-Package~31bf3856ad364e35~x86~~6.1.6801.0

Dism /Image:C:\test\offline /LogPath:C:\test\RemovePackage.log /Remove-Package /PackagePath:C:\packages\package1.cab /PackagePath:C:\packages\package2.cab

/Get-Features

패키지의 모든 기능(선택적 Windows 기본 기능을 포함하는 운영 체제 구성 요소)에 대한 기본 정보를 표시합니다.

구문:

/Get-Features {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>} [/Format:{Table | List}]
  • /Get-Features 는 이미지 또는 패키지의 원래 원본에 있는 패키지의 이름을 찾습니다. 패키지 이름 또는 경로를 지정하지 않으면 이미지의 모든 기능이 나열됩니다.
  • /PackageName 는 이미지의 패키지입니다. 를 사용하여 이미지에서 패키지 이름을 볼 수 /DISM Get-Packages 있습니다.
  • /PackagePath 는 .cab 파일 또는 폴더를 가리킬 수 있습니다.

또는 /Format:Table 인수를 사용하여 /Format:List 출력을 테이블 또는 목록으로 표시합니다.

예:

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

Dism /Image:C:\test\offline /Get-Features /Format:List

Dism /Image:C:\test\offline /Get-Features /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

Dism /Image:C:\test\offline /Get-Features /PackagePath:C:\packages\package1.cab

/Get-FeatureInfo

기능에 대한 자세한 정보를 표시합니다. /FeatureName을 사용해야 합니다. 옵션을 사용하여 /Get-Features 이미지에서 기능의 이름을 찾을 수 있습니다.

구문:

/Get-FeatureInfo /FeatureName:<name_in_image> [{/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}]

/PackageName 및 /PackagePath 는 선택 사항이며 패키지에서 특정 기능을 찾는 데 사용할 수 있습니다.

예:

Dism /Image:C:\test\offline /Get-FeatureInfo /FeatureName:Hearts

Dism /Image:C:\test\offline /Get-FeatureInfo /FeatureName:Hearts /PackagePath:C:\packages\package.cab

/Enable-Feature

이미지에서 지정된 기능을 사용하거나 업데이트합니다. 옵션을 사용해야 /FeatureName 합니다. 옵션을 /Get-Features 사용하여 이미지에서 기능의 이름을 찾습니다.

구문:

/Enable-Feature /FeatureName:<name_in_image> [/PackageName:<name_in_image>] [/Source: <source>] [/LimitAccess] [/All]

동일한 부모 /FeatureName 패키지를 공유하는 기능에 대해 한 명령줄에서 옵션을 여러 번 지정할 수 있습니다.

패키지가 Windows Foundation 패키지인 경우 옵션을 사용하여 패키지 이름을 지정할 필요가 /PackageName 없습니다. 그렇지 않으면 를 사용하여 /PackageName 기능의 부모 패키지를 지정합니다.

이전에 이미지에서 제거된 기능을 복원하고 사용하도록 설정할 수 있습니다. 인수를 사용하여 /Source 기능을 복원하는 데 필요한 파일의 위치를 지정합니다. 파일 원본은 탑재된 이미지의 Windows 폴더(예: )에서 사용할 수 c:\test\mount\Windows 있습니다. Windows side-by-side 폴더를 파일의 원본으로 사용할 수도 있습니다(예: z:\sources\SxS ).

여러 인수를 지정하면 파일이 발견된 /Source 첫 번째 위치에서 파일이 수집되고 나머지 위치는 무시됩니다. 제거된 기능에 대해 /Source를 지정하지 않으면 레지스트리의 기본 위치가 사용되거나 온라인 이미지의 경우 WU(Windows Update)가 사용됩니다.

  • /LimitAccessDISM이 온라인 이미지에 대해 WU에 연락하지 못하도록 하려면 를 사용합니다.
  • 를 사용하여 /All 지정된 기능의 모든 부모 기능을 사용하도록 설정합니다.

예:

Dism /Online /Enable-Feature /FeatureName:Hearts /All

Dism /Online /Enable-Feature /FeatureName:Calc /Source:c:\test\mount\Windows /LimitAccess

Dism /Image:C:\test\offline /Enable-Feature /FeatureName:Calc /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

/Disable-Feature

이미지에서 지정된 기능을 사용하지 않도록 설정합니다. /FeatureName 옵션을 사용해야 합니다. 옵션을 /Get-Features 사용하여 이미지에서 기능의 이름을 찾습니다.

구문

/Disable-Feature /FeatureName:<name_in_image> [/PackageName:<name_in_image>] [/Remove]

/FeatureName동일한 부모 패키지의 기능에 대해 한 명령줄에서 여러 번 지정할 수 있습니다.

패키지가 Windows Foundation 패키지인 경우 /PackageName 옵션을 사용하여 패키지 이름을 지정할 필요가 없습니다. 그렇지 않으면 를 사용하여 /PackageName 기능의 부모 패키지를 지정합니다.

를 사용하여 /Remove 이미지에서 기능의 매니페스트를 제거하지 않고 기능을 제거합니다. 기능을 사용 하 여 기능 세부 정보를 표시 하는 경우 "제거"로 나열 됩니다 및 복원 하 고 사용 /Get-FeatureInfo 하도록 설정할 수 있습니다 사용 하 여 /Enable-Feature 사용 하 여는 /Source 옵션입니다.

예:

*Dism /Online /Disable-Feature /FeatureName:Hearts

Dism /Image:C:\test\offline /Disable-Feature /FeatureName:Calc /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

/Cleanup-Image

이미지에서 정리 또는 복구 작업을 수행 합니다. /AnalyzeComponentStore및 /ResetBase 는 5.0 위의 Windows 10, Windows 8.1 및 Windows PE 이미지와 함께 사용할 수 있습니다. Windows 10 버전 1607부터를 사용 하 여를 지정할 수는 /Defer/ResetBase 있지만에서를 /Defer 옵션 으로만 사용 해야 합니다 /Defer . 여기서를 DISM /Resetbase 완료 하는 데 30 분 이상이 필요 합니다.

팁

/ResetBase 옵션이 마지막으로 실행 된 시간을 확인 하려면 레지스트리 경로 아래의 LastResetBase_UTC 레지스트리 항목을 확인 합니다 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing .

구문:

/Cleanup-Image {/RevertPendingActions | /SPSuperseded [/HideSP] | /StartComponentCleanup [/ResetBase [/Defer]] | /AnalyzeComponentStore | /CheckHealth | /ScanHealth | /RestoreHealth [/Source: <filepath>] [/LimitAccess]}
매개 변수 설명
/RevertPendingActions 부팅 오류가 발생 하는 경우/RevertPendingActions 옵션을 사용 하 여 시스템을 복구 해 볼 수 있습니다. 작업은 이전 서비스 작업에서 모든 보류 중인 작업을 되돌립니다. 이러한 작업은 부팅 오류의 원인일 수 있습니다. /RevertPendingActions 옵션은 실행 중인 운영 체제 또는 Windows PE 또는 Windows RE (Windows Recovery Environment) 이미지에서 지원 되지 않습니다. 중요:/RevertPendingActions 옵션은 부팅 하지 않은 Windows 이미지의 시스템 복구 시나리오 에서만 사용 해야 합니다.
SPSuperseded 됨 Service Pack 설치 하는 동안 만들어진 모든 백업 파일을 제거 합니다. /HideSP를 사용 하 여 Service Pack 설치 된 업데이트 제어판에 표시 되지 않도록 합니다. /SPSuperseded 작업이 완료 된 후에는 Service Pack를 제거할 수 없습니다.
/Cicers 정리 대체 된 구성 요소를 정리 하 고 구성 요소 저장소 크기를 줄입니다. /ResetBase를 사용 하 여 대체 되는 구성 요소의 기반을 다시 설정 하면 구성 요소 저장소 크기를 더 줄일 수 있습니다. ’/ResetBase 옵션을 사용 하 여/startcomponentcleanup을 실행 한 후 설치 된 Windows 업데이트를 제거할 수 있습니다. /ResetBase를 사용 하 여 장기 실행 정리 작업을 다음 자동 유지 관리로 연기할 수 있습니다.
/AnalyzeComponentStore 구성 요소 저장소의 보고서를 만듭니다. 보고서 및 보고서에 제공 된 정보를 사용 하는 방법에 대 한 자세한 내용은 WinSxS 폴더의 실제 크기 확인을 참조 하세요.
/CheckHealth 오류가 발생 한 프로세스에 의해 이미지가 손상 된 것으로 플래그가 지정 되었는지 여부와 손상이 복구 될 수 있는지 여부를 확인 합니다.
/ScanHealth 구성 요소 저장소 손상에 대 한 이미지를 검색 합니다. 이 작업은 몇 분 정도 걸립니다.
/RestoreHealth 구성 요소 저장소 손상에 대 한 이미지를 검색 한 다음 복구 작업을 자동으로 수행 합니다. 이 작업은 몇 분 정도 걸립니다.
/Source /RestoreHealth와 함께 사용 하 여 탑재 된 이미지의 Windows 디렉터리 경로와 같이 복구에 사용할 수 있는 파일의 알려진 올바른 버전 위치를 지정 합니다.
/LimitAccess DISM에서 온라인 이미지 복구를 위해 Windows 업데이트에 연결 하지 못하도록 합니다.

예:

Dism /Image:C:\test\offline /Cleanup-Image /RevertPendingActions

Dism /Image:C:\test\offline /Cleanup-Image /SPSuperseded /HideSP

Dism /Online /Cleanup-Image /ScanHealth

Dism /Online /Cleanup-Image /RestoreHealth /Source:c:\test\mount\windows /LimitAccess

자세히 알아보려면 Windows 이미지 복구를 참조 하세요.

제한 사항

  • 오프 라인 이미지에 패키지를 설치 하는 경우 “” 보류 중인 온라인 작업으로 인해 패키지 상태가 설치 보류 중입니다. 즉, 이미지가 부팅 되 고 온라인 작업이 처리 될 때 패키지가 설치 됩니다. 후속 작업을 요청 하는 경우에는 이전 보류 중인 온라인 작업이 완료 될 때까지 해당 작업을 처리할 수 없습니다. /PreventPending에서 패키지를 추가 하는 경우 옵션을 사용 /AddPackage 하 여 보류 중인 온라인 작업의 경우 패키지 설치를 건너뛸 수 있습니다.
  • 일부 패키지에는 먼저 다른 패키지를 설치 해야 합니다. 종속성이 충족 된다고 가정할 수 없습니다. 패키지에 종속성 요구 사항이 있는 경우 응답 파일을 사용 하 여 필요한 패키지를 설치 합니다. 응답 파일을 DISM에 전달 하 여 여러 패키지를 올바른 순서로 설치할 수 있습니다. 자세한 내용은 DISM을 사용 하 여 오프 라인으로 패키지 추가 또는 제거를 참조 하세요.
  • 패키지는 명령줄에 나열 된 순서 대로 설치 됩니다.
  • DISM을 사용 하 여 Windows PE 이미지의 선택적 구성 요소를 나열 하는 경우 서비스 작업에 성공한 경우에도 선택적 구성 요소가 보류 중으로 표시 됩니다. 이것은 의도 된 것 이며 추가 작업이 필요 하지 않습니다.

DISM 이란?

DISM 이미지 관리 Command-Line 옵션

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