winget source コマンド
winget ツールの source コマンドを使用すると、Windows パッケージ マネージャーのソースを管理できます。 source コマンドを使用すると、リポジトリの追加、一覧表示、更新、削除、リセット、またはエクスポートを実行できます。
ソース リポジトリは、アプリケーションを検出してインストールするためのデータを提供します。 セキュリティで保護された信頼できるソースの場所のみを使用してください。
Windows パッケージ マネージャーでは、次の 2 つの既定のリポジトリが指定されます。これらは、winget source list を使用して一覧表示できます。
- msstore - Microsoft Store カタログ。
- winget - Windows パッケージ マネージャー アプリ リポジトリ。
使用
winget source <subcommand> <options>
引数
次の引数を使用できます。
| 引数 | 説明 |
|---|---|
| -?、--help | このコマンドに関する追加のヘルプを取得します。 |
次の図は、source コマンドのヘルプを示しています。
[オプション]
次のオプションを使用できます。
| オプション | 説明 |
|---|---|
| -?,--help | 選択したコマンドに関するヘルプを表示します。 |
| --wait | 終了する前に任意のキーを押すようユーザーに求めます。 |
| --logs,--open-logs | 既定のログの場所を開きます。 |
| --verbose, --verbose-logs | ログ記録設定をオーバーライドし、詳細ログを作成します。 |
| --nowarn、--ignore-warnings | 警告の出力を抑制します。 |
| --disable-interactivity | 対話型プロンプトを無効にします。 |
| --proxy | この実行に使用するプロキシを設定します。 |
| --no-proxy | この実行に対してプロキシの使用を無効にします。 |
サブコマンド
source コマンドは、次のサブコマンドをサポートしています。
| サブコマンド | 説明 |
|---|---|
| add | 新しいソースを追加します。 |
| list | 有効なソースの一覧を列挙します。 |
| update | ソースを更新します。 |
| remove | ソースを削除します。 |
| reset | winget と msstore を初期構成にリセットします。 |
| export | 現在のソースをエクスポートします。 |
add
add サブコマンドは、新しいソースを追加します。 このサブコマンドには、--name と --arg のオプションが必要です。 このコマンドによってユーザー アクセスが変更されるため、add を使用するには、管理者特権が必要です。
使用法:
winget source add [-n] <name> [-a] <arg> [[-t] <type>] [<options>]
引数
次の引数を使用できます。
| 引数 | 説明 |
|---|---|
| -n, --name | ソースを識別するための名前。 |
| -a, --arg | ソースの URL または UNC。 |
| -t、--type | ソース の種類。 |
Options
次のオプションを使用できます。
| オプション | 説明 |
|---|---|
| --trust-level | ソースの信頼レベル (none または trusted)。 |
| --header | 省略可能な Windows-Package-Manager REST ソースの HTTP ヘッダー。 |
| --accept-source-agreements | ソースの使用許諾契約に同意し、プロンプトを回避するために使用されます。 |
| --explicit | |
| -?、--help | このコマンドに関する追加のヘルプを取得します。 |
| --wait | 終了する前に任意のキーを押すようユーザーに求めます。 |
| --logs,--open-logs | 既定のログの場所を開きます。 |
| --verbose, --verbose-logs | ログ記録設定をオーバーライドし、詳細ログを作成します。 |
| --nowarn、--ignore-warnings | 警告の出力を抑制します。 |
| --disable-interactivity | 対話型プロンプトを無効にします。 |
| --proxy | この実行に使用するプロキシを設定します。 |
| --no-proxy | この実行に対してプロキシの使用を無効にします。 |
たとえば、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>] [<options>]
Aliases
このサブコマンドでは、次のエイリアスを使用できます。
- ls
引数
次の引数を使用できます。
| 引数 | 説明 |
|---|---|
| -n, --name | ソースを識別するための名前。 |
Options
次のオプションを使用できます。
| オプション | 説明 |
|---|---|
| -?、--help | このコマンドに関する追加のヘルプを取得します。 |
| --wait | 終了する前に任意のキーを押すようユーザーに求めます。 |
| --logs,--open-logs | 既定のログの場所を開きます。 |
| --verbose, --verbose-logs | ログ記録設定をオーバーライドし、詳細ログを作成します。 |
| --nowarn、--ignore-warnings | 警告の出力を抑制します。 |
| --disable-interactivity | 対話型プロンプトを無効にします。 |
| --proxy | この実行に使用するプロキシを設定します。 |
| --no-proxy | この実行に対してプロキシの使用を無効にします。 |
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>] [<options>]
Aliases
このサブコマンドでは、次のエイリアスを使用できます。
- 最新の情報に更新
引数
次の引数を使用できます。
| 引数 | 説明 |
|---|---|
| -n, --name | ソースを識別するための名前。 |
Options
次のオプションを使用できます。
| オプション | 説明 |
|---|---|
| -?、--help | このコマンドに関する追加のヘルプを取得します。 |
| --wait | 終了する前に任意のキーを押すようユーザーに求めます。 |
| --logs,--open-logs | 既定のログの場所を開きます。 |
| --verbose, --verbose-logs | ログ記録設定をオーバーライドし、詳細ログを作成します。 |
| --nowarn、--ignore-warnings | 警告の出力を抑制します。 |
| --disable-interactivity | 対話型プロンプトを無効にします。 |
| --proxy | この実行に使用するプロキシを設定します。 |
| --no-proxy | この実行に対してプロキシの使用を無効にします。 |
update all
update サブコマンド単独の場合 (winget source update)、すべてのリポジトリに対する更新を要求します。
更新ソース
--name オプションを指定した update サブコマンドは、名前を指定されたソースに更新を指示します。 たとえば、winget source update --name Contoso により、Contoso リポジトリへの更新が強制されます。
remove
remove サブコマンドは、ソースを削除します。 このサブコマンドでは、ソースを識別するために、--name オプションが必要です。 このコマンドによってユーザー アクセスが変更されるため、remove を使用するには、管理者特権が必要です。
使用法:
winget source remove [-n] <name> [<options>]
Aliases
このサブコマンドでは、次のエイリアスを使用できます。
- rm
引数
次の引数を使用できます。
| 引数 | 説明 |
|---|---|
| -n, --name | ソースを識別するための名前。 |
Options
次のオプションを使用できます。
| オプション | 説明 |
|---|---|
| -?、--help | このコマンドに関する追加のヘルプを取得します。 |
| --wait | 終了する前に任意のキーを押すようユーザーに求めます。 |
| --logs,--open-logs | 既定のログの場所を開きます。 |
| --verbose, --verbose-logs | ログ記録設定をオーバーライドし、詳細ログを作成します。 |
| --nowarn、--ignore-warnings | 警告の出力を抑制します。 |
| --disable-interactivity | 対話型プロンプトを無効にします。 |
| --proxy | この実行に使用するプロキシを設定します。 |
| --no-proxy | この実行に対してプロキシの使用を無効にします。 |
例
winget source remove --name Contoso
このコマンドを実行すると、Contoso リポジトリが削除されます。
reset
reset サブコマンドは、クライアントを元の構成にリセットし、デフォルトを除くすべてのソースを削除します。 このサブコマンドは稀なケースでのみ使用してください。 このコマンドによってユーザー アクセスが変更されるため、reset を使用するには、管理者特権が必要です。
reset コマンドによってすべてのソースが削除されるため、--force オプションを使用してアクションを強制する必要があります。
使用法:
winget source reset [[-n] <name>] [<options>]
引数
次の引数を使用できます。
| 引数 | 説明 |
|---|---|
| -n, --name | ソースを識別するための名前。 |
Options
次のオプションを使用できます。
| オプション | 説明 |
|---|---|
| --force | ソースのリセットを強制します。 |
| -?、--help | このコマンドに関する追加のヘルプを取得します。 |
| --wait | 終了する前に任意のキーを押すようユーザーに求めます。 |
| --logs,--open-logs | 既定のログの場所を開きます。 |
| --verbose, --verbose-logs | ログ記録設定をオーバーライドし、詳細ログを作成します。 |
| --nowarn、--ignore-warnings | 警告の出力を抑制します。 |
| --disable-interactivity | 対話型プロンプトを無効にします。 |
| --proxy | この実行に使用するプロキシを設定します。 |
| --no-proxy | この実行に対してプロキシの使用を無効にします。 |
エクスポート
export サブコマンドは、ソースの特定の詳細を JSON 出力にエクスポートしま。
使用法:
winget source export [[-n] <name>] [<options>]
引数
次の引数を使用できます。
| 引数 | 説明 |
|---|---|
| -n, --name | ソースを識別するための名前。 |
Options
次のオプションを使用できます。
| オプション | 説明 |
|---|---|
| -?、--help | このコマンドに関する追加のヘルプを取得します。 |
| --wait | 終了する前に任意のキーを押すようユーザーに求めます。 |
| --logs,--open-logs | 既定のログの場所を開きます。 |
| --verbose, --verbose-logs | ログ記録設定をオーバーライドし、詳細ログを作成します。 |
| --nowarn、--ignore-warnings | 警告の出力を抑制します。 |
| --disable-interactivity | 対話型プロンプトを無効にします。 |
| --proxy | この実行に使用するプロキシを設定します。 |
| --no-proxy | この実行に対してプロキシの使用を無効にします。 |
例
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"}
ソースの契約
個々のソースでは、リポジトリを追加または使用する前に、提示された条件にユーザーが同意することが要求される場合があります。 ユーザーが契約に同意しない場合、ユーザーはソースにアクセスできません。
--accept-source-agreements オプションを使用して、ソースのライセンス契約に同意し、プロンプトを回避できます。
関連トピック
Windows developer