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

아티클
11/16/2024

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

WinGet 설치

WinGet Windows 패키지 관리자 앱 설치 관리자의 일부로 Windows 11, 최신 버전의 Windows 10 및 Windows Server 2025에서 사용할 수 있습니다. 앱 설치 관리자는 Windows 데스크톱 버전 및 Windows Server 2025의 업데이트를 통해 Microsoft 스토어에서 배달 및 업데이트하는 시스템 구성 요소입니다.

참고 항목

현재 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-Host "Installing WinGet PowerShell module from PSGallery..."
Install-PackageProvider -Name NuGet -Force | Out-Null
Install-Module -Name Microsoft.WinGet.Client -Force -Repository PSGallery | Out-Null
Write-Host "Using Repair-WinGetPackageManager cmdlet to bootstrap WinGet..."
Repair-WinGetPackageManager
Write-Host "Done."

컴퓨터 범위에 PowerShell 모듈을 설치하려면 cmdlet과 -Scope AllUsers 함께 매개 변수를 Install-Module 사용할 수 있습니다. WinGet의 미리 보기 버전을 원하는 경우 Repair-WinGetPackageManager cmdlet을 사용하여 매개 변수를 추가할 -IncludePrerelease 수 있습니다. Repair-WinGetPackageManager cmdlet에 사용할 수 있는 매개 변수를 보려면 다음을 실행할 Get-Help Repair-WinGetPackageManager -Full수 있습니다.

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

관리자 고려 사항

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

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

WinGet 사용

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

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

도구를 검색하려면 winget search <appname>을 입력합니다.
원하는 도구를 사용할 수 있다고 확인되었으면 winget install <appname>을 입력하여 도구를 설치할 수 있습니다. WinGet 도구에서 설치 관리자를 시작하여 애플리케이션을 PC에 설치합니다.
WinGet은 설치 및 검색 외에도 애플리케이션에 대한 세부 정보 표시, 원본 변경 및 패키지 유효성 검사를 수행할 수 있는 여러 가지 다른 명령을 제공합니다. 전체 명령 목록을 가져오려면 winget --help를 입력합니다.

일부 사용자가 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(Silent 및 SilentWithProgress 플래그 사용)
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 리포지토리는 해결 방법에 대한 권장 사항과 함께 일반적인 문제 및 일반적인 오류 목록을 유지 관리합니다.

다음을 통해 공유