install 명령(winget)

winget 도구의 install 명령은 지정된 애플리케이션을 설치합니다. search 명령을 사용하여 설치하려는 애플리케이션을 식별합니다.

install 명령을 사용하려면 설치하기 위한 정확한 문자열을 지정해야 합니다. 문자열이 명확하지 않으면 install 명령을 정확한 애플리케이션으로 추가로 필터링하라는 메시지가 표시됩니다.

사용

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

별칭

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

• add

인수

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

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

참고 항목

쿼리 인수는 위치를 나타냅니다. 와일드카드 스타일 구문은 지원되지 않습니다. 이는 설치하려는 패키지를 고유하게 식별한다고 가장 자주 예상되는 문자열입니다.

옵션

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

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

예제 쿼리

다음 예제에서는 애플리케이션의 특정 버전을 설치합니다.

winget install powertoys --version 0.15.2

다음 예제에서는 해당 ID에서 애플리케이션을 설치합니다.

winget install --id Microsoft.PowerToys

다음 예제에서는 버전 및 ID별로 애플리케이션을 설치합니다.

winget install --id Microsoft.PowerToys --version 0.15.2

여러 선택 항목

winget에 제공된 쿼리로 인해 단일 애플리케이션이 생성되지 않으면 winget에서 검색 결과를 표시합니다. 이 경우 올바른 설치를 위해 검색을 구체화하는 데 필요한 추가 데이터가 제공됩니다.

선택 항목을 하나의 파일로 제한하는 가장 좋은 방법은 애플리케이션 id를 정확한 쿼리 옵션과 결합하여 사용하는 것입니다. 예:

winget install --id Git.Git -e

여러 원본을 구성하는 경우 중복된 항목이 있을 수 있습니다. 더 명확하게 하려면 원본을 지정해야 합니다.

winget install --id Git.Git -e --source winget

msstore 원본은 고유 식별자를 패키지에 대한 "ID"로 사용합니다. 여기에는 exact 쿼리 옵션이 필요하지 않습니다. 예:

winget install XP9KHM4BK9FZ7Q -s msstore

로컬 설치

manifest 옵션을 사용하면 YAML 파일을 클라이언트에 직접 전달하여 애플리케이션을 설치할 수 있습니다. 매니페스트가 다중 파일 매니페스트이면 파일이 포함된 디렉터리를 사용해야 합니다. manifest 옵션의 사용법은 다음과 같습니다.

사용법: winget install --manifest \<path>

옵션	설명
-m, --manifest	설치할 애플리케이션의 매니페스트에 대한 경로입니다.

참고 항목

로컬 매니페스트 파일에서 패키지를 설치하면 위험할 수 있습니다. 추가 예방 조치로 이 기능은 관리자가 사용하도록 설정해야 합니다. 이 기능을 사용하도록 설정하려면 winget settings --enable LocalManifestFiles를 실행합니다. 이 기능을 사용하지 않도록 설정하려면 winget settings --disable LocalManifestFiles를 실행합니다.

로그 파일

리디렉션되지 않는 경우 winget에 대한 로그 파일은 %temp%\AICLI\*.log 폴더에 있습니다.

사용권 계약

설치 시 일부 애플리케이션은 사용자가 먼저 사용권 계약 또는 기타 계약에 동의한 후에 설치해야 합니다. 이 경우 Windows 패키지 관리자는 사용자에게 계약에 동의하라는 메시지를 표시합니다. 사용자가 동의하지 않으면 애플리케이션이 설치되지 않습니다.

명령줄에서 --accept-package-agreements 옵션을 명령줄에 전달하면 계약에 자동으로 동의할 수 있습니다. 이는 Windows 패키지 관리자를 스크립팅할 때 유용할 수 있습니다.

관련 항목

• winget 도구를 사용하여 애플리케이션 설치 및 관리