Delen via

Stapsgewijze handleiding voor het configureren van uw proxy-instellingen

  • Artikel

Als uw werkomgeving vereist dat de on-premises gegevensgateway van Microsoft een proxyserver doorloopt om verbinding te maken met de service, volgt u de onderstaande stappen om de proxy-instellingen te configureren.

Proxy-instellingen configureren

  1. Maak uw proxydefinitie-element. Ga naar defaultProxy-element (netwerkinstellingen) voor meer informatie over de configuratie van de proxy-elementen voor .NET-configuratiebestanden.

    In het volgende voorbeeld worden alle aanvragen via een specifieke proxy gerouteerd met het IP-adres 192.168.0.1 op poort 8888:

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

  2. Blader door de installatiemap voor de on-premises gegevensgateway, bijvoorbeeld *C:\Program Files\On-premises gegevensgateway*.

  3. Open het eerste bestand dat wordt gebruikt voor de configuratiecontroles voor het configureren van de gateway, dat wil gezegd EnterpriseGatewayConfigurator.exe.config.

  4. Zoek het defaultProxy element en vervang het door de proxyconfiguratie die u in de bovenstaande stap 1 hebt gemaakt en sla de wijzigingen vervolgens op in het bestand.

  5. Open het tweede bestand dat wordt gebruikt voor de werkelijke Windows-service die communiceert met de cloudservice met behulp van de gateway en verwerkt de aanvragen, dat wil gezegd, Microsoft.PowerBI.EnterpriseGateway.exe.config en herhaal stap 4.

  6. Voor het derde configuratiebestand dat voor de gateway wordt gebruikt om verbinding te maken met de gegevensbronnen ( meestal cloudgegevensbronnen), opent u de submap m in de installatiemap en vervolgens het bestand Microsoft.Mashup.Container.NetFX45.exe.config. Herhaal stap 4 om de proxyconfiguratie in dit bestand in te voegen.

    Als het bestand de standaardstatus heeft, moet u de system.net tag toevoegen, samen met de proxydefinitie, zoals in het volgende voorbeeld:

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

  7. Open de on-premises gegevensgatewaytoepassing, navigeer naar het tabblad Service Instellingen en selecteer Nu opnieuw opstarten om de gatewayservice opnieuw te starten en de nieuwe proxy-instellingen toe te passen.

Consistente proxyconfiguratie controleren

  1. Zorg ervoor dat u de versie van september 2022 of hoger gebruikt.

  2. Open de on-premises gegevensgatewaytoepassing.

  3. Navigeer naar het tabblad Diagnostische gegevens .

  4. Selecteer onder Test netwerkpoorten de optie Nieuwe test starten.

  5. Zodra de test van de netwerkpoorten is voltooid, selecteert u De laatste voltooide testresultaten openen.

  6. Als uw proxyconfiguratie consistent is in de drie vereiste configuratiebestanden, wordt er een Proxy configuration : Proxy settings match for all Gateway process configurations. bericht weergegeven.

  7. Als de proxyconfiguratie niet consistent is, wordt de volgende informatie weergegeven:

    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.

Bij het uitvoeren van de verificatie van proxyconfiguratieconsistentie vanuit een on-premises gegevensgateway (persoonlijke modus), worden de volgende configuratiebestanden geverifieerd:

%LocalAppData%\Microsoft\On-premises gegevensgateway (persoonlijke modus)\PersonalGatewayConfigurator.exe.config %LocalAppData%\Microsoft\On-premises gegevensgateway (persoonlijke modus)\Microsoft.PowerBI.DataMovement.PersonalGateway.exe.config %LocalAppData%\Microsoft\On-premises gegevensgateway (persoonlijke modus)\m\Microsoft.Mashup.Container.NetFX45.exe.config

Inconsistente of ontbrekende proxyconfiguratiegedrag

Als de proxydefinitie ontbreekt of inconsistent is, kunt u verschillende gedragingen ervaren met uw on-premises gegevensgateway. Enkele voorbeelden zijn:

  • Een semantisch model of fout bij het vernieuwen van gegevensstromen, voorbeeld van foutbericht: Error: Unable to connect to the remote server.
  • Tijdens het starten van een on-premises gegevensgateway kunt u zich niet aanmelden, wordt de aanmeldingsprompt weergegeven, maar de inhoud ervan kan niet worden weergegeven of er wordt een foutberichtpagina weergegeven.
  • In de testresultaten van de netwerkpoort worden fouten gerapporteerd die verbinding maken met de servers.

Volgende stappen