다음을 통해 공유


WinGet 도구를 사용하여 애플리케이션 설치 및 관리

WinGet 명령줄 도구를 사용하면 사용자가 Windows 10 및 Windows 11 컴퓨터에서 애플리케이션을 검색, 설치, 업그레이드, 제거 및 구성할 수 있습니다. 이 도구는 Windows 패키지 관리자 서비스에 대한 클라이언트 인터페이스입니다.

WinGet 설치

Windows 패키지 관리자 WinGet 명령줄 도구는 Windows 11 및 최신 버전의 Windows 10에서 앱 설치 관리자의 일부로 사용할 수 있습니다.

Microsoft Store에서 앱 설치 관리자를 다운로드할 수 있습니다. 이미 설치된 경우 최신 버전으로 업데이트되었는지 확인합니다.

참고 항목

현재 WinGet 명령줄 도구는 Windows 10 1709(빌드 16299) 이상에서만 지원됩니다. WinGet 도구는 Windows에 처음으로 사용자로 로그인하여 Microsoft Store가 Windows 패키지 관리자를 비동기 프로세스의 일부로 등록할 때까지 사용할 수 없습니다. 최근에 처음으로 사용자로 로그인했는데 아직 WinGet을 사용할 수 없는 경우 PowerShell을 열고 다음 명령을 입력하여 이 WinGet 등록을 요청할 수 있습니다. Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.

WinGet 미리 보기 버전 설치 [개발자 전용]

WinGet은 Windows 앱 설치 관리자에 포함되어 있습니다. 최신 Windows 패키지 관리자 기능을 사용해 보려면 다음 방법 중 하나로 미리 보기 빌드를 설치할 수 있습니다.

  • 최신 WinGet 미리 보기 버전을 다운로드합니다. 새로운 기능에 대해 알아보려면 WinGet 미리 보기 릴리스 정보를 참조하세요. 이 패키지를 설치하면 WinGet 클라이언트의 미리 보기 버전이 제공되지만 Microsoft Store에서 새 미리 보기 버전의 자동 업데이트가 사용하도록 설정되지는 않습니다.

  • MSA(Microsoft 계정), 회사, 학교 또는 AAD(Azure Active Directory) 계정을 사용하여 Windows 참가자 개발자 채널에 등록합니다. Windows 참가자 개발자 채널에는 Microsoft Store의 새로운 미리 보기 버전에 대한 자동 업데이트가 포함되어 있습니다.

  • MSA(Microsoft 계정)를 사용하여 Windows 패키지 관리자 참가자 프로그램에 등록합니다. MSA(Microsoft 계정)가 추가되면(이메일 알림을 받은 지 며칠 후) Microsoft Store에서 새 미리 보기 버전의 자동 업데이트를 받게 됩니다.

Windows 샌드박스에 WinGet 설치

Windows 샌드박스는 애플리케이션을 독립적으로 안전하게 실행할 수 있는 가벼운 데스크톱 환경을 제공합니다. Windows 샌드박스 환경 내부에 설치된 소프트웨어는 "샌드박스" 상태로 유지되며 호스트 시스템과 별도로 실행됩니다. Windows 샌드박스에는 WinGet이나 Microsoft Store 앱이 포함되어 있지 않으므로 GitHub의 WinGet 릴리스 페이지에서 최신 WinGet 패키지를 다운로드해야 합니다.

Windows 샌드박스에 안정적인 WinGet 릴리스를 설치하려면 Windows PowerShell 명령 프롬프트에서 다음 단계를 따릅니다.

$progressPreference = 'silentlyContinue'
Write-Information "Downloading WinGet and its dependencies..."
Invoke-WebRequest -Uri https://aka.ms/getwinget -OutFile Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle
Invoke-WebRequest -Uri https://aka.ms/Microsoft.VCLibs.x64.14.00.Desktop.appx -OutFile Microsoft.VCLibs.x64.14.00.Desktop.appx
Invoke-WebRequest -Uri https://github.com/microsoft/microsoft-ui-xaml/releases/download/v2.8.6/Microsoft.UI.Xaml.2.8.x64.appx -OutFile Microsoft.UI.Xaml.2.8.x64.appx
Add-AppxPackage Microsoft.VCLibs.x64.14.00.Desktop.appx
Add-AppxPackage Microsoft.UI.Xaml.2.8.x64.appx
Add-AppxPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle

패키지 관리자의 미리 보기나 다른 버전을 보려면 https://github.com/microsoft/winget-cli/releases로 이동합니다. 원하는 버전의 URL을 복사하고 위의 URI를 업데이트합니다.

샌드박스 설치 방법 및 샌드박스 사용법을 포함하여 Windows 샌드박스에 대한 자세한 내용은 Windows 샌드박스 문서를 참조하세요.

관리자 고려 사항

관리자 권한으로 WinGet을 실행하는지 여부에 따라 설치 관리자의 동작이 달라질 수 있습니다.

  • 관리자 권한 없이 WinGet을 실행하는 경우 일부 애플리케이션을 설치하려면 권한 상승이 필요할 수 있습니다. 설치 관리자가 실행되면 Windows에서 권한 상승을 요구하는 메시지가 표시됩니다. 권한 상승을 선택하지 않으면 애플리케이션이 설치되지 않습니다.

  • 관리자 명령 프롬프트에서 WinGet을 실행할 때 애플리케이션에서 요구하는 경우 권한 상승 메시지가 표시되지 않습니다. 관리자 권한으로 명령 프롬프트를 실행할 때는 항상 주의해야 하며 신뢰할 수 있는 애플리케이션만 설치합니다.

WinGet 사용

앱 설치 관리자가 설치되면 명령 프롬프트에서 'WinGet'을 입력하여 WinGet을 실행할 수 있습니다.

가장 일반적인 사용 시나리오 중 하나는 즐겨찾는 도구를 검색하여 설치하는 것입니다.

  1. 도구를 검색하려면 winget search <appname>을 입력합니다.

  2. 원하는 도구를 사용할 수 있다고 확인되었으면 winget install <appname>을 입력하여 도구를 설치할 수 있습니다. WinGet 도구에서 설치 관리자를 시작하여 애플리케이션을 PC에 설치합니다. winget 명령줄

  3. WinGet은 설치 및 검색 외에도 애플리케이션에 대한 세부 정보 표시, 원본 변경패키지 유효성 검사를 수행할 수 있는 여러 가지 다른 명령을 제공합니다. 전체 명령 목록을 가져오려면 winget --help를 입력합니다. winget 도움말

일부 사용자가 PATH에 클라이언트가 없는 문제를 보고했습니다.

명령

WinGet 도구의 현재 미리 보기에서 지원하는 명령은 다음과 같습니다.

Command 설명
info 시스템에 대한 메타데이터(버전 번호, 아키텍처, 로그 위치 등)를 표시합니다. 문제 해결에 유용합니다.
install 지정된 애플리케이션을 설치합니다.
show 지정된 애플리케이션에 대한 세부 정보를 표시합니다.
source WinGet 도구에서 액세스하는 Windows 패키지 관리자 리포지토리를 추가, 제거 및 업데이트합니다.
search 애플리케이션을 검색합니다.
목록 설치된 패키지를 표시합니다.
Upgrade(업그레이드) 지정된 패키지를 업그레이드합니다.
uninstall 지정된 패키지를 제거합니다.
hash 설치 관리자에 대한 SHA256 해시를 생성합니다.
validate Windows 패키지 관리자 리포지토리에 제출할 매니페스트 파일의 유효성을 검사합니다.
설정 설정을 엽니다.
features 실험적 기능의 상태를 표시합니다.
export 설치된 패키지 목록을 내보냅니다.
import 파일에 모든 패키지를 설치합니다.
pin 패키지 핀을 관리합니다.
configure 시스템을 원하는 상태로 구성합니다.
download 지정된 애플리케이션의 설치 관리자를 다운로드합니다.

옵션

WinGet 도구는 다음 옵션을 지원합니다.

옵션 설명
-v, --version 현재 버전의 WinGet을 반환합니다.
--info 라이선스, 개인정보 처리방침 및 구성된 그룹 정책에 대한 링크를 포함하여 WinGet에 대한 모든 세부 정보를 제공합니다.
-?, --help WinGet에 대한 추가 도움말을 표시합니다.

지원되는 설치 관리자 형식

WinGet 도구가 지원하는 설치 관리자 유형은 다음과 같습니다.

  • EXE(SilentSilentWithProgress 플래그 사용)
  • ZIP
  • INNO
  • NULLSOFT
  • MSI
  • WIX
  • APPX
  • MSIX
  • BURN
  • PORTABLE

WinGet 스크립팅

다음 구문을 사용하여 단일 명령에 여러 애플리케이션을 설치할 수 있습니다.

USAGE: winget install <query1> <query2> ...

예시

winget install Microsoft.WindowsTerminal Microsoft.PowerToys Microsoft.VisualStudioCode

참고 항목

스크립트가 작성되면 WinGet에서 지정된 순서대로 애플리케이션을 시작합니다. 설치 관리자에서 성공 또는 실패를 반환하면 WinGet에서 다음 설치 관리자를 시작합니다. 설치 관리자에서 다른 프로세스를 시작하면 조기에 WinGet으로 돌아갈 수 있습니다. 이 경우 이전 설치 관리자가 완료되기 전에 WinGet에서 다음 설치 관리자를 설치합니다.

디버깅 및 문제 해결

WinGet은 문제 진단에 도움이 되는 로깅을 제공합니다. 로깅에 대한 문제 해결 및 세부 정보는 디버깅 및 문제 해결을 참조하세요.

누락된 도구

커뮤니티 리포지토리에 도구나 애플리케이션이 포함되어 있지 않으면 리포지토리에 패키지를 제출하세요. 즐겨찾는 도구가 추가되면 본인과 다른 모든 사용자가 사용할 수 있습니다.

WinGet 설정 사용자 지정

settings.json 파일을 수정하여 WinGet 명령줄 환경을 구성할 수 있습니다. 자세한 내용은 https://aka.ms/winget-settings를 참조하세요. 이 설정은 아직 실험적 상태이며 아직 미리 보기 버전의 도구용으로 완성되지 않았습니다.

오픈 소스 세부 정보

WinGet 도구는 GitHub의 https://github.com/microsoft/winget-cli/ 리포지토리에서 사용할 수 있는 오픈 소스 소프트웨어입니다. 클라이언트를 빌드하기 위한 원본은 src 폴더에 있습니다.

WinGet 원본은 Visual Studio 2019 C++ 솔루션에 포함되어 있습니다. 솔루션을 제대로 빌드하려면 C++ 워크로드가 포함된 최신 Visual Studio를 설치합니다.

GitHub의 WinGet 원본에 참여하는 것이 좋습니다. 먼저 Microsoft CLA에 동의하고 서명해야 합니다.

문제 해결

WinGet-cli 리포지토리는 해결 방법에 대한 권장 사항과 함께 일반적인 문제 및 일반적인 오류 목록을 유지 관리합니다.