Schritt-für-Schritt-Anleitung zum Konfigurieren Ihrer Proxyeinstellungen

Wenn Ihre Arbeitsumgebung erfordert, dass das lokale Microsoft-Datengateway zum Herstellen einer Verbindung mit dem Dienst über einen Proxyserver geleitet wird, führen Sie die folgenden Schritte aus, um die Proxyeinstellungen zu konfigurieren.

Konfigurieren von Proxyeinstellungen

1. Erstellen Sie Ihr Proxydefinitionselement. Weitere Informationen über die Konfiguration der Proxyelemente für .NET-Konfigurationsdateien finden Sie unter defaultProxy-Element (Netzwerkeinstellungen).

   Im folgenden Beispiel werden alle Anforderungen über einen bestimmten Proxy mit der IP-Adresse 192.168.0.1 an Port 8888 weitergeleitet:

   <defaultProxy useDefaultCredentials="true">
       <proxy  
           autoDetect="false"  
           proxyaddress="http://192.168.0.1:8888"
           bypassonlocal="false"
           usesystemdefault="false"
       />
   </defaultProxy>
   

2. Durchsuchen Sie den Installationsordner für das lokale Datengateway, z. B. *C:\Program Files\On-premises data gateway*.

3. Öffnen Sie die erste Datei, die für die Konfigurationsbildschirme verwendet wird, die das Gateway konfigurieren, d. h. EnterpriseGatewayConfigurator.exe.config.

4. Suchen Sie das Element defaultProxy, ersetzen Sie es durch Ihre Proxykonfiguration, die in Schritt 1 oben erstellt wurde, und speichern Sie dann Ihre Änderungen an der Datei.

5. Öffnen Sie die zweite Datei, die für den tatsächlichen Windows-Dienst verwendet wird, der über das Gateway mit dem Clouddienst interagiert und die Anforderungen behandelt, d. h. Microsoft.PowerBI.EnterpriseGateway.exe.config. Wiederholen Sie dann Schritt 4.

6. Öffnen Sie für die dritte Konfigurationsdatei, die für das Gateway zum Herstellen einer Verbindung mit den Datenquellen (in der Regel Clouddatenquellen) verwendet wird, den Unterordner m im Installationsordner und dann die Datei Microsoft.Mashup.Container.NetFX45.exe.config. Wiederholen Sie Schritt 4, um die Proxykonfiguration in diese Datei einzufügen.

   Wenn sich die Datei im Standardzustand befindet, müssen Sie das Tag system.net zusammen mit der Proxydefinition hinzufügen, wie im folgenden Beispiel gezeigt:

   <system.net>
       <defaultProxy useDefaultCredentials="true">
           <proxy  
               autoDetect="false"  
               proxyaddress="http://192.168.0.1:8888"
               bypassonlocal="false"
               usesystemdefault="false"
           />
       </defaultProxy>
   </system.net>
   

7. Öffnen Sie die Anwendung für das lokale Datengateway, navigieren Sie zur Registerkarte Diensteinstellungen, und wählen Sie Jetzt neu starten aus, um den Gatewaydienst neu zu starten und die neuen Proxyeinstellungen anzuwenden.

Sicherstellen einer konsistenten Proxykonfiguration

1. Vergewissern Sie sich, dass Sie die Version vom September 2022 oder eine höhere Version ausführen.

2. Öffnen Sie die Anwendung für das lokale Datengateway.

3. Navigieren Sie zur Registerkarte Diagnose.

4. Wählen Sie unter Test der Netzwerkports die Option Neuen Test starten aus.

5. Nachdem der Netzwerkporttest abgeschlossen ist, wählen Sie Ergebnisse des zuletzt durchgeführten Tests öffnen aus.

6. Wenn Ihre Proxykonfiguration in den drei erforderlichen Konfigurationsdateien konsistent ist, wird eine Meldung vom Typ Proxy configuration : Proxy settings match for all Gateway process configurations. angezeigt.

7. Falls die Proxykonfiguration nicht konsistent ist, werden die folgenden Informationen angezeigt:

   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.
   

Bei der Überprüfung der Proxykonfigurationskonsistenz über ein lokales Datengateway (persönlicher Modus) werden die folgenden Konfigurationsdateien überprüft:

%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

Verhalten bei inkonsistenter oder fehlender Proxykonfiguration

Wenn die Proxydefinition entweder fehlt oder inkonsistent ist, kann es zu unterschiedlichen Verhaltensweisen bei Ihrem lokalen Datengateway kommen. Hierzu zählen etwa folgende Beispiele:

• Semantikmodell- oder Dataflow-Aktualisierungsfehler, Beispiel für eine Fehlermeldung: Error: Unable to connect to the remote server.
• Beim Starten des lokalen Datengateways können Sie sich nicht anmelden, die Anmeldeaufforderung wird angezeigt, der Inhalt kann jedoch nicht angezeigt werden, oder es wird eine Seite mit einer Fehlermeldung angezeigt.
• Die Ergebnisse der Netzwerkporttests melden Fehler beim Herstellen einer Verbindung mit den Servern.

Nächste Schritte

• Firewallinformationen