install の コマンドは、指定されたアプリケーションをインストールします。 検索コマンドを使用して、installするアプリケーションを特定します。 show コマンドを使用して、システムの WinGet によって選択されたアプリケーションとインストーラーに関する詳細を表示します。
install コマンドでは、installする正確な文字列を指定する必要があります。 あいまいさがある場合は、 install コマンドをさらにフィルター処理して、正確なアプリケーションにするように求められます。
使用方法
winget install [[-q] <query> ...] [<options>]
エイリアス
このコマンドでは、次のエイリアスを使用できます。
add
引数
次の引数を使用できます。
| 引数 | 説明 |
|---|---|
| -q、--query | アプリを検索するために使用するクエリ。 |
Note
query 引数は位置指定です。 既定では、 winget はパッケージ名、ID、モニカーに対して大文字と 小文字を区別しない部分文字列の一致 を実行します。 ワイルドカード構文はサポートされていません。 完全一致を要求するには 、-e --exact を使用します (大文字と小文字が区別されます)。 --id、--name、または--monikerを使用して、検索するフィールドを制限します。
オプション
オプションを使用すると、ニーズに合わせて install エクスペリエンスをカスタマイズできます。
| 回答内容 | 説明 |
|---|---|
| -m, --manifest | この後にマニフェスト (YAML) ファイルのパスを指定する必要があります。 マニフェストを使用して、installから エクスペリエンスを実行できます。 |
| --id | installをアプリケーションの ID に制限します。 |
| --name | 検索をアプリケーションの名前に限定します。 |
| --moniker | 検索をアプリケーション用に一覧表示されているモニカーに限定します。 |
| -v, --version | install の特定のバージョンを指定できます。 指定しない場合、latest は最もバージョン番号の高いアプリケーションを install します。 |
| -s, --source | 指定した source 名に検索を制限します。 その後に source 名を付ける必要があります。 |
| --scope | インストーラーでユーザーまたはコンピューターのスコープをターゲットにする必要がある場合に指定できます。 パッケージのインストール スコープに関する既知の問題を参照してください。 |
| -a, --architecture | installするアーキテクチャを選択します。 |
| --installer-type | インストーラーの種類を選択してinstallします。 WinGet クライアントでサポートされているインストーラーの種類に関する記述を参照してください。 |
| -e, --exact | 大文字小文字の区別の検査を含め、クエリで正確な文字列を使用します。 部分文字列の既定の動作は使用されません。 |
| -i, --interactive | 対話型モードでインストーラーを実行します。 既定のエクスペリエンスでは、インストーラーの進行状況が表示されます。 |
| -h, --silent | サイレント モードでインストーラーを実行します。 これにより、すべての UI が抑制されます。 既定のエクスペリエンスでは、インストーラーの進行状況が表示されます。 |
| --locale | 使用するロケール (BCP47 形式) を指定します。 |
| -o, --log | ログ記録をログ ファイルに送信します。 書き込み権限を持っているファイルへのパスを指定する必要があります。 |
| --custom | 既定値に加えてインストーラーに渡される引数。 |
| --override | インストーラーに直接渡される文字列。 |
| -l、 --location | install先の場所 (サポートされている場合)。 |
| --ignore-security-hash | インストーラーのハッシュ チェック エラーを無視します。 非推奨。 |
| --allow-reboot | 必要に応じて再起動を許可します。 |
| --skip-dependencies | パッケージの依存関係と Windows 機能の処理をスキップします。 |
| --ignore-local-archive-malware-scan | ローカル マニフェストからアーカイブの種類のパッケージをインストールする際に実行されるマルウェア スキャンは無視します。 |
| --dependency-source | 指定した sourceを使用してパッケージの依存関係を検索します。 |
| --accept-package-agreements | パッケージ インストーラーによって提示された使用許諾契約書または EULA を受け入れ、対話型プロンプトを表示しません。 これはパッケージのライセンス条項にのみ適用されます。インストーラーによって提供されるオプションのコンポーネントやバンドルされたソフトウェアには影響しません。 完全に非対話型の installの場合は、 --silent (-h) と組み合わせます。 |
| --no-upgrade | インストールされているバージョンが既に存在する場合は、アップグレードをスキップします。 |
| --header | オプションの Windows Package Manager REST source HTTP ヘッダー。 |
| --authentication-mode | 認証ウィンドウの基本設定 (silent、silentPreferred、interactive のいずれか) を指定します。 |
| --authentication-account | 認証に使用するアカウントを指定します。 |
| --accept-source-agreements | 対話型プロンプトを抑制して、WinGet source (リポジトリ) の使用許諾契約書に同意します。 これはパッケージ ライセンスとは別のものであり、source コミュニティ リポジトリなど、winget自体の使用条件について説明します。 |
| -r, --rename | 実行可能ファイルの名前を変更する値 (移植可能)。 |
| --uninstall-previous | アップグレード中に以前のバージョンのパッケージをアンインストールします。 |
| --force | コマンドを直接実行し、セキュリティ関連以外の問題を続行します。 |
| -?, --help | このコマンドに関する追加のヘルプを取得します。 |
| --wait | 終了する前に任意のキーを押すようユーザーに求めます。 |
| --logs,--open-logs | 既定のログの場所を開きます。 |
| --verbose, --verbose-logs | ログ記録設定をオーバーライドし、詳細ログを作成します。 |
| --nowarn,--ignore-warnings | 警告の出力を抑制します。 |
| --disable-interactivity | 対話型プロンプトを無効にします。 |
| --proxy | この実行に使用するプロキシを設定します。 |
| --no-proxy | この実行に対してプロキシの使用を無効にします。 |
クエリの例
次の例では、アプリケーションの特定のバージョンをインストールします。
winget install powertoys --version 0.91.1
次の例では、アプリケーションをその ID からインストールします。
winget install --id Microsoft.PowerToys
次の例では、バージョンと ID によってアプリケーションをインストールします。
winget install --id Microsoft.PowerToys --version 0.91.1
複数のパッケージをインストールする
1 つのコマンドで複数のパッケージを install 、ID をスペースで区切って一覧表示できます。
winget install Microsoft.VisualStudioCode Microsoft.PowerShell Git.Git
WinGet は、各パッケージを順番にインストールします。 これは、新しいマシンをすばやく設定したり、一連のツールを同僚と共有したりする場合に便利です。
ヒント
多数のパッケージを扱う場合は、winget export と winget import を使用して完全なパッケージ一覧を保存および復元するか、winget configure を使用して、パッケージを他のマシン構成と一緒に 1 つのファイルで install することを検討してください。
結果のあいまいさを解消する
WinGet に指定されたクエリが 1 つのアプリケーションにならない場合、WinGet は検索結果を表示します。 これにより、正しい installの検索を絞り込むために必要な追加データが提供されます。
選択を 1 つのファイルに限定するには、正確なクエリ オプションと組み合わせてアプリケーションの ID を使用するのが最善です。 次に例を示します。
winget install --id Git.Git -e
複数のソースが構成されている場合は、エントリが重複している可能性があります。 さらにあいまいさを解消するには、 source を指定する必要があります。
winget install --id Git.Git -e --source winget
msstoresource では、パッケージの "ID" として一意の識別子が使用されます。 これらには 、正確な クエリ オプションは必要ありません。 次に例を示します。
winget install XP9KHM4BK9FZ7Q -s msstore
ローカル install
マニフェスト オプションを使用すると、YAML ファイルをクライアントに直接渡すことで、アプリケーションをinstallできます。 マニフェストがマルチファイル マニフェストの場合、ファイルが格納されているディレクトリを使用する必要があります。 manifest オプションには次の使用法があります。
使用法: winget install --manifest \<path>
| 回答内容 | 説明 |
|---|---|
| -m, --manifest | installするアプリケーションのマニフェストへのパス。 |
ローカル マニフェスト ファイルからパッケージをインストールする操作にはリスクが伴います。 予防措置として、この機能は管理者が有効にする必要があります。 この機能を有効にするには、winget settings --enable LocalManifestFiles を実行します。 この機能を無効にするには、winget settings --disable LocalManifestFiles を実行します。
ログ ファイル
リダイレクトされない限り、WinGet のログ ファイルは次のフォルダーにあります。 \%LOCALAPPDATA%\\Packages\\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\\LocalState\\DiagOutputDir\\*.log
使用許諾契約
一部のアプリケーションでは、インストール前に、ライセンスやその他の契約に同意するように求められます。 このような場合、Windows パッケージ マネージャーにより、契約への同意がユーザーに求められます。 ユーザーが同意しない場合、アプリケーションは installされません。
コマンド ラインから、コマンド ラインで次のオプション --accept-package-agreements を渡すことで、契約に自動的に同意できます。 これは、Windows パッケージ マネージャーのスクリプトを作成するときに役立ちます。
関連トピック
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
Windows developer