プロキシ設定の構成に関するステップバイステップガイド

2025-06-30

作業環境で、サービスに接続するためにプロキシサーバーを経由するために Microsoft オンプレミスデータゲートウェイが必要な場合は、次の手順を使用してプロキシ設定を構成します。

プロキシ設定の構成

プロキシ定義要素を作成します。 .NET 構成ファイルのプロキシ要素の構成の詳細については、 defaultProxy 要素 (ネットワーク設定) に関するページを参照してください。

次の例では、ポート 8888 の IP アドレス 192.168.0.1 を持つ特定のプロキシ経由ですべての要求をルーティングします。
```
<defaultProxy useDefaultCredentials="true">
    <proxy  
        autoDetect="false"  
        proxyaddress="http://192.168.0.1:8888"
        bypassonlocal="false"
        usesystemdefault="false"
    />
</defaultProxy>
```
オンプレミスデータゲートウェイのインストールフォルダー (例: *C:\Program Files\On-premises data gateway*) を参照します。
ゲートウェイを構成する構成画面に使用する最初のファイル ( EnterpriseGatewayConfigurator.exe.config) を開きます。
defaultProxy要素を見つけて、手順 1 で作成したプロキシ構成に置き換えてから、変更をファイルに保存します。
ゲートウェイを使用してクラウドサービスと対話し、要求を処理する実際の Windows サービスに使用される 2 つ目のファイルを開きます。つまり、 Microsoft.PowerBI.EnterpriseGateway.exe.config し、手順 4 を繰り返します。
ゲートウェイがデータソース (通常はクラウドデータソース) に接続するために使用する 3 番目の構成ファイルの場合は、インストールフォルダーのサブフォルダー m を開き、ファイル Microsoft.Mashup.Container.NetFX45.exe.config。手順 4. を繰り返して、プロキシ構成をこのファイルに挿入します。

ファイルが既定の状態の場合は、次の例のように、 system.net タグをプロキシ定義と共に追加する必要があります。
```
<system.net>
    <defaultProxy useDefaultCredentials="true">
        <proxy  
            autoDetect="false"  
            proxyaddress="http://192.168.0.1:8888"
            bypassonlocal="false"
            usesystemdefault="false"
        />
    </defaultProxy>
</system.net>
```
オンプレミスデータゲートウェイアプリケーションを開き 、[サービスの設定] タブに移動し、[ 今すぐ再起動 ] を選択してゲートウェイサービスを再起動し、新しいプロキシ設定を適用します。

一貫性のあるプロキシ構成を確認する

2022 年 9 月以降のバージョンを実行していることを確認します。
オンプレミスデータゲートウェイアプリケーションを開きます。
[診断] タブに移動します。
[ネットワークポートテスト]の下で、[新しいテストを開始]を選択します。
ネットワークポートのテストが完了したら、[ 最後に完了したテスト結果を開く] を選択します。
プロキシ構成が必要な 3 つの構成ファイル間で一貫している場合は、 Proxy configuration : Proxy settings match for all Gateway process configurations. メッセージが表示されます。

それ以外の場合、プロキシ構成に一貫性がない場合は、次の情報が表示されます。

Proxy configuration : Proxy settings are not consistent. Please ensure that the proxy configuration matches across the files listed below:
C:\Program Files\On-premises data gateway\EnterpriseGatewayConfigurator.exe.config
C:\Program Files\On-premises data gateway\Microsoft.PowerBI.EnterpriseGateway.exe.config
C:\Program Files\On-premises data gateway\m\Microsoft.Mashup.Container.NetFX45.exe.config
Review <https://docs.microsoft.com/data-integration/gateway/service-gateway-proxy>  for additional information about configuring proxies for the Gateway.

オンプレミスデータゲートウェイ (個人用モード) からプロキシ構成整合性検証を実行すると、次の構成ファイルが検証されます。

%LocalAppData%\Microsoft\On-premises data gateway (personal mode)\PersonalGatewayConfigurator.exe.config %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\Microsoft.PowerBI.DataMovement.PersonalGateway.exe.config %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\m\Microsoft.Mashup.Container.NetFX45.exe.config

プロキシ構成の動作に一貫性がないか見つからない

プロキシ定義が見つからないか一貫性がない場合は、オンプレミスのデータゲートウェイでさまざまな動作が発生する可能性があります。いくつかの例を次に示します。

セマンティックモデルまたはデータフロー更新エラー、エラーメッセージの例: Error: Unable to connect to the remote server。
オンプレミスデータゲートウェイを起動すると、サインインに失敗し、サインインプロンプトが表示されますが、その内容を表示できないか、エラーメッセージページが表示されます。
ネットワークポートのテスト結果は、サーバーへの接続エラーを報告します。

ファイアウォール情報

次の方法で共有

プロキシ設定の構成に関するステップ バイ ステップ ガイド