Windows에서 Winget 인식되지 않는 문제 해결 방법

Windows 사용자는 종종 PowerShell, 명령 프롬프트 및 기타 인터프리터를 통해 애플리케이션을 설치하고 관리하기 위해 WinGet을 사용합니다. 때때로 WinGet 명령을 실행할 때 유효한 cmdlet, 함수 또는 스크립트 파일로 인식되지 않는다는 오류가 발생할 수 있습니다. 이 가이드는 이 성가신 오류를 제거하고 WinGet을 다시 작동시키는 방법을 보여줍니다.
1. WinGet 다시 등록 또는 복구하기
이 WinGet 오류의 가장 큰 원인 중 하나는 Windows 패키지 관리자의 손상되거나 잘못 구성된 설치입니다. 이 경우 WinGet을 다시 등록하여 쉽게 수정할 수 있으며, 이는 설치를 재설정하고 잠재적으로 발생할 수 있는 문제를 해결할 수 있습니다.
검색 상자에 PowerShell을 입력하고 관리자 권한으로 실행을 클릭합니다. 열리면 다음 명령을 PowerShell에 복사하여 붙여넣습니다:
Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe
위 명령은 Windows에 공식 Microsoft 소스에서 App Installer를 다시 등록하도록 지시하며, 이는 WinGet 기능을 복원합니다.
전체 재설치 대신, 다음 명령을 사용하여 기존 WinGet 패키지를 복구할 수 있습니다.
Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe
정확하게 실행되면 Windows는 WinGet 애플리케이션을 빠르게 다시 등록하고 손상된 바로 가기, 누락된 종속성 또는 손상된 등록 항목과 같은 Windows 패키지 설치 프로그램 문제를 해결합니다.
관련: WinGet은 Windows 패키지 관리자라는 생태계의 일부입니다. 이는 Windows 패키지 관리자 서비스의 클라이언트 인터페이스 역할을 하는 명령줄 도구입니다.
2. Windows 패키지 관리자를 위한 앱 실행 별칭 활성화하기
명령줄 맥락에서 WinGet 이름은 Windows 패키지 관리자를 위한 앱 실행 별칭입니다.
기본적으로 앱 실행 별칭은 축약형 또는 약어 형태의 CLI 명령입니다. Windows 패키지 관리자에 대해 이 기능을 비활성화하면 CLI가 WinGet을 인식하지 못할 수 있습니다. 이는 서드파티 정리 도구나 시스템 최적화 도구로 인해 발생할 수도 있습니다.
Windows 패키 관리자를 위한 앱 실행 별칭을 활성화하려면 Win + I를 눌러 설정 앱을 열고 앱 -> 고급 앱 설정으로 이동한 다음 앱 실행 별칭을 클릭합니다.
Windows 패키지 관리자 클라이언트의 토글이 꺼짐 상태라면, 토글을 다시 켜짐으로 전환합니다.

Windows 10 사용자는 설정 -> 앱 -> 앱 및 기능으로 이동하여 앱 실행 별칭 링크를 클릭하여 Windows 패키지 관리자 클라이언트의 토글을 찾을 수 있습니다.
팁: PowerShell에 비교적 익숙하지 않다면, 이러한 필수 명령을 배우세요.
3. 앱 설치 관리자의 최신 버전 확인하기
WinGet은 사용자가 프로그램을 쉽게 설치하고 관리할 수 있도록 하는 사전 설치된 Windows 패키지인 앱 설치 관리자의 일부입니다. 앱 설치 관리자가 오류가 발생하면 Winget 오류로 이어질 수 있습니다. 앱 설치 관리자를 수정하려면 Microsoft Store에서 업데이트하세요.
공식 앱 설치 관리자 다운로드 링크로 이동하여 큰 파란색 다운로드 버튼을 클릭합니다. MSIXBUNDLE 파일을 다운로드할 PC 위치를 찾습니다.

이제 앱 설치 관리자가 이미 설치되어 있다는 메시지가 표시됩니다. 다시 설치를 클릭하면 누락된 종속성을 수정할 수 있습니다.
그렇지 않으면 Microsoft Store를 통해 업데이트할 수 있는 옵션이 표시됩니다.
알고 계셨나요? WinGet을 사용하여 다른 브라우저를 사용하지 않고 Windows에서 웹 브라우저를 다운로드할 수 있습니다.
4. GitHub에서 앱 설치 관리자 재설치하기
앱 설치 관리자 업데이트가 작동하지 않는 경우, 재설치하면 Winget이 오작동하는 원인을 수정하는 데 도움이 될 수 있습니다. 그렇게 하려면 아래 단계를 따르세요:
Windows 패키지 관리자 GitHub 페이지로 이동합니다.
자산 섹션으로 스크롤하여 데스크톱 앱 설치 관리자의 MSIXBundle 파일을 클릭하여 다운로드합니다.

방금 다운로드한 파일을 두 번 클릭하고 팝업 창에서 다시 설치를 클릭합니다.

- 앱 설치 관리자를 재설치하기 위한 나머지 지침을 따르세요.
참고: 즉시 제거해야 할 Windows 앱 목록을 확인하세요.
5. Winget을 위한 경로 환경 변수 만들기
명령 프롬프트나 PowerShell에서 WinGet 명령을 실행하면 Windows는 실행해야 할 파일을 찾기 위해 PATH 변수를 검색합니다. 요약하자면, 이 변수는 Windows의 다양한 명령에 대한 실행 파일이 포함된 디렉터리 목록을 유지합니다. PATH에 WinGet 실행 파일이 포함된 디렉터리가 나열되지 않으면 오류가 발생합니다.
이를 수정하려면 누락된 디렉터리를 PATH 변수에 수동으로 추가해야 합니다:
Win + R을 눌러 Windows 실행을 열고 텍스트 상자에 systempropertiesadvanced를 입력한 후 확인을 클릭합니다. 이렇게 하면 시스템 속성 창이 열립니다.

고급 탭을 선택한 다음 환경 변수를 클릭합니다.

Path 변수를 선택한 다음 편집을 클릭하여 환경 변수 편집 창을 엽니다.

다음 파일 경로를 복사합니다: %UserProfile\AppData\Local\Microsoft\WindowsApps.
환경 변수 편집 창에서 새로 만들기를 클릭합니다. 그곳에 방금 복사한 파일 경로를 붙여넣고 확인을 클릭하여 변경 사항을 저장합니다.

관련: Windows 환경 변수의 전체 목록을 확인하세요.
6. 로컬 그룹 정책 편집기에서 앱 패키지 배포 설정 활성화하기
Windows Pro/Enterprise 장치에서 실행 명령에 gpedit.msc를 입력하여 그룹 정책을 엽니다.
다음 경로로 이동합니다: 컴퓨터 구성 -> 관리 템플릿 -> Windows 구성 요소 -> 앱 패키지 배포.

여기에서 대부분의 구성 요소에 대해 구성되지 않음 상태를 찾을 수 있습니다. 특히 집중해야 할 것은 “특수 프로필에서 배포 작업 허용”과 “모든 신뢰할 수 있는 앱 설치 허용”입니다. 이러한 항목을 두 번 클릭하고 다음 팝업 화면에서 사용을 클릭한 후 확인을 클릭합니다.
알고 계셨나요: 명령 프롬프트와 PowerShell의 차이를 배우세요.
7. 다양한 방법으로 앱 설치 관리자 캐시 복구하기
다양한 서비스의 캐시를 복구할 수 있습니다. 제어판을 열고 프로그램 -> 프로그램 및 기능으로 이동합니다. 목록에서 앱 설치 관리자를 찾습니다.
프로그램이 나열되어 있으면 마우스 오른쪽 버튼을 클릭하고 복구(또는 제거, 그런 다음 앞서 설명한 대로 GitHub에서 다시 설치)를 선택합니다.
또는 실행 명령을 열고 wsreset.exe를 입력할 수 있습니다. 이렇게 하면 Microsoft Store 캐시가 지워져 WinGet 명령을 원활하게 사용할 수 있습니다.
8. Windows PC를 공장 초기화로 재설정하기
모든 방법이 실패하면 OS에 더 깊은 손상이나 잘못된 구성이 있을 수 있습니다. 무엇을 해야 할지 모르겠다면 Windows를 공장 초기화하여 Winget에 영향을 줄 수 있는 설정과 구성을 새로 시작할 수 있습니다. 그러나 PC를 재설정하기 전에 중요한 데이터를 백업해야 합니다. 과정에서 데이터를 잃게 됩니다.
팁: Windows 재설정 시 클라우드 다운로드 또는 로컬 재설치 중 어떤 옵션이 가장 좋은지 알아보세요.
PC에서 Winget 작동시키기
명령 프롬프트나 PowerShell에서 설치하는 것을 선호한다면 Winget은 필수 유틸리티입니다. PC의 명령줄 도구가 이를 인식하지 못하면 Windows 경험이 저하될 수 있습니다. 위의 문제 해결 단계를 따르면 다시 작동하게 할 수 있습니다.
Winget의 대안을 찾고 있다면 Chocolatey를 사용하여 Windows PC에 다양한 애플리케이션을 설치해 보세요.