다음을 통해 공유

설정 명령(winget)

WinGet의 설정 명령을 사용하면 Windows 패키지 관리자 클라이언트 환경을 사용자 지정할 수 있습니다. 기본값을 변경하고 클라이언트에서 사용할 수 있는 실험적 기능을 사용해 볼 수 있습니다.

설정 명령은 기본 JSON 편집기를 시작합니다. Windows는 기본적으로 메모장을 옵션으로 시작합니다. Visual Studio 코드같은 도구를 사용하는 것이 좋습니다.

비고

입력하여 Visual Studio Code를 쉽게 설치할 수 있습니다. winget install Microsoft.VisualStudioCode

별칭

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

  • 환경 설정

하위 명령

다음 하위 명령을 사용할 수 있습니다.

Sub-Command 설명
내보내기 설정을 내보냅니다.
설정 관리자 설정의 값을 설정합니다.
reset 관리자 설정을 기본값으로 다시 설정합니다.

옵션

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

논쟁 설명
--enable 지정된 관리자 설정을 사용하도록 설정합니다.
--비활성화 지정된 관리자 설정을 사용하지 않도록 설정합니다.
-?,--도움 선택한 명령에 대한 도움말을 표시합니다.
--대기 종료하기 전에 아무 키나 누르라는 메시지를 사용자에게 표시합니다.
--logs,--open-logs 기본 로그 위치를 엽니다.
--verbose,--verbose-logs winget에 자세한 정보 로깅을 사용하도록 설정합니다.
--nowarn,--ignore-warnings알림을 무시하고 경고를 무시합니다. 경고 출력을 표시하지 않습니다.
--disable-interactivity 대화형 프롬프트를 사용하지 않도록 설정합니다.
--프록시 이 실행에 사용할 프록시를 설정합니다.
--no-proxy 이 실행에 프록시 사용을 사용하지 않도록 설정합니다.

winget 설정 명령 사용

기본 JSON 편집 도구를 시작합니다. winget settings

설정을 처음 시작하면 설정이 지정되지 않습니다. JSON 파일의 맨 위에는 최신 실험적 기능 및 설정을 검색할 수 있는 WinGet CLI 설정 링크가 제공됩니다.

아래 코드 스니펫은 시각적 출력 수정과 실험적 기능을 활성화하여 설정 파일이 어떻게 보일 수 있는지를 보여 줍니다.

{
    "$schema": "https://aka.ms/winget-settings.schema.json",

    "visual": {
        "enableSixels": true,
        "progressBar": "rainbow"
    },
    "experimentalFeatures": {
        "experimentalARG": true,
        "experimentalCMD": true
    }
}

설정 파일에 대한 스키마도 정의했습니다. 이렇게 하면 JSON 편집기에서 JSON 스키마를 지원하는 경우 TAB을 사용하여 설정 및 구문을 검색할 수 있습니다.

설정 업데이트

다음 설정은 Windows 패키지 관리자의 1.11 릴리스에 사용할 수 있습니다.

원본 설정

설정에는 source WinGet 원본에 대한 구성이 포함됩니다.

"source": {
    "autoUpdateIntervalInMinutes": 60
},

자동업데이트간격(분단위)

양의 정수는 업데이트 간격(분)을 나타냅니다. 업데이트 확인은 원본을 사용하는 경우에만 발생합니다. 0이면 원본에 대한 업데이트에 대한 검사를 사용하지 않도록 설정합니다. 다른 모든 값이 잘못되었습니다.

  • 사용 안 함: 0
  • 기본값: 15

원본 사용을 winget source update수동으로 업데이트하려면 .

시각적 설정

설정에는 visual WinGet에서 표시하는 시각적 요소가 포함됩니다.

"visual": {
    "enableSixels": true,
    "progressBar": "rainbow"
},

진행 바

인수로 지정하지 않은 경우 WinGet에서 표시하는 진행률 표시줄의 색입니다.

  • 강조(기본값)
  • 무지개
  • 복고풍
  • sixel
  • 사용 안 함

표시된 경로 익명화

알려진 일부 폴더 경로를 해당 환경 변수로 바꿉니다.

enableSizels

특정 컨텍스트에서 6el 이미지의 출력을 사용하도록 설정합니다.

로깅 설정

설정은 logging 로그 파일의 세부 수준을 제어합니다. --verbose-logs 이 설정을 재정의하고 항상 자세한 정보 표시 로그를 만듭니다.

"logging": {
    "level": "verbose"
}

수준

다음 로깅 수준을 사용할 수 있습니다. 값이 설정되지 않았거나 잘못된 경우, 기본값은 info으로 설정됩니다.

  • 장황한
  • 정보
  • 경고
  • 오류
  • 중요

기본 설정 및 요구 사항 설정

일부 설정은 아래와 preferences아래에 requirements 중복됩니다.

  • 이 설정은 preferences 수행할 옵션을 선택할 때 사용 가능한 다양한 옵션을 정렬하는 방법을 제어합니다. 예를 들어 패키지 설치의 기본 범위는 현재 사용자에 대한 것이지만 옵션이 아닌 경우 컴퓨터 수준 설치 관리자가 선택됩니다.
  • 이 설정은 requirements 옵션을 필터링하여 빈 목록과 설치 실패를 초래할 수 있습니다. 이전 예제에서 사용자 범위 요구 사항으로 인해 적용 가능한 설치 관리자가 없으며, 이로 인해 오류가 발생합니다.

명령줄에 전달된 모든 인수는 해당 명령의 기간 동안 일치하는 requirement 설정을 효과적으로 초과합니다.

범위

scope 동작은 패키지를 현재 사용자나 전체 컴퓨터에 설치할지의 선택을 제어합니다. 일치하는 매개 변수는 --scope이며, 동일한 값(user 또는 machine)을 사용합니다. 패키지 설치 범위와 관련된 알려진 문제를 참조하세요.

"installBehavior": {
    "preferences": {
        "scope": "user"
    }
},

지역 설정

이 동작은 locale 설치 관리자 로캘에 따라 설치 관리자 선택을 제어합니다. 일치 매개변수는 --locale이며 bcp47 언어 태그를 사용합니다.

"installBehavior": {
    "preferences": {
        "locale": [ "en-US", "fr-FR" ]
    }
},

아키텍처

이 동작은 architectures 패키지를 설치할 때 선택할 아키텍처를 제어합니다. 일치하는 매개 변수가 --architecture입니다. 시스템과 호환되는 아키텍처만 선택할 수 있습니다.

    "installBehavior": {
        "preferences": {
            "architectures": ["x64", "arm64"]
        }
    },

설치 유형

이 동작은 installerTypes 패키지를 설치할 때 선택할 설치 관리자 유형을 제어합니다. 일치하는 매개 변수가 --installer-type입니다.

    "installBehavior": {
        "preferences": {
            "installerTypes": ["msix", "msi"]
        }
    },

설치 동작 설정

설정은 installBehavior 패키지 설치 및 업그레이드(해당하는 경우)의 기본 동작을 제어합니다.

설치노트비활성화

설치 disableInstallNotes 에 성공한 후 설치 정보가 표시되는지 여부를 결정하는 설정입니다. 값이 설정되지 않았거나 잘못된 경우 기본값은 false.

    "installBehavior": {
        "disableInstallNotes": true
    },

portablePackageUserRoot 설정

이 설정은 portablePackageUserRoot 범위 아래에 User 패키지를 설치하기 위한 기본 루트 디렉터리를 정의합니다. portable 설치 관리자 유형이 있는 패키지에만 적용됩니다. 값이 설정되지 않았거나 잘못된 경우 기본값은 %LOCALAPPDATA%/Microsoft/WinGet/Packages/.

이 설정 값은 절대 경로여야 합니다.

    "installBehavior": {
        "portablePackageUserRoot": "C:/Users/FooBar/Packages"
    },

portablePackageMachineRoot 설정

이 설정은 portablePackageMachineRoot 범위 아래에 Machine 패키지를 설치하기 위한 기본 루트 디렉터리를 정의합니다. portable 설치 관리자 유형이 있는 패키지에만 적용됩니다. 값이 설정되지 않았거나 잘못된 경우, 기본값은 %PROGRAMFILES%/WinGet/Packages/으로 설정됩니다.

이 설정 값은 절대 경로여야 합니다.

    "installBehavior": {
        "portablePackageMachineRoot": "C:/Program Files/Packages/Portable"
    },

디폴트 설치 루트

defaultInstallRoot 설치 위치를 지정하지 않은 경우 명시적 설치 경로가 필요한 패키지의 기본 설치 위치를 지정합니다.

maxResumes

이 설정은 maxResumes 단일 이력서 ID에 허용되는 최대 다시 시작 시도 횟수를 지정합니다. 다시 부팅이 필요한 설치가 제대로 검색되지 않은 경우 연속 재부팅을 방지합니다.

아카이브 추출 방법

이 설정은 archiveExtractionMethod 설치 관리자가 보관 파일을 추출하는 방법을 제어합니다. 지원되는 값은 shellApitar.

  • shellApi 에서는 Windows Shell API를 사용하여 보관 파일을 추출합니다.

  • tar 는 tar 명령을 사용하여 보관 파일을 추출합니다.

UninstallBehavior

이 설정은 uninstallBehavior 기본 제거 프로세스가 이 패키지와 관련된 모든 파일 및 디렉터리를 제거하는지 여부를 제어합니다. 휴대용 installerType에만 적용됩니다.

휴대용 패키지 삭제

이 설정은 purgePortablePackage 이식 가능한 패키지를 제거하는 기본 동작을 제어합니다. true설정하면 제거는 portable 패키지와 관련된 모든 파일 및 디렉터리를 제거합니다. 이 설정은 설치 관리자 유형이 있는 패키지에 portable 만 적용됩니다. 값이 설정되지 않았거나 잘못된 경우 기본값은 false.

    "uninstallBehavior": {
        "purgePortablePackage": true
    },

ConfigureBehavior

이 설정은 ConfigureBehavior 구성을 적용할 때 PowerShell 모듈이 설치되는 기본 루트 디렉터리를 지정합니다.

다운로드 행동

설정은 downloadBehavior 설치 관리자가 다운로드되는 기본 디렉터리를 제어합니다.

기본 다운로드 디렉토리

이 설정은 defaultDownloadDirectory 패키지가 다운로드되는 기본 디렉터리를 제어합니다. 값이 설정되지 않았거나 잘못된 경우 기본값은 %USERPROFILE%/Downloads.

이 설정 값은 절대 경로여야 합니다.

    "downloadBehavior": {
        "defaultDownloadDirectory": "C:/Users/FooBar/Downloads"
    },

텔레메트리 설정

설정은 telemetry WinGet이 Windows의 기본 설치 시 Microsoft로 전송될 수 있는 ETW 이벤트를 쓸지 여부를 제어합니다.

원격 분석세부 정보 및 기본 개인 정보 취급 방침참조하세요.

비활성화

"telemetry": {
    "disable": true
},

true telemetry.disable 로 설정하면 프로그램에서 이벤트를 기록하지 못하게 됩니다.

네트워크 설정

이 설정은 network WinGet에서 네트워크를 사용하여 패키지 및 메타데이터를 검색하는 방법에 영향을 줍니다.

다운로드기

이 설정은 downloader 패키지를 다운로드할 때 사용되는 코드를 제어합니다. 기본값은 do그룹 정책에서 관리할 수 있는 것입니다.

wininet는 WinINet API를 사용하고, do는 배달 최적화 서비스를 사용합니다.

"network": {
    "downloader": "wininet"
}

doProgressTimeoutInSeconds

doProgressTimeoutInSeconds는 진행 없이 대기할 시간(초)을 설정하여 대체 조치를 시작합니다.

상호 작용

이 설정은 Interactivity Windows 패키지 관리자 클라이언트에서 대화형 프롬프트를 표시할지 여부를 제어합니다.

실험적 기능 사용

사용할 수 있는 실험적 기능을 검색하려면 사용 가능한 실험적 기능을 볼 수 있는 위치로 이동합니다 https://aka.ms/winget-settings .