upgrade 명령 (winget)

upgrade 도구의 winget 명령은 지정된 애플리케이션을 업그레이드합니다. 선택적으로, list 명령을 사용하여 upgrade하려는 애플리케이션을 식별할 수 있습니다.

upgrade 명령을 사용하려면 upgrade에 정확한 문자열을 지정해야 합니다. 모호한 경우에는 upgrade 명령을 특정 애플리케이션으로 더 구체적으로 필터링하라는 메시지가 표시됩니다.

별칭

이 명령에 사용할 수 있는 별칭은 다음과 같습니다.

• update

사용

winget upgrade [[-q] <query> ...] [<options>]

인수

사용할 수 있는 인수는 다음과 같습니다.

인수	설명
-q, --query	앱을 검색하는 데 사용되는 쿼리입니다.

참고

쿼리 인수는 위치를 나타냅니다. 와일드카드 스타일 구문은 지원되지 않습니다. 이는 업그레이드하려는 패키지를 찾는 데 도움이 된다고 가장 자주 예상되는 문자열입니다.

옵션

옵션을 사용하면 요구 사항에 맞게 환경을 사용자 지정할 upgrade 수 있습니다.

옵션	설명
-m, --manifest	매니페스트(YAML) 파일의 경로가 뒤에 나와야 합니다. 매니페스트를 사용하여 upgrade에서 환경을 실행할 수 있습니다.
--id	애플리케이션의 upgrade ID로 제한합니다.
--name	검색을 애플리케이션 이름으로 제한합니다.
--moniker	검색을 애플리케이션에 대해 나열된 모니커로 제한합니다.
-v, --version	upgrade에 대한 정확한 버전을 지정할 수 있습니다. 지정하지 않으면 최신 버전이 가장 높은 애플리케이션이 됩니다 upgrade .
-s, --source	검색을 제공된 원본 이름으로 제한합니다. 원본 이름이 뒤에 나와야 합니다.
-e, --exact	대/소문자 구분 검사를 포함하여 쿼리에서 정확한 문자열을 사용합니다. 하위 문자열의 기본 동작을 사용하지 않습니다.
-i, --interactive	대화형 모드에서 설치 관리자를 실행합니다. 기본 설정에는 설치 진행률이 표시됩니다.
-h, --silent	무음 모드에서 설치 관리자를 실행합니다. 이 경우 모든 UI가 표시되지 않습니다. 기본 설정에는 설치 진행률이 표시됩니다.
--purge	패키지 디렉터리(이식 가능)의 모든 파일 및 디렉터리를 삭제합니다.
-o, --log	로깅을 로그 파일로 출력합니다. 쓰기 권한이 있는 파일의 경로를 제공해야 합니다.
--custom	기본값 외에도 설치 관리자에 전달할 인수입니다.
--override	설치 관리자에 직접 전달되는 문자열입니다.
-l, --location	위치를 upgrade에서(지원되는 경우)로
--scope	설치된 패키지 범위 필터 선택(사용자 또는 컴퓨터)
-a, --architecture	설치할 아키텍처를 선택합니다.
--installer-type	설치 관리자 유형을 upgrade선택합니다. WinGet 클라이언트에 대해 지원되는 설치 관리자 유형을 참조하세요.
--locale	사용할 로캘을 지정합니다(BCP47 형식).
--ignore-security-hash	설치 관리자 해시 확인 실패를 무시합니다. 권장되지 않음.
--allow-reboot	해당하는 경우 재부팅을 허용합니다.
--skip-dependencies	패키지 종속성 및 Windows 기능 처리를 건너뜁니다.
--ignore-local-archive-malware-scan	로컬 매니페스트에서 보관 형식 패키지를 설치하는 과정의 일부로 수행되는 맬웨어 검사를 무시합니다.
--accept-package-agreements	사용권 계약에 동의하고 프롬프트를 방지하는 데 사용됩니다.
--accept-source-agreements	원본 사용권 계약에 동의하고 프롬프트를 방지하는 데 사용됩니다.
--header	선택 가능한 Windows 패키지 관리자 REST 소스 HTTP 헤더입니다.
--authentication-mode	인증 창 기본 설정(무음, silentPreferred 또는 대화형)을 지정합니다.
--authentication-account	인증에 사용할 계정을 지정합니다.
-r, , --recurse--all	가능한 경우 설치된 패키지를 모두 최신 버전으로 업그레이드합니다.
-u, , --unknown--include-unknown	현재 버전을 확인할 수 없는 경우에도 패키지를 업그레이드합니다.
--pinned, --include-pinned	비차단 핀이 있는 경우에도 패키지를 업그레이드합니다.
--uninstall-previous	upgrade 중에 패키지의 이전 버전을 제거합니다. 동작은 개별 패키지에 따라 달라집니다. 일부 설치 관리자는 새 버전을 나란히 설치하도록 설계되었습니다. 일부 설치 관리자에는 "uninstallPrevious"를 지정하는 매니페스트가 포함되어 있으므로 이전 버전은 이 명령 플래그를 사용할 필요 없이 제거됩니다. 이 경우 명령을 사용하면 winget upgrade --uninstall-previous 패키지 매니페스트에 있는 내용에 관계없이 이전 버전을 제거하도록 WinGet에 지시합니다. 패키지 매니페스트에 "uninstallPrevious" --uninstall-previous 가 포함되지 않고 플래그가 사용되지 않는 경우 설치 관리자의 기본 동작이 적용됩니다.
--force	명령을 직접 실행하고 비보안 관련 문제를 계속 진행합니다.
-?, --help	선택한 명령에 대한 도움말을 표시합니다.
--wait	종료하기 전에 아무 키나 누르라는 메시지를 사용자에게 표시합니다.
--logs, --open-logs	기본 로그 위치를 엽니다.
--verbose, --verbose-logs	로깅 설정을 재정의하고 자세한 정보 표시 로그를 만드는 데 사용됩니다.
--nowarn, --ignore-warnings	경고 출력을 표시하지 않습니다.
--disable-interactivity	대화형 프롬프트를 사용하지 않도록 설정합니다.
--proxy	이 실행에 사용할 프록시를 설정합니다.
--no-proxy	이 실행에 프록시 사용을 사용하지 않도록 설정합니다.

예제 쿼리

다음 예제에서는 upgrade 사용 가능한 애플리케이션을 나열합니다.

winget upgrade

다음 예에서는 애플리케이션의 특정 버전을 업그레이드합니다.

winget upgrade powertoys --version 0.15.2

다음 예에서는 해당 ID의 응용 프로그램을 업그레이드하는 예입니다.

winget upgrade --id Microsoft.PowerToys

다음 예제에서는 모든 애플리케이션 업그레이드를 보여 줍니다.

winget upgrade --all

다음 예제에서는 upgrade 여러 애플리케이션을 사용합니다.

winget upgrade Microsoft.Edit Microsoft.NuGet

upgrade 사용하기

어떤 앱에 update가 필요한지 확인하려면 인수 없이 upgrade만 사용하여 사용 가능한 모든 업그레이드를 표시하면 됩니다.

upgrade --all

upgrade --all 는 사용 가능한 upgrade가 있는 설치된 모든 애플리케이션을 update합니다. winget upgrade --all를 실행하면 Windows 패키지 관리자는 사용 가능한 업데이트가 있는 모든 애플리케이션을 찾아 업데이트 설치를 시도합니다. 먼저 upgrade를 인수 없이 사용하여 어떤 앱이 업그레이드될지 미리 확인하세요.

참고

일부 애플리케이션에서는 한 버전을 제공하지 않습니다. 항상 최신 상태입니다. Windows 패키지 관리자는 앱의 최신 버전이 있는지 확인할 수 없으므로 -u, --unknown, --include-unknown 옵션을 지정하지 않으면 upgrade을 수행할 수 없습니다.

참고

일부 애플리케이션은 WinGet을 사용해 고정되었을 수 있으며, --all 옵션이 지정된 경우 --include-pinned 옵션도 지정되지 않는 한 업그레이드되지 않습니다. 이 경우 비차단 핀 애플리케이션만 업그레이드됩니다.

upgrade --uninstall-previous

upgrade --uninstall-previous 는 최신 버전의 패키지를 설치하기 전에 이전 버전을 제거합니다. 사용하는 --uninstall-previous경우 동작은 개별 패키지에 따라 달라집니다. 일부 설치 관리자는 새 버전을 나란히 설치하도록 설계되었으며, 다른 설치 관리자에는 기본 uninstallPrevious 동작으로 지정하는 upgrade 매니페스트가 포함되어 있습니다(따라서 이전 버전은 명령 플래그를 사용하지 않고도 제거됨).

패키지 매니페스트에 uninstallPrevious 동작으로 upgrade이 포함되어 있지 않고 --uninstall-previous 명령과 함께 upgrade 플래그를 사용하지 않는 경우, 설치 관리자의 기본 동작이 적용됩니다.