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