winget source コマンド

winget ツールの source コマンドを使用すると、Windows パッケージ マネージャーのソースを管理できます。 source コマンドを使用すると、リポジトリの追加一覧表示更新削除リセット、またはエクスポートを実行できます。

ソース リポジトリは、アプリケーションを検出してインストールするためのデータを提供します。 セキュリティで保護された信頼できるソースの場所のみを使用してください。

Windows パッケージ マネージャーでは、次の 2 つの既定のリポジトリが指定されます。これらは、winget source list を使用して一覧表示できます。

  • msstore - Microsoft Store カタログ。
  • winget - Windows パッケージ マネージャー アプリ リポジトリ。

使用方法

winget source <subcommand> <options>

引数

次の引数を使用できます。

引数 説明
-?、--help このコマンドに関する追加のヘルプを取得します。

次の図は、source コマンドのヘルプを示しています。

Screenshot showing help for the source command.

サブコマンド

source コマンドは、次のサブコマンドをサポートしています。

サブコマンド 説明
add 新しいソースを追加します。
list 有効なソースの一覧を列挙します。
update ソースを更新します。
remove ソースを削除します。
reset wingetmsstore を初期構成にリセットします。
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 オプションを使用して、ソースのライセンス契約に同意し、プロンプトを回避できます。

Screenshot showing a source license prompt.