settings 명령(winget)

  • 아티클

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

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

참고 항목

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

별칭

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

  • config

winget settings 명령 사용

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

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

아래 코드 조각은 이러한 실험적 기능 및 설정 중 일부를 사용하거나 수정하려는 경우 설정 파일의 모양을 보여주는 예제입니다.

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

    // For documentation on these settings, see: https://aka.ms/winget-settings
    "experimentalFeatures": {
	  "dependencies": true,
	  "directMSI": false,
	  "zipInstall": false,
    },
    "visual": {
        "progressBar": "rainbow"
    },
    "source": {
        "autoUpdateIntervalInMinutes": 5
    },
}

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

참고 항목

실험적 기능은 미리 보기 빌드에서만 사용할 수 있습니다. 미리 보기 빌드를 가져오기 위한 지침은 GitHub 리포지토리에서 찾을 수 있습니다.

설정을 업데이트하는 중

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

source 설정

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

"source": {
    "autoUpdateIntervalInMinutes": 3
},

autoUpdateIntervalInMinutes

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

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

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

visual 설정

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

"visual": {
    "progressBar": "accent"
},

progressBar

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

  • 강조색(기본값)
  • 레트로
  • 무지개

installBehavior 설정

installBehavior 설정은 패키지에 대한 설치 및 업그레이드의 기본 동작에 영향을 미칩니다(해당하는 경우).

disableInstallNotes

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"
    },

preferences 및 requirements 설정

일부 설정은 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

이 installerTypes 동작은 패키지를 설치할 때 선택되는 설치 프로그램 유형 영향을 줍니다. 일치하는 매개 변수는 --installer-type입니다.

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

uninstallBehavior

uninstallBehavior 설정은 패키지 제거(해당하는 경우)의 기본 동작에 영향을 줍니다.

purgePortablePackage

purgePortablePackage 동작은 이식 가능한 패키지를 제거하는 기본 동작에 영향을 줍니다. true로 설정하면 portable 패키지와 관련된 모든 파일 및 디렉터리가 제거됩니다. 이 설정은 설치 관리자 유형이 portable인 패키지에만 적용됩니다. 값을 설정하지 않았거나 값이 유효하지 않으면 기본적으로 false로 설정됩니다.

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

downloadBehavior

설정은 downloadBehavior 패키지 다운로드의 기본 동작에 영향을 줍니다.

defaultDownloadDirectory

이 설정은 defaultDownloadDirectory 패키지를 다운로드하는 기본 디렉터리에 영향을 줍니다. 값을 설정하지 않았거나 값이 유효하지 않으면 기본적으로 %USERPROFILE%/Downloads로 설정됩니다.

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

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

telemetry 설정

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

원격 분석에 대한 세부 정보 및 기본 개인정보처리방침을 참조하세요.

disable

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

true로 설정하면 telemetry.disable 설정으로 인해 프로그램에서 이벤트를 기록할 수 없습니다.

네트워크 설정

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

다운로더

downloader 설정은 패키지를 다운로드할 때 사용되는 코드를 제어합니다. 기본값은 default이며, 결정에 따라 옵션 중 하나가 될 수 있습니다.

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

"network": {
    "downloader": "do"
}

logging 설정

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

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

level

다음 로깅 수준을 사용할 수 있습니다. 값이 설정되지 않았거나 유효하지 않은 경우 기본값은 info로 설정됩니다.

  • verbose
  • 정보
  • warning
  • error
  • 중요

실험적 기능 사용

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