Konfigurieren einer App Service-App im Azure-PortalConfigure an App Service app in the Azure portal

In diesem Thema wird erläutert, wie Sie allgemeine Einstellungen für Web-Apps, ein mobiles Back-End oder eine API-App über das Azure-Portal konfigurieren.This topic explains how to configure common settings for web apps, mobile back end, or API app using the Azure portal.

Konfigurieren von App-EinstellungenConfigure app settings

In App Service handelt es sich bei App-Einstellungen um Variablen, die als Umgebungsvariablen an den Anwendungscode übergeben werden.In App Service, app settings are variables passed as environment variables to the application code. Bei Linux-Apps und benutzerdefinierten Containern übergibt App Service mithilfe des Flags --env App-Einstellungen an den Container, um die Umgebungsvariable im Container festzulegen.For Linux apps and custom containers, App Service passes app settings to the container using the --env flag to set the environment variable in the container.

Navigieren Sie im Azure-Portal zur Verwaltungsseite Ihrer App.In the Azure portal, navigate to your app's management page. Klicken Sie im linken Menü der App auf Konfiguration > Anwendungseinstellungen.In the app's left menu, click Configuration > Application settings.

Anwendungseinstellungen

Für ASP.NET- und ASP.NET Core-Entwickler entspricht die Festlegung von App-Einstellungen in App Service der Festlegung in <appSettings> in Web.config oder appsettings.json, aber die Werte in App Service überschreiben die in Web.config oder appsettings.json.For ASP.NET and ASP.NET Core developers, setting app settings in App Service are like setting them in <appSettings> in Web.config or appsettings.json, but the values in App Service override the ones in Web.config or appsettings.json. Sie können Entwicklungseinstellungen (z. B. das lokale MySQL-Kennwort) in Web.config oder appsettings.json beibehalten, aber Produktionsgeheimnisse (z. B. das Azure MySQL-Datenbank-Kennwort) sicher in App Service speichern.You can keep development settings (for example, local MySQL password) in Web.config or appsettings.json, but production secrets (for example, Azure MySQL database password) safe in App Service. Der gleiche Code verwendet Ihre Entwicklungseinstellungen, wenn Sie lokal debuggen, und verwendet Ihre Produktionsgeheimnisse, wenn sie in Azure bereitgestellt werden.The same code uses your development settings when you debug locally, and it uses your production secrets when deployed to Azure.

Andere Sprachstapel erhalten die App-Einstellungen ebenfalls als Umgebungsvariablen zur Laufzeit.Other language stacks, likewise, get the app settings as environment variables at runtime. Sprachstapelspezifische Schritte finden Sie unter:For language-stack specific steps, see:

App-Einstellungen werden bei der Speicherung stets verschlüsselt (encrypted-at-rest).App settings are always encrypted when stored (encrypted-at-rest).

Hinweis

App-Einstellungen können auch über Key Vault mithilfe von Key Vault-Referenzen aufgelöst werden.App settings can also be resolved from Key Vault using Key Vault references.

Anzeigen ausgeblendeter WerteShow hidden values

Standardmäßig werden Werte für App-Einstellungen aus Sicherheitsgründen im Portal ausgeblendet.By default, values for app settings are hidden in the portal for security. Um einen ausgeblendeten Wert einer App-Einstellung anzuzeigen, klicken Sie auf das Wert-Feld dieser Einstellung.To see a hidden value of an app setting, click the Value field of that setting. Um die Werte aller App-Einstellungen anzuzeigen, klicken Sie auf die Wert anzeigen-Schaltfläche.To see the values of all app settings, click the Show value button.

Hinzufügen oder BearbeitenAdd or edit

Klicken Sie zum Hinzufügen einer neuen App-Einstellung auf Neue Anwendungseinstellung.To add a new app setting, click New application setting. Im Dialogfeld können Sie die Einstellung im aktuellen Slot beibehalten.In the dialog, you can stick the setting to the current slot.

Um eine Einstellung zu bearbeiten, klicken Sie auf die Bearbeiten-Schaltfläche auf der rechten Seite.To edit a setting, click the Edit button on the right side.

Klicken Sie abschließend auf Aktualisieren.When finished, click Update. Vergessen Sie nicht, auf Speichern zu klicken, wenn Sie wieder auf der Seite Konfiguration sind.Don't forget to click Save back in the Configuration page.

Hinweis

In einem standardmäßigen Linux-Container oder einem benutzerdefinierten Linux-Container muss jede geschachtelte JSON-Schlüsselstruktur im App-Einstellungsnamen wie ApplicationInsights:InstrumentationKey in App Service als ApplicationInsights__InstrumentationKey für den Schlüsselnamen konfiguriert werden.In a default Linux container or a custom Linux container, any nested JSON key structure in the app setting name like ApplicationInsights:InstrumentationKey needs to be configured in App Service as ApplicationInsights__InstrumentationKey for the key name. Mit anderen Worten: Jedes : muss durch __ (doppelter Unterstrich) ersetzt werden.In other words, any : should be replaced by __ (double underscore).

Bearbeiten im MassenvorgangEdit in bulk

Um App-Einstellungen in einem Massenvorgang hinzuzufügen oder zu bearbeiten, klicken Sie auf die Erweiterte Bearbeitung-Schaltfläche.To add or edit app settings in bulk, click the Advanced edit button. Klicken Sie abschließend auf Aktualisieren.When finished, click Update. Vergessen Sie nicht, auf Speichern zu klicken, wenn Sie wieder auf der Seite Konfiguration sind.Don't forget to click Save back in the Configuration page.

App-Einstellungen haben folgende JSON-Formatierung:App settings have the following JSON formatting:

[
  {
    "name": "<key-1>",
    "value": "<value-1>",
    "slotSetting": false
  },
  {
    "name": "<key-2>",
    "value": "<value-2>",
    "slotSetting": false
  },
  ...
]

Konfigurieren von VerbindungszeichenfolgenConfigure connection strings

Navigieren Sie im Azure-Portal zur Verwaltungsseite der App.In the Azure portal, navigate to the app's management page. Klicken Sie im linken Menü der App auf Konfiguration > Anwendungseinstellungen.In the app's left menu, click Configuration > Application settings.

Anwendungseinstellungen

Für ASP.NET- und ASP.NET Core-Entwickler entspricht die Einstellung von Verbindungszeichenfolgen in App Service der Einstellung in <connectionStrings> in Web.config, aber die Werte, die Sie in App Service festlegen, überschreiben die in Web.config. Sie können Entwicklungseinstellungen (z. B. eine Datenbankdatei) in Web.config und Produktionsgeheimnisse (z. B. SQL-Datenbank-Anmeldeinformationen) sicher in App Service beibehalten.For ASP.NET and ASP.NET Core developers, setting connection strings in App Service are like setting them in <connectionStrings> in Web.config, but the values you set in App Service override the ones in Web.config. You can keep development settings (for example, a database file) in Web.config and production secrets (for example, SQL Database credentials) safe in App Service. Der gleiche Code verwendet Ihre Entwicklungseinstellungen, wenn Sie lokal debuggen, und verwendet Ihre Produktionsgeheimnisse, wenn sie in Azure bereitgestellt werden.The same code uses your development settings when you debug locally, and it uses your production secrets when deployed to Azure.

Für andere Sprachstapel sollten Sie stattdessen besser App-Einstellungen verwenden, da Verbindungszeichenfolgen spezielle Formatierung in den Variablenschlüsseln erfordern, um auf die Werte zuzugreifen.For other language stacks, it's better to use app settings instead, because connection strings require special formatting in the variable keys in order to access the values. Hier ist jedoch eine Ausnahme: Bestimmte Azure-Datenbanktypen werden zusammen mit der App gesichert, wenn Sie ihre Verbindungszeichenfolgen in Ihrer App konfigurieren.Here's one exception, however: certain Azure database types are backed up along with the app if you configure their connection strings in your app. Weitere Informationen finden Sie unter Was wird gesichert?.For more information, see What gets backed up. Wenn Sie diese automatisierte Sicherung nicht benötigen, verwenden Sie App-Einstellungen.If you don't need this automated backup, then use app settings.

Zur Laufzeit stehen Verbindungszeichenfolgen als Umgebungsvariablen zur Verfügung, wobei sie mit Präfixen für die folgenden Verbindungstypen versehen werden:At runtime, connection strings are available as environment variables, prefixed with the following connection types:

  • SQL Server: SQLCONNSTR_SQL Server: SQLCONNSTR_
  • MySQL: MYSQLCONNSTR_MySQL: MYSQLCONNSTR_
  • SQL-Datenbank: SQLAZURECONNSTR_SQL Database: SQLAZURECONNSTR_
  • Benutzerdefiniert: CUSTOMCONNSTR_Custom: CUSTOMCONNSTR_

Wenn beispielsweise eine MySql-Verbindungszeichenfolge connectionstring1 heißt, kann sie über die Umgebungsvariable MYSQLCONNSTR_connectionString1 aufgerufen werden.For example, a MySql connection string named connectionstring1 can be accessed as the environment variable MYSQLCONNSTR_connectionString1. Sprachstapelspezifische Schritte finden Sie unter:For language-stack specific steps, see:

Verbindungszeichenfolgen werden bei der Speicherung stets verschlüsselt (encrypted-at-rest).Connection strings are always encrypted when stored (encrypted-at-rest).

Hinweis

Verbindungszeichenfolgen können auch über Key Vault mithilfe von Key Vault-Referenzen aufgelöst werden.Connection strings can also be resolved from Key Vault using Key Vault references.

Anzeigen ausgeblendeter WerteShow hidden values

Standardmäßig werden Werte für Verbindungszeichenfolgen aus Sicherheitsgründen im Portal ausgeblendet.By default, values for connection strings are hidden in the portal for security. Um einen ausgeblendeten Wert einer Verbindungszeichenfolge anzuzeigen, klicken Sie einfach auf das Wert-Feld dieser Zeichenfolge.To see a hidden value of a connection string, just click the Value field of that string. Um die Werte aller Verbindungszeichenfolgen anzuzeigen, klicken Sie auf die Wert anzeigen-Schaltfläche.To see the values of all connection strings, click the Show value button.

Hinzufügen oder BearbeitenAdd or edit

Um eine neue Verbindungszeichenfolge hinzuzufügen, klicken Sie auf Neue Verbindungszeichenfolge.To add a new connection string, click New connection string. Im Dialogfeld können Sie die Verbindungszeichenfolge im aktuellen Slot beibehalten.In the dialog, you can stick the connection string to the current slot.

Um eine Einstellung zu bearbeiten, klicken Sie auf die Bearbeiten-Schaltfläche auf der rechten Seite.To edit a setting, click the Edit button on the right side.

Klicken Sie abschließend auf Aktualisieren.When finished, click Update. Vergessen Sie nicht, auf Speichern zu klicken, wenn Sie wieder auf der Seite Konfiguration sind.Don't forget to click Save back in the Configuration page.

Bearbeiten im MassenvorgangEdit in bulk

Um Verbindungszeichenfolgen in einem Massenvorgang hinzuzufügen oder zu bearbeiten, klicken Sie auf die Erweiterte Bearbeitung-Schaltfläche.To add or edit connection strings in bulk, click the Advanced edit button. Klicken Sie abschließend auf Aktualisieren.When finished, click Update. Vergessen Sie nicht, auf Speichern zu klicken, wenn Sie wieder auf der Seite Konfiguration sind.Don't forget to click Save back in the Configuration page.

Verbindungszeichenfolgen haben folgende JSON-Formatierung:Connection strings have the following JSON formatting:

[
  {
    "name": "name-1",
    "value": "conn-string-1",
    "type": "SQLServer",
    "slotSetting": false
  },
  {
    "name": "name-2",
    "value": "conn-string-2",
    "type": "PostgreSQL",
    "slotSetting": false
  },
  ...
]

Konfigurieren allgemeiner EinstellungenConfigure general settings

Navigieren Sie im Azure-Portal zur Verwaltungsseite der App.In the Azure portal, navigate to the app's management page. Klicken Sie im linken Menü der App auf Konfiguration > Anwendungseinstellungen.In the app's left menu, click Configuration > Application settings.

Allgemeine Einstellungen

Hier können Sie einige allgemeine Einstellungen für die App konfigurieren.Here, you can configure some common settings for the app. Einige Einstellungen erfordern zentrales Hochskalieren auf höhere Tarife.Some settings require you to scale up to higher pricing tiers.

  • Stapeleinstellungen: Der Softwarestapel zum Ausführen der App, einschließlich der Sprach- und SDK-Version.Stack settings: The software stack to run the app, including the language and SDK versions. Für Linux-Apps und benutzerdefinierte Container-Apps können Sie auch optional einen Startbefehl oder eine Startdatei festlegen.For Linux apps and custom container apps, you can also set an optional start-up command or file.
  • Plattformeinstellungen: Ermöglicht das Konfigurieren von Einstellungen für die Hostingplattform, einschließlich:Platform settings: Lets you configure settings for the hosting platform, including:
    • Bitanzahl: 32-Bit oder 64-Bit.Bitness: 32-bit or 64-bit.
    • WebSocket-Protokoll: Z.B. für ASP.NET SignalR oder socket.io.WebSocket protocol: For ASP.NET SignalR or socket.io, for example.
    • Always On: Lassen Sie die App auch dann geladen, wenn kein Datenverkehr stattfindet.Always On: Keep the app loaded even when there's no traffic. Dies ist für fortlaufende WebJobs oder WebJobs, die mithilfe eines CRON-Ausdrucks ausgelöst werden, erforderlich.It's required for continuous WebJobs or for WebJobs that are triggered using a CRON expression.
    • Verwalteter Pipelinemodus: Der IIS-Pipelinemodus.Managed pipeline version: The IIS pipeline mode. Legen Sie ihn auf Klassisch fest, wenn Sie eine ältere App haben, die eine ältere Version von IIS erfordert.Set it to Classic if you have a legacy app that requires an older version of IIS.
    • HTTP-Version: Legen Sie die Einstellung auf 2.0 fest, um die Unterstützung für das HTTPS/2-Protokoll zu aktivieren.HTTP version: Set to 2.0 to enable support for HTTPS/2 protocol.

    Hinweis

    Die aktuellen Browser unterstützen das HTTP/2-Protokoll in der Regel nur über TLS, während unverschlüsselter Datenverkehr weiterhin HTTP/1.1 verwendet.Most modern browsers support HTTP/2 protocol over TLS only, while non-encrypted traffic continues to use HTTP/1.1. Um sicherzustellen, dass Clientbrowser eine Verbindung mit Ihrer App mit HTTP/2 herstellen können, sichern Sie den benutzerdefinierten DNS-Namen mit einer SSL-Bindung in Azure App Service.To ensure that client browsers connect to your app with HTTP/2, secure your custom DNS name with an SSL binding in Azure App Service.

    • ARR-Affinität: In einer Bereitstellung mit mehreren Instanzen stellen Sie sicher, dass der Client für die Lebensdauer der Sitzung an die gleiche Instanz weitergeleitet wird.ARR affinity: In a multi-instance deployment, ensure that the client is routed to the same instance for the life of the session. Sie können für zustandslose Anwendungen für diese Option Aus festlegen.You can set this option to Off for stateless applications.
  • Debuggen: Aktivieren Sie das Remotedebuggen für ASP.NET-, ASP.NET Core- oder Node.js-Apps.Debugging: Enable remote debugging for ASP.NET, ASP.NET Core, or Node.js apps. Diese Option wird nach 48 Stunden automatisch deaktiviert.This option turns off automatically after 48 hours.
  • Eingehende Clientzertifikate: erforderliche Clientzertifikate bei gegenseitiger Authentifizierung.Incoming client certificates: require client certificates in mutual authentication.

Konfigurieren von StandarddokumentenConfigure default documents

Diese Einstellung gilt nur für Windows-Apps.This setting is only for Windows apps.

Navigieren Sie im Azure-Portal zur Verwaltungsseite der App.In the Azure portal, navigate to the app's management page. Klicken Sie im linken Menü der App auf Konfiguration > Standarddokumente.In the app's left menu, click Configuration > Default documents.

Allgemeine Einstellungen

Das Standarddokument ist die Webseite, die an der Stamm-URL für eine Website angezeigt wird.The default document is the web page that's displayed at the root URL for a website. Die erste übereinstimmende Datei in der Liste wird verwendet.The first matching file in the list is used. Klicken Sie zum Hinzufügen eines neuen Standarddokuments auf Neues Dokument.To add a new default document, click New document. Vergessen Sie das Speichern nicht.Don't forget to click Save.

Wenn die App Module verwendet, die auf Grundlage der URL weiterleiten, anstatt statischen Inhalt bereitzustellen, besteht keine Notwendigkeit für Standarddokumente.If the app uses modules that route based on URL instead of serving static content, there is no need for default documents.

Konfigurieren von PfadzuordnungenConfigure path mappings

Navigieren Sie im Azure-Portal zur Verwaltungsseite der App.In the Azure portal, navigate to the app's management page. Klicken Sie im linken Menü der App auf Konfiguration > Pfadzuordnungen.In the app's left menu, click Configuration > Path mappings.

Allgemeine Einstellungen

Auf der Seite Pfadzuordnungen wird je nach BS-Typ Unterschiedliches angezeigt.The Path mappings page shows you different things based on the OS type.

Windows-Apps (nicht in Containern)Windows apps (uncontainerized)

Für Windows-Apps können Sie die IIS-Handlerzuordnungen und virtuelle Anwendungen und Verzeichnisse anpassen.For Windows apps, you can customize the IIS handler mappings and virtual applications and directories.

Mit Handlerzuordnungen können Sie benutzerdefinierte Skriptprozessoren hinzufügen, die Anforderungen für bestimmte Dateierweiterungen verarbeiten.Handler mappings let you add custom script processors to handle requests for specific file extensions. Um einen benutzerdefinierten Handler hinzuzufügen, klicken Sie auf Neuer Handler.To add a custom handler, click New handler. Konfigurieren Sie den Handler folgendermaßen:Configure the handler as follows:

  • Erweiterung.Extension. Die zu verarbeitende Dateierweiterung wie *.php oder handler.fcgi.The file extension you want to handle, such as *.php or handler.fcgi.
  • Skriptprozessor.Script processor. Der absolute Pfad des Skriptprozessors zu Ihnen.The absolute path of the script processor to you. Anforderungen für Dateien, die dieser Dateierweiterung entsprechen, werden vom Skriptprozessor verarbeitet.Requests to files that match the file extension are processed by the script processor. Verwenden Sie den Pfad D:\home\site\wwwroot , um auf das Stammverzeichnis Ihrer App zu verweisen.Use the path D:\home\site\wwwroot to refer to your app's root directory.
  • Argumente.Arguments. Optionale Befehlszeilenargumente für den Skriptprozessor.Optional command-line arguments for the script processor.

Für jede App ist der Standardstammpfad (/) D:\home\site\wwwroot zugeordnet, wo Ihr Code standardmäßig bereitgestellt wird.Each app has the default root path (/) mapped to D:\home\site\wwwroot, where your code is deployed by default. Wenn Ihr App-Stamm sich in einem anderen Ordner befindet oder Ihr Repository über mehrere Anwendungen verfügt, können Sie virtuelle Anwendungen und Verzeichnisse hier bearbeiten oder hinzufügen.If your app root is in a different folder, or if your repository has more than one application, you can edit or add virtual applications and directories here. Klicken Sie auf Neue virtuelle Anwendung oder neues virtuelles Verzeichnis .Click New virtual application or directory.

Um die virtuellen Anwendungen und Verzeichnisse zu konfigurieren, geben Sie jedes virtuelle Verzeichnis und den zugehörigen physischen Pfad relativ zum Stammverzeichnis der Website (D:\home) an.To configure virtual applications and directories, specify each virtual directory and its corresponding physical path relative to the website root (D:\home). Sie haben außerdem die Möglichkeit, mit dem Kontrollkästchen Anwendung ein virtuelles Verzeichnis als Anwendung zu markieren.Optionally, you can select the Application checkbox to mark a virtual directory as an application.

Container-AppsContainerized apps

Sie können für Ihre Container-Apps benutzerdefinierten Speicher hinzufügen.You can add custom storage for your containerized app. Zu den Container-Apps zählen alle Linux-Apps sowie die in App Service ausgeführten benutzerdefinierten Windows- und Linux-Container.Containerized apps include all Linux apps and also the Windows and Linux custom containers running on App Service. Klicken Sie auf Neue Azure-Speicherbereitstellung , und konfigurieren Sie Ihren benutzerdefinierten Speicher wie folgt:Click New Azure Storage Mount and configure your custom storage as follows:

  • Name: Neuer Anzeigename.Name: The display name.
  • Konfigurationsoptionen: Einfach oder Erweitert.Configuration options: Basic or Advanced.
  • Speicherkonten: Das Speicherkonto mit dem von Ihnen gewünschten Container.Storage accounts: The storage account with the container you want.
  • Storage type (Speichertyp): Azure-Blobs oder Azure Files.Storage type: Azure Blobs or Azure Files.

    Hinweis

    Windows-Container-Apps unterstützen nur Azure Files.Windows container apps only support Azure Files.

  • Speichercontainer: Für die Basiskonfiguration der von Ihnen gewünschte Container.Storage container: For basic configuration, the container you want.
  • Freigabename: Für die erweiterte Konfiguration der Dateifreigabename.Share name: For advanced configuration, the file share name.
  • Zugriffsschlüssel: Für die erweiterte Konfiguration der Zugriffsschlüssel.Access key: For advanced configuration, the access key.
  • Einbindungspfad: Der absolute Pfad in Ihrem Container zum Bereitstellen des benutzerdefinierten Speichers.Mount path: The absolute path in your container to mount the custom storage.

Weitere Informationen finden Sie unter Bereitstellen von Inhalt aus Azure Storage in App Service unter Linux.For more information, see Serve content from Azure Storage in App Service on Linux.

Konfigurieren von SprachstapeleinstellungenConfigure language stack settings

Für Linux-Apps finden Sie Informationen unter:For Linux apps, see:

Konfigurieren eines benutzerdefinierten ContainersConfigure custom containers

Siehe Konfigurieren eines benutzerdefinierten Linux-Containers für Azure App Service.See Configure a custom Linux container for Azure App Service

Nächste SchritteNext steps