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 버전 1809(빌드 17763) 이상에서만 지원됩니다. WinGet은 Windows에 처음으로 사용자로 로그인할 때까지 사용할 수 없으므로 Microsoft Store가 비동기 프로세스의 일부로 Windows 패키지 관리자 등록하도록 트리거합니다. 최근에 처음으로 사용자로 로그인했는데 아직 WinGet을 사용할 수 없는 경우 PowerShell을 열고 다음 명령을 입력하여 이 WinGet 등록을 요청할 수 있습니다. Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.
WinGet 미리 보기 버전 설치 [개발자 전용]
WinGet은 앱 설치 관리자에 포함됩니다. 최신 Windows 패키지 관리자 기능을 사용해 보려면 다음 방법 중 하나로 미리 보기 빌드를 설치할 수 있습니다.
최신 WinGet 미리 보기 버전을 다운로드합니다. 새로운 기능에 대해 알아보려면 WinGet 미리 보기 릴리스 정보를 참조하세요. 이 패키지를 설치하면 WinGet 클라이언트의 미리 보기 버전이 제공되지만 Microsoft Store에서 새 미리 보기 버전의 자동 업데이트가 사용하도록 설정되지는 않습니다.
MSA(Microsoft 계정), 회사, 학교 또는 AAD(Azure Active Directory) 계정을 사용하여 카나리아 또는 개발 채널에서 Windows 참가자 프로그램에 등록 합니다. Windows 참가자 카나리아 및 개발 채널은 Microsoft Store에서 새로운 WinGet 미리 보기 버전을 자동으로 업데이트합니다.
MSA(Microsoft 계정)를 사용하여 Windows 패키지 관리자 참가자 프로그램에 등록합니다. MSA(Microsoft 계정)가 추가되면(이메일 알림을 받은 지 며칠 후) Microsoft Store에서 새 미리 보기 버전의 자동 업데이트를 받게 됩니다.
Windows 샌드박스에 WinGet 설치
Windows 샌드박스는 애플리케이션을 독립적으로 안전하게 실행할 수 있는 가벼운 데스크톱 환경을 제공합니다. Windows 샌드박스 환경 내부에 설치된 소프트웨어는 "샌드박스" 상태로 유지되며 호스트 시스템과 별도로 실행됩니다. Windows 샌드박스에는 WinGet 또는 Microsoft Store 앱이 포함되어 있지 않으므로 GitHub의 WinGet 릴리스 페이지에서 최신 WinGet 패키지를 다운로드하거나 Repair-WinGetPackageManager cmdlet을 사용해야 합니다.
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 -AllUsers
Write-Host "Done."
WinGet PowerShell 모듈을 컴퓨터 범위에 설치하려면 -Scope AllUsers 매개 변수와 함께 Install-Module cmdlet을 사용할 수 있습니다. 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 도구의 현재 미리 보기에서 지원하는 명령은 다음과 같습니다.
| 명령어 | 설명 |
|---|---|
| 설치 | 지정된 애플리케이션을 설치합니다. |
| 쇼 | 지정된 애플리케이션에 대한 세부 정보를 표시합니다. |
| 원본 | WinGet에서 액세스하는 Windows 패키지 관리자 리포지토리를 추가, 제거 및 업데이트합니다. |
| 검색 | 애플리케이션을 검색합니다. |
| 목록 | 설치된 패키지를 표시합니다. |
| Upgrade(업그레이드) | 지정된 애플리케이션을 업그레이드합니다. |
| 제거 | 지정된 애플리케이션을 제거합니다. |
| 해시 | 설치 관리자에 대한 SHA256 해시를 생성합니다. |
| 유효성 검사 | Windows 패키지 관리자 리포지토리에 제출할 매니페스트 파일의 유효성을 검사합니다. |
| 설정 | 설정을 엽니다. |
| 기능 | 실험적 기능의 상태를 표시합니다. |
| 내보내기 | 설치된 패키지 목록을 내보냅니다. |
| 가져오기 | 파일에 모든 패키지를 설치합니다. |
| pin | 패키지 핀을 관리합니다. |
| 설정 | 시스템을 원하는 상태로 구성합니다. |
| 다운로드 | 지정된 애플리케이션의 설치 관리자를 다운로드합니다. |
| repair | 선택한 애플리케이션을 복구합니다. |
| dscv3 | PowerShell 필수 상태 구성(DSC) v3 리소스 명령. |
옵션
WinGet 도구는 다음 옵션을 지원합니다.
| 옵션 | 설명 |
|---|---|
| -v, --버전 | 현재 버전의 WinGet을 반환합니다. |
| --정보 | 라이선스, 개인정보 처리방침 및 구성된 그룹 정책에 대한 링크를 포함하여 WinGet에 대한 모든 세부 정보를 제공합니다. |
| -?, --도움말 | WinGet에 대한 추가 도움말을 표시합니다. |
| --대기 | 종료하기 전에 아무 키나 누르라는 메시지를 사용자에게 표시합니다. |
| --logs,--open-logs | 기본 로그 위치를 엽니다. |
| --verbose,--verbose-logs | winget에 자세한 정보 로깅을 사용하도록 설정합니다. |
| --nowarn,--ignore-warnings알림을 무시하고 경고를 무시합니다. | 경고 출력을 표시하지 않습니다. |
| --disable-interactivity | 대화형 프롬프트를 사용하지 않도록 설정합니다. |
| --프록시 | 이 실행에 사용할 프록시를 설정합니다. |
| --no-proxy | 이 실행에 프록시 사용을 사용하지 않도록 설정합니다. |
지원되는 설치 관리자 형식
WinGet 은 다음과 같은 유형의 설치 관리자를 지원합니다.
- EXE(Silent 및 SilentWithProgress 플래그 사용)
- ZIP
- INNO
- NULLSOFT
- MSI
- WIX
- 앱엑스
- MSIX (엠에스아이엑스)
- 불에 타다
- 휴대용
WinGet 스크립팅
Microsoft.WinGet.Client PowerShell 모듈은 PowerShell 갤러리에서 사용할 수 있습니다.
디버깅 및 문제 해결
WinGet은 문제 진단에 도움이 되는 로깅을 제공합니다. 로깅에 대한 문제 해결 및 세부 정보는 디버깅 및 문제 해결을 참조하세요.
누락된 도구
커뮤니티 리포지토리에 도구 또는 애플리케이션이 포함되지 않은 경우 리포지토리에 패키지를 제출합니다. 즐겨찾는 도구가 추가되면 본인과 다른 모든 사용자가 사용할 수 있습니다.
WinGet 설정 사용자 지정
settings.json 파일을 수정하여 WinGet 명령줄 환경을 구성할 수 있습니다. 자세한 내용은 설정 명령에 대한 페이지를 참조하세요.
오픈 소스 세부 정보
WinGet 도구는 GitHub의 https://github.com/microsoft/winget-cli/ 리포지토리에서 사용할 수 있는 오픈 소스 소프트웨어입니다. 클라이언트를 빌드하기 위한 원본은 src 폴더에 있습니다.
WinGet의 원본은 Visual Studio 2022 C++ 솔루션에 포함되어 있습니다. 솔루션을 올바르게 빌드하려면 리포지토리를 복제하고 ".github" 디렉터리에 있는 적절한 WinGet 구성 파일을 실행합니다.
GitHub의 WinGet 원본에 참여하는 것이 좋습니다. 먼저 Microsoft CLA에 동의하고 서명해야 합니다. 끌어오기 요청은 자체 포크의 분기에서 가져와야 합니다.
문제 해결
winget-cli 리포지토리는 해결 방법에 대한 권장 사항과 함께 일반적인 문제 및 일반적인 오류 목록을 유지 관리합니다.
GitHub에서 Microsoft와 공동 작업
이 콘텐츠의 원본은 GitHub에서 찾을 수 있으며, 여기서 문제와 끌어오기 요청을 만들고 검토할 수도 있습니다. 자세한 내용은 참여자 가이드를 참조하세요.
Windows developer