pin 명령(winget)
wingetpin 명령을 사용하면 Windows 패키지 관리자가 패키지를 특정 버전의 범위로 업그레이드하는 것을 제한하거나 패키지를 완전히 업그레이드하지 못하게 할 수 있습니다. 고정된 패키지는 자체적으로 업그레이드할 수 있으며 Windows 패키지 관리자 외부에서 업그레이드할 수 있습니다.
핀 유형
WinGet은 다음과 같은 세 가지 유형의 패키지 핀을 지원합니다.
고정: 패키지는
winget upgrade --all에서 제외되지만winget upgrade <package>를 허용합니다.--include-pinned인수를 사용하여winget upgrade --all에 고정된 패키지를 포함할 있습니다.차단: 패키지가
winget upgrade --all또는winget upgrade <package>에서 차단되었습니다. WinGet에서 업그레이드를 수행할 수 있도록 패키지를 고정 해제해야 합니다.--force옵션을 사용하여 핀의 동작을 재정의할 수 있습니다.게이팅: 패키지가 특정 버전 또는 버전 범위에 고정됩니다. 패키지를 고정할 정확한 버전을 지정하거나 와일드카드 문자
*를 마지막 버전 부분으로 활용하여 버전 범위를 지정할 수 있습니다. 예를 들어 패키지가 버전1.2.*에 고정된 경우1.2.0에서1.2.x사이의 모든 버전은 유효한 것으로 간주됩니다.--force옵션을 사용하여 핀의 동작을 재정의할 수 있습니다.
사용
winget pin <subcommand> <options>
옵션
다음 옵션을 사용할 수 있습니다.
| 옵션 | 설명 |
|---|---|
| -?, --help | 이 명령에 대한 추가 도움말을 가져옵니다. |
| --wait | 종료하기 전에 아무 키나 누르라는 메시지를 사용자에게 표시합니다. |
| --로그,--열기-로그 | 기본 로그 위치를 엽니다. |
| --자세한 정보, --자세한 정보-로그 | 로깅 설정을 재정의하고 자세한 정보 표시 로그를 만드는 데 사용됩니다. |
| --nowarn,--ignore-warnings | 경고 출력을 표시하지 않습니다. |
| --사용 하지 않도록 설정-상호 작용 | 대화형 프롬프트를 사용하지 않도록 설정합니다. |
| --proxy | 이 실행에 사용할 프록시를 설정합니다. |
| --no-proxy | 이 실행에 프록시 사용을 사용하지 않도록 설정합니다. |
하위 명령
pin 명령은 다음 하위 명령을 지원합니다.
| 하위 명령 | 설명 |
|---|---|
| add | 새 핀을 추가합니다. |
| remove | 패키지 핀을 제거합니다. |
| 목록 | 현재 핀을 나열합니다. |
| reset | 핀 다시 설정 |
add
add 하위 명령은 새 핀을 추가합니다. 이 하위 명령을 사용하려면 고정할 정확한 패키지를 지정해야 합니다. 문자열이 명확하지 않으면 add 하위 명령을 정확한 애플리케이션으로 추가 필터링하라는 메시지가 표시됩니다.
사용:
winget pin add [[-q] <query>] [<options>]
인수
| Argument | 설명 |
|---|---|
| -q,--query | 앱을 검색하는 데 사용되는 쿼리입니다. |
옵션
옵션을 사용하면 요구 사항에 맞게 핀 추가를 사용자 지정할 수 있습니다.
| 옵션 | 설명 |
|---|---|
| --id | 검색을 애플리케이션 ID로 제한합니다. |
| --name | 검색을 애플리케이션 이름으로 제한합니다. |
| --moniker | 검색을 애플리케이션에 대해 나열된 모니커로 제한합니다. |
| --tag | 검색을 애플리케이션에 대해 나열된 태그로 제한합니다. |
| --cmd, --command | 검색을 애플리케이션의 명령으로 제한합니다. |
| -e, --exact | 대/소문자 구분 검사를 포함하여 쿼리에서 정확한 문자열을 사용합니다. 하위 문자열의 기본 동작을 사용하지 않습니다. |
| -v, --version | 고정할 정확한 버전을 지정할 수 있습니다. 와일드카드 *는 마지막 버전 부분으로 사용할 수 있습니다. 핀 동작을 gating로 변경합니다. |
| -s, --source | 검색을 제공된 원본 이름으로 제한합니다. 원본 이름이 뒤에 나와야 합니다. |
| --header | 선택적 Windows 패키지 관리자 REST 원본 HTTP 헤더입니다. |
| --authentication-mode | 인증 창 기본 설정(무음, silentPreferred 또는 대화형)을 지정합니다. |
| --authentication-account | 인증에 사용할 계정을 지정합니다. |
| --accept-source-agreements | 원본 사용권 계약에 동의하고 프롬프트를 방지하는 데 사용됩니다. |
| --force | 명령을 직접 실행하고 비보안 관련 문제를 계속 진행합니다. |
| --blocking | 핀이 제거될 때까지 업그레이드를 차단하여 인수 재정의를 방지합니다. 핀 동작을 blocking로 변경합니다. |
| --installed | 설치된 특정 버전 고정 |
| -?, --help | 이 명령에 대한 추가 도움말을 가져옵니다. |
| --wait | 종료하기 전에 아무 키나 누르라는 메시지를 사용자에게 표시합니다. |
| --logs, --open-logs | 기본 로그 위치를 엽니다. |
| --자세한 정보, --자세한 정보-로그 | 로깅 설정을 재정의하고 자세한 정보 표시 로그를 만드는 데 사용됩니다. |
| --nowarn,--ignore-warnings | 경고 출력을 표시하지 않습니다. |
| --사용 하지 않도록 설정-상호 작용 | 대화형 프롬프트를 사용하지 않도록 설정합니다. |
| --proxy | 이 실행에 사용할 프록시를 설정합니다. |
| --no-proxy | 이 실행에 프록시 사용을 사용하지 않도록 설정합니다. |
예제
다음 예제에서는 애플리케이션에 대한 핀을 추가합니다. 이 핀을 추가하면 winget upgrade --all를 호출할 때 이 패키지가 업그레이드되지 않습니다. 고정된 패키지를 포함하려면 winget upgrade --all에서 --include-pinned 인수를 사용합니다.
winget pin add powertoys
다음 예제에서는 해당 ID를 사용하여 애플리케이션에 대한 차단 핀을 추가합니다. 차단 핀을 추가하면 winget upgrade --all 또는 winget upgrade <package>를 호출할 때 이 패키지가 업그레이드되지 않습니다. WinGet에서 업그레이드를 수행할 수 있도록 하려면 패키지 차단을 해제해야 합니다.
winget pin add --id Microsoft.PowerToys --blocking
다음 예제에서는 해당 ID를 사용하여 애플리케이션에 대한 게이팅 핀을 추가합니다. 게이팅 핀을 추가하면 특정 버전이나 제어된 와일드카드 범위를 벗어나 패키지 버전을 업그레이드하는 업그레이드를 방지할 수 있습니다.
winget pin add --id Microsoft.PowerToys --version 0.70.*
remove
remove 하위 명령은 핀을 제거합니다. 이 하위 명령을 사용하려면 제거할 정확한 패키지 핀을 지정해야 합니다. 문자열이 명확하지 않으면 remove 하위 명령을 정확한 애플리케이션으로 추가 필터링하라는 메시지가 표시됩니다.
사용:
winget pin remove [[-q] <query>] [<options>]
인수
| Argument | 설명 |
|---|---|
| -q,--query | 앱을 검색하는 데 사용되는 쿼리입니다. |
옵션
옵션을 사용하면 요구 사항에 맞게 핀 제거를 사용자 지정할 수 있습니다.
| 옵션 | 설명 |
|---|---|
| --id | 검색을 애플리케이션 ID로 제한합니다. |
| --name | 검색을 애플리케이션 이름으로 제한합니다. |
| --moniker | 검색을 애플리케이션에 대해 나열된 모니커로 제한합니다. |
| -s, --source | 검색을 제공된 원본 이름으로 제한합니다. 원본 이름이 뒤에 나와야 합니다. |
| --tag | 검색을 애플리케이션에 대해 나열된 태그로 제한합니다. |
| --cmd, --command | 검색을 애플리케이션의 명령으로 제한합니다. |
| -e, --exact | 대/소문자 구분 검사를 포함하여 쿼리에서 정확한 문자열을 사용합니다. 하위 문자열의 기본 동작을 사용하지 않습니다. |
| --header | 선택적 Windows 패키지 관리자 REST 원본 HTTP 헤더입니다. |
| --authentication-mode | 인증 창 기본 설정(무음, silentPreferred 또는 대화형)을 지정합니다. |
| --authentication-account | 인증에 사용할 계정을 지정합니다. |
| --accept-source-agreements | 원본 사용권 계약에 동의하고 프롬프트를 방지하는 데 사용됩니다. |
| --installed | 설치된 특정 버전을 고정합니다. |
| -?, --help | 이 명령에 대한 추가 도움말을 가져옵니다. |
| --wait | 종료하기 전에 아무 키나 누르라는 메시지를 사용자에게 표시합니다. |
| --logs, --open-logs | 기본 로그 위치를 엽니다. |
| --자세한 정보, --자세한 정보-로그 | 로깅 설정을 재정의하고 자세한 정보 표시 로그를 만드는 데 사용됩니다. |
| --nowarn,--ignore-warnings | 경고 출력을 표시하지 않습니다. |
| --사용 하지 않도록 설정-상호 작용 | 대화형 프롬프트를 사용하지 않도록 설정합니다. |
| --proxy | 이 실행에 사용할 프록시를 설정합니다. |
| --no-proxy | 이 실행에 프록시 사용을 사용하지 않도록 설정합니다. |
예제
다음 예제에서는 애플리케이션에 대한 핀을 제거합니다.
winget pin remove powertoys
다음 예제에서는 해당 ID를 사용하여 애플리케이션에 대한 핀을 제거합니다.
winget pin remove --id Microsoft.PowerToys
list
list 하위 명령은 현재 핀을 모두 나열합니다.
사용:
winget pin list [[-q] <query>] [<options>]
인수
| Argument | 설명 |
|---|---|
| -q,--query | 앱을 검색하는 데 사용되는 쿼리입니다. |
옵션
옵션을 사용하면 요구 사항에 맞게 목록 핀을 사용자 지정할 수 있습니다.
| 옵션 | 설명 |
|---|---|
| --id | 검색을 애플리케이션 ID로 제한합니다. |
| --name | 검색을 애플리케이션 이름으로 제한합니다. |
| --moniker | 검색을 애플리케이션에 대해 나열된 모니커로 제한합니다. |
| -s, --source | 검색을 제공된 원본 이름으로 제한합니다. 원본 이름이 뒤에 나와야 합니다. |
| --tag | 검색을 애플리케이션에 대해 나열된 태그로 제한합니다. |
| --cmd, --command | 검색을 애플리케이션의 명령으로 제한합니다. |
| -e, --exact | 대/소문자 구분 검사를 포함하여 쿼리에서 정확한 문자열을 사용합니다. 하위 문자열의 기본 동작을 사용하지 않습니다. |
| --header | 선택적 Windows 패키지 관리자 REST 원본 HTTP 헤더입니다. |
| --authentication-mode | 인증 창 기본 설정(무음, silentPreferred 또는 대화형)을 지정합니다. |
| --authentication-account | 인증에 사용할 계정을 지정합니다. |
| --accept-source-agreements | 원본 사용권 계약에 동의하고 프롬프트를 방지하는 데 사용됩니다. |
| -?, --help | 이 명령에 대한 추가 도움말을 가져옵니다. |
| --wait | 종료하기 전에 아무 키나 누르라는 메시지를 사용자에게 표시합니다. |
| --logs, --open-logs | 기본 로그 위치를 엽니다. |
| --자세한 정보, --자세한 정보-로그 | 로깅 설정을 재정의하고 자세한 정보 표시 로그를 만드는 데 사용됩니다. |
| --nowarn,--ignore-warnings | 경고 출력을 표시하지 않습니다. |
| --사용 하지 않도록 설정-상호 작용 | 대화형 프롬프트를 사용하지 않도록 설정합니다. |
| --proxy | 이 실행에 사용할 프록시를 설정합니다. |
| --no-proxy | 이 실행에 프록시 사용을 사용하지 않도록 설정합니다. |
예제
다음 예제에서는 현재 핀을 모두 나열합니다.
winget pin list
다음 예제에서는 특정 패키지 핀을 나열합니다.
winget pin list --id Microsoft.PowerToys
reset
reset 하위 명령은 모든 핀을 다시 설정합니다.
--force 인수 없이 이 하위 명령을 사용하면 제거될 핀이 표시됩니다.
모든 핀을 다시 설정하려면 --force 인수를 포함합니다.
사용:
winget pin reset [<options>]
옵션
옵션을 사용하면 요구 사항에 맞게 핀 재설정을 사용자 지정할 수 있습니다.
| 옵션 | 설명 |
|---|---|
| --force | 명령을 직접 실행하고 비보안 관련 문제를 계속 진행합니다. |
| -s, --source | 검색을 제공된 원본 이름으로 제한합니다. 원본 이름이 뒤에 나와야 합니다. |
| -?, --help | 이 명령에 대한 추가 도움말을 가져옵니다. |
| --wait | 종료하기 전에 아무 키나 누르라는 메시지를 사용자에게 표시합니다. |
| --logs, --open-logs | 기본 로그 위치를 엽니다. |
| --자세한 정보, --자세한 정보-로그 | 로깅 설정을 재정의하고 자세한 정보 표시 로그를 만드는 데 사용됩니다. |
| --nowarn,--ignore-warnings | 경고 출력을 표시하지 않습니다. |
| --사용 하지 않도록 설정-상호 작용 | 대화형 프롬프트를 사용하지 않도록 설정합니다. |
| --proxy | 이 실행에 사용할 프록시를 설정합니다. |
| --no-proxy | 이 실행에 프록시 사용을 사용하지 않도록 설정합니다. |
예제
다음 예제에서는 재설정할 모든 핀을 보여 줍니다.
winget pin reset
다음 예제에서는 기존 핀을 모두 다시 설정합니다.
winget pin reset --force
Windows developer