다음을 통해 공유


WinGet 원본 명령

WinGet원본 명령을 사용하면 원본을 관리할 수 있습니다. 원본 명령을 사용하여 WinGet 원본을 추가, 나열, 업데이트, 제거, 다시 설정 또는 내보낼 수 있습니다.

WinGet 원본은 애플리케이션을 검색하고 설치할 수 있는 데이터를 제공합니다. 신뢰할 수 있는 안전한 원본만 사용합니다.

WinGet은 다음 세 가지 기본 소스를 지정합니다. 이 소스는 .를 사용하여 winget source list나열할 수 있습니다.

  • msstore - Microsoft Store 카탈로그입니다.
  • winget - 애플리케이션용 WinGet 커뮤니티 리포지토리입니다.
  • winget-font - 글꼴에 대한 WinGet 커뮤니티 리포지토리입니다.

사용

winget source <subcommand> <options>

winget 원본 도움말

Sub-Commands

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

Sub-Command 설명
추가 새 원본을 추가합니다.
목록 현재 원본을 나열합니다.
업데이트 현재 원본을 업데이트합니다.
제거 현재 원본을 제거합니다.
reset 기본 원본 msstore, winget 및 winget글꼴을 다시 설정합니다.
내보내기 현재 원본을 내보냅니다.

옵션

다음 옵션을 사용할 수 있습니다.

옵션 설명
-?,--도움 선택한 명령에 대한 도움말을 표시합니다.
--대기 종료하기 전에 아무 키나 누르라는 메시지를 사용자에게 표시합니다.
--로그,--열기-로그 기본 로그 위치를 엽니다.
--자세한 정보, --자세한 정보-로그 로깅 설정을 재정의하고 자세한 정보 표시 로그를 만드는 데 사용됩니다.
--nowarn,--ignore-warnings알림을 무시하고 경고를 무시합니다. 경고 출력을 표시하지 않습니다.
--사용 하지 않도록 설정-상호 작용 대화형 프롬프트를 사용하지 않도록 설정합니다.
--프록시 이 실행에 사용할 프록시를 설정합니다.
--프록시 없음 이 실행에 프록시 사용을 사용하지 않도록 설정합니다.

추가

add 하위 명령은 새 원본을 추가합니다. 이 하위 명령에는 --name--arg 옵션이 필요합니다. 이 명령은 사용자 액세스를 변경하므로 추가를 사용하려면 관리자 권한이 있어야 합니다.

사용:

winget source add [-n] <name> [-a] <arg> [[-t] <type>] [<options>]

인수

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

인수 설명
-n, --이름 원본을 식별하기 위한 기준이 되는 이름입니다.
-a, --인수 원본의 URL 또는 UNC입니다.
-t, --유형 원본 의 유형입니다.

옵션

다음 옵션을 사용할 수 있습니다.

옵션 설명
--신뢰 수준 원본의 신뢰 수준입니다(없음 또는 신뢰할 수 있음).
--헤더 선택적 Windows 패키지 관리자 REST 원본 HTTP 헤더입니다.
--소스 동의 수락 원본 사용권 계약에 동의하고 프롬프트를 방지하는 데 사용됩니다.
--명시적
-?, --도움말 이 명령에 대한 추가 도움말을 가져옵니다.
--대기 종료하기 전에 아무 키나 누르라는 메시지를 사용자에게 표시합니다.
--로그,--열기-로그 기본 로그 위치를 엽니다.
--자세한 정보, --자세한 정보-로그 로깅 설정을 재정의하고 자세한 정보 표시 로그를 만드는 데 사용됩니다.
--nowarn,--ignore-warnings알림을 무시하고 경고를 무시합니다. 경고 출력을 표시하지 않습니다.
--사용 하지 않도록 설정-상호 작용 대화형 프롬프트를 사용하지 않도록 설정합니다.
--프록시 이 실행에 사용할 프록시를 설정합니다.
--프록시 없음 이 실행에 프록시 사용을 사용하지 않도록 설정합니다.

예를 들어 winget source add --name Contoso https://www.contoso.com/cache는 URL https://www.contoso.com/cache에 Contoso 리포지토리를 추가합니다.

선택적 형식 매개 변수

add 하위 명령은 클라이언트에 연결 중인 리포지토리의 유형을 알려주는 선택적 형식 매개 변수를 지원합니다. 지원되는 유형은 다음과 같습니다.

유형 설명
Microsoft.PreIndexed.Package 기본 소스 형식입니다.
Microsoft.Rest (영문) Microsoft REST API 소스입니다.

목록

list 하위 명령은 현재 활성화된 원본을 열거하거나 특정 원본에 대한 세부 정보를 제공합니다.

비고

원본이 명시적으로 설정된 경우 구체적으로 대상으로 지정해야 합니다. winget 글꼴 원본은 기본적으로 명시적으로 설정됩니다. 즉, 다른 WinGet 명령은 포함할 "--source winget-font" 또는 "-s winget-font"를 사용하여 원본을 직접 참조해야 합니다.

사용:

winget source list [[-n] <name>] [<options>]

winget 원본 목록

별칭

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

  • 디렉토리 내용 표시 명령어

인수

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

인수 설명
-n, --이름 원본을 식별하기 위한 기준이 되는 이름입니다.

옵션

다음 옵션을 사용할 수 있습니다.

옵션 설명
-?, --도움말 이 명령에 대한 추가 도움말을 가져옵니다.
--대기 종료하기 전에 아무 키나 누르라는 메시지를 사용자에게 표시합니다.
--로그,--열기-로그 기본 로그 위치를 엽니다.
--자세한 정보, --자세한 정보-로그 로깅 설정을 재정의하고 자세한 정보 표시 로그를 만드는 데 사용됩니다.
--nowarn,--ignore-warnings알림을 무시하고 경고를 무시합니다. 경고 출력을 표시하지 않습니다.
--사용 하지 않도록 설정-상호 작용 대화형 프롬프트를 사용하지 않도록 설정합니다.
--프록시 이 실행에 사용할 프록시를 설정합니다.
--프록시 없음 이 실행에 프록시 사용을 사용하지 않도록 설정합니다.

모두 나열

목록 하위 명령 자체는 winget source list구성된 원본의 전체 목록을 제공합니다.

Name        Argument                                      Explicit
------------------------------------------------------------------
msstore     https://storeedgefd.dsx.mp.microsoft.com/v9.0 false
winget      https://cdn.winget.microsoft.com/cache        false
winget-font https://cdn.winget.microsoft.com/fonts        true

원본 세부 정보 나열

원본에 대한 전체 세부 정보를 얻으려면 원본의 이름을 전달합니다. 예:

winget source list --name winget

다음 출력을 반환합니다.

Field       Value
--------------------------------------------------
Name        winget
Type        Microsoft.PreIndexed.Package
Argument    https://cdn.winget.microsoft.com/cache
Data        Microsoft.Winget.Source_8wekyb3d8bbwe
Identifier  Microsoft.Winget.Source_8wekyb3d8bbwe
Trust Level Trusted|StoreOrigin
Explicit    false
Updated     2025-12-11 08:30:25.000
  • Name은 원본의 이름입니다.
  • Type 는 원본의 형식입니다.
  • Arg는 원본에서 사용하는 URL 또는 경로입니다.
  • Data는 해당하는 경우 선택적 패키지 이름입니다.
  • Updated는 원본이 업데이트된 마지막 날짜와 시간입니다.

업데이트

update 하위 명령은 개별 원본 또는 모든 원본을 강제로 업데이트합니다.

사용:

winget source update [[-n] <name>] [<options>]

별칭

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

  • 리프레쉬

인수

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

인수 설명
-n, --이름 원본을 식별하기 위한 기준이 되는 이름입니다.

옵션

다음 옵션을 사용할 수 있습니다.

옵션 설명
-?, --도움말 이 명령에 대한 추가 도움말을 가져옵니다.
--대기 종료하기 전에 아무 키나 누르라는 메시지를 사용자에게 표시합니다.
--로그,--열기-로그 기본 로그 위치를 엽니다.
--자세한 정보, --자세한 정보-로그 로깅 설정을 재정의하고 자세한 정보 표시 로그를 만드는 데 사용됩니다.
--nowarn,--ignore-warnings알림을 무시하고 경고를 무시합니다. 경고 출력을 표시하지 않습니다.
--사용 하지 않도록 설정-상호 작용 대화형 프롬프트를 사용하지 않도록 설정합니다.
--프록시 이 실행에 사용할 프록시를 설정합니다.
--프록시 없음 이 실행에 프록시 사용을 사용하지 않도록 설정합니다.

모두 업데이트

업데이트 하위 명령 자체 winget source update는 모든 리포지토리에 대한 업데이트를 요청합니다.

업데이트 원본

--name 옵션이 있는 update 하위 명령은 명명된 원본으로 업데이트를 전달합니다. 예: winget source update --name Contoso는 Contoso 리포지토리를 강제로 업데이트합니다.

제거하다

remove 하위 명령은 원본을 제거합니다. 이 하위 명령에는 원본을 식별하기 위해 --name 옵션이 필요합니다. 이 명령은 사용자 액세스를 변경하므로 제거를 사용하려면 관리자 권한이 있어야 합니다.

사용:

winget source remove [-n] <name> [<options>]

별칭

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

  • 마이크로미터

인수

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

인수 설명
-n, --이름 원본을 식별하기 위한 기준이 되는 이름입니다.

옵션

다음 옵션을 사용할 수 있습니다.

옵션 설명
-?, --도움말 이 명령에 대한 추가 도움말을 가져옵니다.
--대기 종료하기 전에 아무 키나 누르라는 메시지를 사용자에게 표시합니다.
--로그,--열기-로그 기본 로그 위치를 엽니다.
--자세한 정보, --자세한 정보-로그 로깅 설정을 재정의하고 자세한 정보 표시 로그를 만드는 데 사용됩니다.
--nowarn,--ignore-warnings알림을 무시하고 경고를 무시합니다. 경고 출력을 표시하지 않습니다.
--사용 하지 않도록 설정-상호 작용 대화형 프롬프트를 사용하지 않도록 설정합니다.
--프록시 이 실행에 사용할 프록시를 설정합니다.
--프록시 없음 이 실행에 프록시 사용을 사용하지 않도록 설정합니다.

예제

winget source remove --name Contoso

이 명령은 Contoso 리포지토리를 제거합니다.

초기화

reset 하위 명령은 클라이언트를 원래 구성으로 다시 설정하며 기본값을 제외한 모든 원본을 제거합니다. 드문 경우에만 이 하위 명령을 사용합니다. 이 명령은 사용자 액세스를 변경하므로 재설정을 사용하려면 관리자 권한이 있어야 합니다.

reset 명령은 모든 원본을 제거하므로 --force 옵션을 사용하여 작업을 강제로 수행해야 합니다.

사용:

winget source reset [[-n] <name>] [<options>]

인수

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

인수 설명
-n, --이름 원본을 식별하기 위한 기준이 되는 이름입니다.

옵션

다음 옵션을 사용할 수 있습니다.

옵션 설명
--포스 원본을 강제로 다시 설정합니다.
-?, --도움말 이 명령에 대한 추가 도움말을 가져옵니다.
--대기 종료하기 전에 아무 키나 누르라는 메시지를 사용자에게 표시합니다.
--로그,--열기-로그 기본 로그 위치를 엽니다.
--자세한 정보, --자세한 정보-로그 로깅 설정을 재정의하고 자세한 정보 표시 로그를 만드는 데 사용됩니다.
--nowarn,--ignore-warnings알림을 무시하고 경고를 무시합니다. 경고 출력을 표시하지 않습니다.
--사용 하지 않도록 설정-상호 작용 대화형 프롬프트를 사용하지 않도록 설정합니다.
--프록시 이 실행에 사용할 프록시를 설정합니다.
--프록시 없음 이 실행에 프록시 사용을 사용하지 않도록 설정합니다.

수출

export 하위 명령은 원본에 대한 특정 세부정보를 JSON 출력으로 내보냅니다. 이는 원본 관리를 위한 그룹 정책을 구성하는 데 유용합니다.

사용:

winget source export [[-n] <name>] [<options>]

인수

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

인수 설명
-n, --이름 원본을 식별하기 위한 기준이 되는 이름입니다.

옵션

다음 옵션을 사용할 수 있습니다.

옵션 설명
-?, --도움말 이 명령에 대한 추가 도움말을 가져옵니다.
--대기 종료하기 전에 아무 키나 누르라는 메시지를 사용자에게 표시합니다.
--로그,--열기-로그 기본 로그 위치를 엽니다.
--자세한 정보, --자세한 정보-로그 로깅 설정을 재정의하고 자세한 정보 표시 로그를 만드는 데 사용됩니다.
--nowarn,--ignore-warnings알림을 무시하고 경고를 무시합니다. 경고 출력을 표시하지 않습니다.
--사용 하지 않도록 설정-상호 작용 대화형 프롬프트를 사용하지 않도록 설정합니다.
--프록시 이 실행에 사용할 프록시를 설정합니다.
--프록시 없음 이 실행에 프록시 사용을 사용하지 않도록 설정합니다.

예제

winget source export winget

다음 출력을 반환합니다.

{"Arg":"https://cdn.winget.microsoft.com/cache","Data":"Microsoft.Winget.Source_8wekyb3d8bbwe","Explicit":false,"Identifier":"Microsoft.Winget.Source_8wekyb3d8bbwe","Name":"winget","TrustLevel":["Trusted","StoreOrigin"],"Type":"Microsoft.PreIndexed.Package"}

원본 계약

개별 원본 은 원본을 추가하거나 사용하기 전에 사용자가 제시한 계약에 동의하도록 요청할 수 있습니다. 사용자가 규약을 수락하지 않으면 WinGet에서 원본에 액세스할 수 없습니다.

--accept-source-agreements 옵션을 사용하여 원본 계약을 수락하고 프롬프트를 피할 수 있습니다.

많은 WinGet 명령은 구성된 모든 원본을 평가합니다. 구성된 원본에 규약이 필요한 경우 WinGet은 해당 원본을 사용하기 전에 프롬프트를 표시합니다. 원본 계약은 사용하기 전에 수락해야 합니다. 원본이 계약 조건을 업데이트하거나 원본이 제거되고 읽혀지는 경우(있는 winget source reset --force경우와 같이) 계약이 다시 제공됩니다.

winget 원본 계약