winget source コマンド
winget ツールの source コマンドを使用すると、Windows パッケージ マネージャーのソースを管理できます。 source コマンドを使用すると、リポジトリの追加、一覧表示、更新、削除、リセット、またはエクスポートを実行できます。
ソース リポジトリは、アプリケーションを検出してインストールするためのデータを提供します。 セキュリティで保護された信頼できるソースの場所のみを使用してください。
Windows パッケージ マネージャーでは、次の 2 つの既定のリポジトリが指定されます。これらは、winget source list を使用して一覧表示できます。
- msstore - Microsoft Store カタログ。
- winget - Windows パッケージ マネージャー アプリ リポジトリ。
使用方法
winget source <subcommand> <options>
引数
次の引数を使用できます。
| 引数 | 説明 |
|---|---|
| -?、--help | このコマンドに関する追加のヘルプを取得します。 |
次の図は、source コマンドのヘルプを示しています。
サブコマンド
source コマンドは、次のサブコマンドをサポートしています。
| サブコマンド | 説明 |
|---|---|
| add | 新しいソースを追加します。 |
| list | 有効なソースの一覧を列挙します。 |
| update | ソースを更新します。 |
| remove | ソースを削除します。 |
| reset | winget と msstore を初期構成にリセットします。 |
| export | 現在のソースをエクスポートします。 |
add
add サブコマンドは、新しいソースを追加します。 このサブコマンドには、--name と --arg のオプションが必要です。 このコマンドによってユーザー アクセスが変更されるため、add を使用するには、管理者特権が必要です。
用途:
winget source add [-n, --name] <name> [-a, --arg] <url> [[-t, --type] <type>]
たとえば、winget source add --name Contoso https://www.contoso.com/cache は、CONTOSO リポジトリを URL https://www.contoso.com/cache に追加します。
省略可能な type パラメーター
add サブコマンドでは、省略可能な type パラメーターがサポートされています。これは、接続先のリポジトリーの種類をクライアントに伝えます。 次の種類がサポートされています。
| Type | 説明 |
|---|---|
| Microsoft.PreIndexed.Package | 既定のソースの種類です。 |
list
list サブコマンドは、現在有効になっているソースを列挙するか、特定のソースの詳細を提供します。
用途:
winget source list [[-n, --name] <name>]
list all
list サブコマンド単独の場合 (winget source list)、サポートされているソースの完全一覧が提供されます。
Name Arg
-----------------------------------------
winget https://winget.azureedge.net/cache
list source details
ソースに関する完全な詳細を取得するには、ソースの名前を渡します。 次に例を示します。
winget source list --name Contoso
次の出力が返されます。
Name : Contoso
Type : Microsoft.PreIndexed.Package
Arg : https://pkgmgr-int.azureedge.net/cache
Data : AppInstallerSQLiteIndex-int_g4ype1skzj3jy
Updated: 2020-4-14 17:45:32.000
Nameはソースの名前です。Typeは、リポジトリの種類です。Argは、ソースが使用する URL またはパスです。Dataは、省略可能なパッケージ名です (該当する場合)。Updatedは、ソースが最後に更新された日時です。
update
update サブ コマンドは、個々のソースまたはすべてに対して更新を強制します。
用途:
winget source update [[-n, --name] <name>]
update all
update サブコマンド単独の場合 (winget source update)、すべてのリポジトリに対する更新を要求します。
更新ソース
--name オプションを指定した update サブコマンドは、名前を指定されたソースに更新を指示します。 たとえば、winget source update --name Contoso により、Contoso リポジトリへの更新が強制されます。
remove
remove サブコマンドは、ソースを削除します。 このサブコマンドでは、ソースを識別するために、--name オプションが必要です。 このコマンドによってユーザー アクセスが変更されるため、remove を使用するには、管理者特権が必要です。
用途:
winget source remove [-n, --name] <name>
たとえば、winget source remove --name Contoso により Contoso リポジトリが削除されます。
reset
reset サブコマンドは、クライアントを元の構成にリセットし、デフォルトを除くすべてのソースを削除します。 このサブコマンドは稀なケースでのみ使用してください。 このコマンドによってユーザー アクセスが変更されるため、reset を使用するには、管理者特権が必要です。
reset コマンドによってすべてのソースが削除されるため、--force オプションを使用してアクションを強制する必要があります。
用途:
winget source reset --force
エクスポート
export サブコマンドは、ソースの特定の詳細を JSON 出力にエクスポートしま。
次に例を示します。
winget source export winget
次の出力が返されます。
{"Arg":"https://winget.azureedge.net/cache","Data":"Microsoft.Winget.Source_8wekyb3d8bbwe","Identifier":"Microsoft.Winget.Source_8wekyb3d8bbwe","Name":"winget","Type":"Microsoft.PreIndexed.Package"}
オプション
source コマンドは、次のオプションをサポートしています。
| オプション | 説明 |
|---|---|
| -n、--name | ソースを識別するための名前。 |
| -a、--arg | ソースの URL または UNC。 |
| --force | リセットが必要であることを確認するために reset で使用されます。 |
| -t、--type | ソースの種類。 |
| --accept-source-agreements | ソースの使用許諾契約に同意し、プロンプトを回避します。 |
| --header | 省略可能な Windows-Package-Manager REST ソースの HTTP ヘッダー。 |
| --verbose-logs | ログ設定をオーバーライドし、詳細ログを作成します。 |
| -?、--help | このコマンドに関する追加のヘルプを取得します。 |
ソースの契約
個々のソースでは、リポジトリを追加または使用する前に、提示された条件にユーザーが同意することが要求される場合があります。 ユーザーが契約に同意しない場合、ユーザーはソースにアクセスできません。
--accept-source-agreements オプションを使用して、ソースのライセンス契約に同意し、プロンプトを回避できます。
