install コマンド (winget)
winget ツールの install コマンドは、指定されたアプリケーションをインストールします。 インストールするアプリケーションを特定するには、search コマンドを使用します。
install コマンドでは、インストールする正確な文字列を指定する必要があります。 あいまいさがある場合は、install コマンドを正確なアプリケーションに絞り込むように求めるプロンプトが表示されます。
使用
winget install [[-q] \<query>] [\<options>]
引数
次の引数を使用できます。
| 引数 | 説明 |
|---|---|
| -q、--query | アプリを検索するために使用するクエリ。 |
| -?、--help | このコマンドに関する追加のヘルプを取得します。 |
Note
query 引数は位置指定です。 ワイルドカード スタイルの構文はサポートされていません。 多くの場合、これはインストールするパッケージを一意に識別するために使う文字列です。
オプション
オプションを使用すると、インストール エクスペリエンスをニーズに合わせてカスタマイズできます。
| オプション | 説明 |
|---|---|
| -m、--manifest | この後にマニフェスト (YAML) ファイルのパスを指定する必要があります。 マニフェストを使用して、ローカル YAML ファイルからインストール エクスペリエンスを実行できます。 |
| --id | インストールをアプリケーションの ID に限定します。 |
| --name | 検索をアプリケーションの名前に限定します。 |
| --moniker | 検索をアプリケーション用に一覧表示されているモニカーに限定します。 |
| -v、--version | インストールする正確なバージョンを指定できます。 指定しない場合、latest によって最新バージョンのアプリケーションがインストールされます。 |
| -s、--source | 検索を、指定されたソース名に制限します。 この後にソース名を指定する必要があります。 |
| --scope | インストーラーでユーザーまたはコンピューターのスコープをターゲットにする必要がある場合に指定できます。 パッケージのインストール スコープに関する既知の問題を参照してください。 |
| -a, --architecture | インストールするアーキテクチャを選択します。 |
| -e、--exact | 大文字小文字の区別の検査を含め、クエリで正確な文字列を使用します。 部分文字列の既定の動作は使用されません。 |
| -i、--interactive | 対話型モードでインストーラーを実行します。 既定のエクスペリエンスでは、インストーラーの進行状況が表示されます。 |
| -h、--silent | サイレント モードでインストーラーを実行します。 これにより、すべての UI が抑制されます。 既定のエクスペリエンスでは、インストーラーの進行状況が表示されます。 |
| --locale | 使用するロケール (BCP47 形式) を指定します。 |
| -o、--log | ログ記録をログ ファイルに送信します。 書き込み権限を持っているファイルへのパスを指定する必要があります。 |
| --override | インストーラーに直接渡される文字列。 |
| -l、--location | インストールする場所 (サポートされている場合)。 |
| --force | インストーラーのハッシュ チェックをオーバーライドします。 非推奨。 |
| --accept-package-agreements | 使用許諾契約に同意し、プロンプトを回避するために使用されます。 |
| --accept-source-agreements | ソースの使用許諾契約に同意し、プロンプトを回避するために使用されます。 |
| --header | 省略可能な Windows-Package-Manager REST ソースの HTTP ヘッダー。 |
| -r、--rename | 実行可能ファイルの名前を変更する値 (移植可能) |
| --verbose-logs | ログ記録設定をオーバーライドし、詳細ログを作成します。 |
クエリの例
次の例では、アプリケーションの特定のバージョンをインストールします。
winget install powertoys --version 0.15.2
次の例では、アプリケーションをその ID からインストールします。
winget install --id Microsoft.PowerToys
次の例では、バージョンと ID によってアプリケーションをインストールします。
winget install --id Microsoft.PowerToys --version 0.15.2
複数選択
winget に指定されたクエリの結果が 1 つのアプリケーションでない場合、winget は検索の結果を表示します。 これにより、正しいインストールのために検索を絞り込むうえで必要な追加データが提供されます。
選択を 1 つのファイルに限定するには、正確なクエリ オプションと組み合わせてアプリケーションの 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 | インストールするアプリケーションのマニフェストへのパス。 |
Note
ローカル マニフェスト ファイルからパッケージをインストールする操作にはリスクが伴います。 予防措置として、この機能は管理者が有効にする必要があります。 この機能を有効にするには、winget settings --enable LocalManifestFiles を実行します。 この機能を無効にするには、winget settings --disable LocalManifestFiles を実行します。
ログ ファイル
リダイレクトされない限り、winget のログ ファイルは次のフォルダーに配置されます: %temp%\AICLI\*.log
使用許諾契約
一部のアプリケーションでは、インストール前に、ライセンスやその他の契約に同意するように求められます。 このような場合、Windows パッケージ マネージャーにより、契約への同意がユーザーに求められます。 ユーザーが同意しない場合は、そのアプリケーションはインストールされません。
コマンド ラインから、オプション --accept-package-agreements を渡すことで、契約に自動的に同意することができます。 これは、Windows パッケージ マネージャーのスクリプトを作成するときに役立ちます。