応答ファイルを使用したプログラムによる既定の設定の構成

適用対象:yesVisual Studio noVisual Studio for Mac noVisual Studio Code

Visual Studio 応答ファイルは、コマンドライン パラメーターと引数を反映する内容を持つ JSON ファイルです。 応答ファイルは、製品をクライアントに最初にインストールするときに、クライアント設定を初期化するために使用されます。

インストールの自動化

Visual Studio を展開する管理者は、次の例のように --in パラメーターを使用して応答ファイルを指定できます。

vs_enterprise.exe --in customInstall.json

応答ファイルの内容

応答ファイルには、コマンドライン パラメーターがカプセル化されており、次の一般的な規則が適用されます。

  • コマンド ライン パラメーターが引数を取らない場合 (--quiet--passive など)、応答ファイルの値は true/false にしてください。
  • パラメーターが引数を取る場合 (--installPath <dir> など)、応答ファイルの値は文字列にしてください。
  • パラメーターが引数を取り、コマンド ラインに何回も出てくる場合 (--add <id> など)、応答ファイルの値は文字列の配列にしてください。

コマンド ラインで指定されているパラメーターは、パラメーターが複数入力を受け付ける場合 (--add など) を除き、応答ファイルに含まれる設定をオーバーライドします。 複数入力がある場合、コマンドラインで指定された入力が応答ファイルの設定と結合されます。

ネットワーク レイアウトで使用される応答ファイルを構成する

--layoutコマンドを使用してネットワークレイアウトを作成した場合は、最初の既定のバニラ response.json ファイルがレイアウト フォルダーのルートに作成されています。 管理者は、レイアウト内のこのresponse.jsonファイルを変更して、クライアントに Visual Studio をインストールまたは更新するために、クライアントがそのレイアウトでブートストラップを起動するときに使用する設定を制御することができます。

response.jsonファイルの構成設定は、 クライアントがレイアウトでブートストラップを使用している場合にのみ参照および使用されます。 クライアントがクライアント上で更新プログラムをローカルで起動している場合、レイアウト内のresponse.jsonは使用されません

管理者が部分レイアウトを作成した場合は、部分レイアウトに含まれていたワークロードと言語のみが既定のresponse.jsonファイルによって指定されます。

クライアントが最初のインストールを実行しているときに--quietモードが使用されていない場合、初期インストールを実行するユーザーは、response.jsonに指定されている既定値を上書き し、インストールが実際に実行される前にすべてのワークロードをセットアップ UI で選択または選択解除できます。 ユーザーが、レイアウトで使用できないコンポーネントまたはワークロードを選択した場合、response.jsonの channelURI が Microsoft ホステッドサーバーをポイントすると、Visual Studio セットアップはインターネットからパッケージを取得しようとします。

Visual Studio セットアップをレイアウト フォルダーから実行すると、レイアウト フォルダーのresponse.jsonファイルが自動的に使用されます。 --in オプションを使用する必要はありません。

警告

レイアウトが作成されたときに定義されたresponse.jsonのプロパティを削除しないことが重要です。 値を変更することはできますが、項目を削除することはできません。

レイアウトの基本 response.json ファイルは、次の例のようになります。ただし、インストールする製品とチャネルの値は異なります。

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "https://aka.ms/vs/16/release/channel",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.16.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise"
}
{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "https://aka.ms/vs/17/release/channel",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.17.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise"
}
{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "https://aka.ms/vs/17/release.ltsc.17.0/channel",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.17.Release.LTSC.17.0",
  "productId": "Microsoft.VisualStudio.Product.Enterprise"
}

レイアウトを作成または更新すると、response.template.json ファイルも作成されます。 このファイルには、使用できるワークロード、コンポーネント、言語 ID がすべて含まれています。 このファイルは、カスタム インストールに含められるものすべてのテンプレートとして提供されます。 管理者は、このファイルを元にカスタム応答ファイルを作成できます。 インストール対象でないものの ID を削除して、response.jsonファイルまたは自分の応答ファイルに保存するだけです。 response.template.json をカスタマイズしないでください。レイアウトが更新されるたびに変更内容が失われます。

カスタマイズされたレイアウト応答ファイルの内容の例

次の response.json ファイル例では、Visual Studio Enterprise クライアント インストールを初期化して、いくつかの一般的なワークロードとコンポーネントを含め、英語とフランス語の両方の UI 言語を含め、レイアウトをポイントするように更新場所を構成します。 Visual Studio 2019 では、更新の場所 (channeluri) は初回インストール時にのみ構成できます。また、最新のインストーラーで機能を使用しない限り、変更することはできません。 この構成方法については、「Visual Studio のエンタープライズ展開に既定値を設定する」と常に最新のインストーラーを含め、提供するためのレイアウトの構成に関するページを参照してください。

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "\\\\server\\share\\layoutdirectory\\ChannelManifest.json",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.16.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise",

  "installPath": "C:\\VS2019",
  "quiet": false,
  "passive": false,
  "includeRecommended": true,
  "norestart": false,

  "addProductLang": [
    "en-US",
    "fr-FR"
    ],

    "add": [
        "Microsoft.VisualStudio.Workload.ManagedDesktop",
        "Microsoft.VisualStudio.Workload.Data",
        "Microsoft.VisualStudio.Workload.NativeDesktop",
        "Microsoft.VisualStudio.Workload.NetWeb",
        "Microsoft.VisualStudio.Workload.Office",
        "Microsoft.VisualStudio.Workload.Universal",
        "Component.GitHub.VisualStudio"
    ]
}

次の response.json ファイル例では、Visual Studio Enterprise クライアント インストールを初期化して、いくつかの一般的なワークロードとコンポーネントを含め、英語とフランス語の両方の UI 言語を含め、レイアウトをポイントするように更新場所を構成します。

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "\\\\server\\share\\layoutdirectory\\ChannelManifest.json",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.17.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise",

  "installPath": "C:\\VS2022",
  "quiet": false,
  "passive": false,
  "includeRecommended": true,
  "norestart": false,

  "addProductLang": [
    "en-US",
    "fr-FR"
    ],

    "add": [
        "Microsoft.VisualStudio.Workload.ManagedDesktop",
        "Microsoft.VisualStudio.Workload.Data",
        "Microsoft.VisualStudio.Workload.NativeDesktop",
        "Microsoft.VisualStudio.Workload.NetWeb",
        "Microsoft.VisualStudio.Workload.Office",
        "Microsoft.VisualStudio.Workload.Universal"
    ]
}

トラブルシューティング

Visual Studio ブートストラップを response.json ファイルとペアリングしている場合にエラーがスローされる問題が発生した場合の詳細については、Visual Studio をインストールまたは使用するときのネットワーク関連のエラーのトラブルシューティングに関する記事を参照してください。

サポートまたはトラブルシューティング

ときには、問題が発生してしまうことがあります。 Visual Studio のインストールが失敗した場合は、「Visual Studio のインストールとアップグレードの問題のトラブルシューティング」に記載されているステップ バイ ステップ ガイドをご覧ください。

他のいくつかのサポート オプションを次に示します。

関連項目