Referenz zu App-Einstellungen für Azure FunctionsApp settings reference for Azure Functions

App-Einstellungen in einer Funktionen-App enthalten globale Konfigurationsoptionen, die sich auf alle Funktionen dieser Funktionen-App auswirken.App settings in a function app contain global configuration options that affect all functions for that function app. Bei der lokalen Ausführung wird auf diese Einstellungen als lokale Umgebungsvariablen zugegriffen.When you run locally, these settings are accessed as local environment variables. In diesem Artikel werden die in Funktionen-Apps verfügbaren App-Einstellungen aufgelistet.This article lists the app settings that are available in function apps.

Es gibt mehrere Möglichkeiten zum Hinzufügen, Aktualisieren und Löschen von Funktionen-App-Einstellungen:There are several ways that you can add, update, and delete function app settings:

Es gibt andere globale Konfigurationsoptionen in der Datei host.json und in der Datei local.settings.json.There are other global configuration options in the host.json file and in the local.settings.json file.

APPINSIGHTS_INSTRUMENTATIONKEYAPPINSIGHTS_INSTRUMENTATIONKEY

Der Application Insights-Instrumentierungsschlüssel, wenn Sie Application Insights verwenden.The Application Insights instrumentation key if you're using Application Insights. Weitere Informationen finden Sie unter Überwachen von Azure Functions.See Monitor Azure Functions.

SchlüsselKey BeispielwertSample value
APPINSIGHTS_INSTRUMENTATIONKEYAPPINSIGHTS_INSTRUMENTATIONKEY 5dbdd5e9-af77-484b-9032-64f83bb83bb5dbdd5e9-af77-484b-9032-64f83bb83bb

AZURE_FUNCTIONS_ENVIRONMENTAZURE_FUNCTIONS_ENVIRONMENT

Konfiguriert in Version 2.x der Functions-Runtime das App-Verhalten auf der Grundlage der Runtimeumgebung.In version 2.x of the Functions runtime, configures app behavior based on the runtime environment. Dieser Wert ist während der Initialisierung lesen.This value is read during initialization. Sie können AZURE_FUNCTIONS_ENVIRONMENT auf beliebige Werte festlegen, aber drei Werte werden unterstützt: Entwicklung, Staging und Produktion.You can set AZURE_FUNCTIONS_ENVIRONMENT to any value, but three values are supported: Development, Staging, and Production. Wenn AZURE_FUNCTIONS_ENVIRONMENT nicht festgelegt ist, wird als Standardwert in einer lokalen Umgebung Development und in Azure Production verwendet.When AZURE_FUNCTIONS_ENVIRONMENT isn't set, it defaults to Development on a local environment and Production on Azure. Diese Einstellung sollte anstelle von ASPNETCORE_ENVIRONMENT verwendet werden, um die Laufzeitumgebung festzulegen.This setting should be used instead of ASPNETCORE_ENVIRONMENT to set the runtime environment.

AzureWebJobsDashboardAzureWebJobsDashboard

Optionale Verbindungszeichenfolge für das Speicherkonto zum Speichern von Protokollen und zu deren Anzeige auf der Registerkarte Überwachen im Portal.Optional storage account connection string for storing logs and displaying them in the Monitor tab in the portal. Das Speicherkonto muss ein allgemeines Konto sein, das BLOBs, Warteschlangen und Tabellen unterstützt.The storage account must be a general-purpose one that supports blobs, queues, and tables. Weitere Informationen finden Sie unter Speicherkonto und Anforderungen an das Speicherkonto.See Storage account and Storage account requirements.

SchlüsselKey BeispielwertSample value
AzureWebJobsDashboardAzureWebJobsDashboard DefaultEndpointsProtocol=https;AccountName=[Name];AccountKey=[Schlüssel]DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]

Tipp

Um von mehr Leistung und Benutzerfreundlichkeit zu profitieren, empfiehlt es sich, APPINSIGHTS_INSTRUMENTATIONKEY und App Insights anstelle von AzureWebJobsDashboard für die Überwachung zu verwenden.For performance and experience, it is recommended to use APPINSIGHTS_INSTRUMENTATIONKEY and App Insights for monitoring instead of AzureWebJobsDashboard

AzureWebJobsDisableHomepageAzureWebJobsDisableHomepage

true bedeutet, dass die standardmäßige Landing Page deaktiviert wird, die für die Stamm-URL einer Funktionen-App angezeigt wird.true means disable the default landing page that is shown for the root URL of a function app. Der Standardwert ist false.Default is false.

SchlüsselKey BeispielwertSample value
AzureWebJobsDisableHomepageAzureWebJobsDisableHomepage truetrue

Wenn diese App-Einstellung ausgelassen oder auf false gesetzt wird, erfolgt als Reaktion auf die URL <functionappname>.azurewebsites.net die Anzeige einer Seite, die dem folgenden Beispiel ähnelt.When this app setting is omitted or set to false, a page similar to the following example is displayed in response to the URL <functionappname>.azurewebsites.net.

Landing Page der Funktionen-App

AzureWebJobsDotNetReleaseCompilationAzureWebJobsDotNetReleaseCompilation

true bedeutet, dass beim Kompilieren von .NET-Code der Releasemodus verwendet wird, während false bedeutet, dass der Debugmodus verwendet wird.true means use Release mode when compiling .NET code; false means use Debug mode. Der Standardwert ist true.Default is true.

SchlüsselKey BeispielwertSample value
AzureWebJobsDotNetReleaseCompilationAzureWebJobsDotNetReleaseCompilation truetrue

AzureWebJobsFeatureFlagsAzureWebJobsFeatureFlags

Eine durch Trennzeichen getrennte Liste der zu aktivierenden Features der Betaversion.A comma-delimited list of beta features to enable. Durch diese Flags aktivierten Features der Betaversion sind nicht bereit für die Produktion, können aber zur experimentellen Verwendung aktiviert werden, bevor sie live geschaltet werden.Beta features enabled by these flags are not production ready, but can be enabled for experimental use before they go live.

SchlüsselKey BeispielwertSample value
AzureWebJobsFeatureFlagsAzureWebJobsFeatureFlags Feature1,Feature2feature1,feature2

AzureWebJobsSecretStorageTypeAzureWebJobsSecretStorageType

Gibt das Repository oder den Anbieter an, das bzw. der zum Speichern von Schlüsseln verwendet wird.Specifies the repository or provider to use for key storage. Aktuell sind die unterstützten Repositorys der Blobspeicher („Blob“) und das lokale Dateisystem („Dateien“).Currently, the supported repositories are blob storage ("Blob") and the local file system ("Files"). In Version 2 ist der Blobspeicher die Standardeinstellung, in Version 1 das Dateisystem.The default is blob in version 2 and file system in version 1.

SchlüsselKey BeispielwertSample value
AzureWebJobsSecretStorageTypeAzureWebJobsSecretStorageType DateienFiles

AzureWebJobsStorageAzureWebJobsStorage

Die Azure Functions-Laufzeit verwendet diese Verbindungszeichenfolge des Speicherkontos für alle Funktionen, mit Ausnahme der per HTTP ausgelösten Funktionen.The Azure Functions runtime uses this storage account connection string for all functions except for HTTP triggered functions. Das Speicherkonto muss ein allgemeines Konto sein, das BLOBs, Warteschlangen und Tabellen unterstützt.The storage account must be a general-purpose one that supports blobs, queues, and tables. Weitere Informationen finden Sie unter Speicherkonto und Anforderungen an das Speicherkonto.See Storage account and Storage account requirements.

SchlüsselKey BeispielwertSample value
AzureWebJobsStorageAzureWebJobsStorage DefaultEndpointsProtocol=https;AccountName=[Name];AccountKey=[Schlüssel]DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]

AzureWebJobs_TypeScriptPathAzureWebJobs_TypeScriptPath

Der Pfad zum Compiler, der für TypeScript verwendet wird.Path to the compiler used for TypeScript. Bei Bedarf können Sie den Standardwert außer Kraft setzen.Allows you to override the default if you need to.

SchlüsselKey BeispielwertSample value
AzureWebJobs_TypeScriptPathAzureWebJobs_TypeScriptPath %HOME%\typescript%HOME%\typescript

FUNCTION_APP_EDIT_MODEFUNCTION_APP_EDIT_MODE

Bestimmt, ob die Bearbeitung im Azure-Portal aktiviert ist.Dictates whether editing in the Azure portal is enabled. Gültige Werte sind „readwrite“ und „readonly“.Valid values are "readwrite" and "readonly".

SchlüsselKey BeispielwertSample value
FUNCTION_APP_EDIT_MODEFUNCTION_APP_EDIT_MODE readonlyreadonly

FUNCTIONS_EXTENSION_VERSIONFUNCTIONS_EXTENSION_VERSION

Die in dieser Funktionen-App zu verwendende Version der Functions-Runtime.The version of the Functions runtime to use in this function app. Eine Tilde mit Hauptversion bedeutet, dass die neueste Version dieser Hauptversion verwendet wird (z.B. „~2“).A tilde with major version means use the latest version of that major version (for example, "~2"). Wenn neue Versionen für dieselbe Hauptversion verfügbar sind, werden sie automatisch in der Funktionen-App installiert.When new versions for the same major version are available, they are automatically installed in the function app. Verwenden Sie die vollständige Versionsnummer (z.B. „2.0.12345“), um die App an eine bestimmte Version anzuheften.To pin the app to a specific version, use the full version number (for example, "2.0.12345"). Der Standardwert ist „~2“.Default is "~2". Der Wert ~1 heftet Ihre App an Version 1.x der Runtime an.A value of ~1 pins your app to version 1.x of the runtime.

SchlüsselKey BeispielwertSample value
FUNCTIONS_EXTENSION_VERSIONFUNCTIONS_EXTENSION_VERSION ~2~2

FUNCTIONS_WORKER_PROCESS_COUNTFUNCTIONS_WORKER_PROCESS_COUNT

Gibt die maximale Anzahl von Sprachworkerprozessen mit einem Standardwert von 1 an.Specifies the maximum number of language worker processes, with a default value of 1. Der zulässige Höchstwert ist 10.The maximum value allowed is 10. Funktionsaufrufe werden gleichmäßig zwischen Sprachworkerprozessen verteilt.Function invocations are evenly distributed among language worker processes. Sprachworkerprozesse werden so lange alle 10 Sekunden erzeugt, bis die von FUNCTIONS_WORKER_PROCESS_COUNT festgelegte Anzahl erreicht ist.Language worker processes are spawned every 10 seconds until the count set by FUNCTIONS_WORKER_PROCESS_COUNT is reached. Die Verwendung mehrerer Sprachworkerprozesse ist nicht dasselbe wie Skalierung.Using multiple language worker processes is not the same as scaling. Erwägen Sie die Verwendung dieser Einstellung, wenn Ihr Workload aus einer Mischung von CPU-gebundenen und E/A-gebundenen Aufrufen besteht.Consider using this setting when your workload has a mix of CPU-bound and I/O-bound invocations. Diese Einstellung gilt für alle .NET-Sprachen.This setting applies to all non-.NET languages.

SchlüsselKey BeispielwertSample value
FUNCTIONS_WORKER_PROCESS_COUNTFUNCTIONS_WORKER_PROCESS_COUNT 22

FUNCTIONS_WORKER_RUNTIMEFUNCTIONS_WORKER_RUNTIME

Die Sprachworkerruntime, die in der Funktionen-App geladen werden soll.The language worker runtime to load in the function app. Dies entspricht der Sprache, die in Ihrer Anwendung verwendet wird (z.B. „dotnet“).This will correspond to the language being used in your application (for example, "dotnet"). Bei Funktionen in mehreren Sprachen müssen Sie diese in verschiedenen Apps mit dem jeweils passenden Workerruntimewert veröffentlichen.For functions in multiple languages you will need to publish them to multiple apps, each with a corresponding worker runtime value. Gültige Werte sind dotnet (C#/F#), node (JavaScript/TypeScript), java (Java) und powershell (PowerShell) und python (Python).Valid values are dotnet (C#/F#), node (JavaScript/TypeScript), java (Java), powershell (PowerShell), and python (Python).

SchlüsselKey BeispielwertSample value
FUNCTIONS_WORKER_RUNTIMEFUNCTIONS_WORKER_RUNTIME dotnetdotnet

WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGWEBSITE_CONTENTAZUREFILECONNECTIONSTRING

Nur für Verbrauchs- und Premium-Tarife.For consumption & Premium plans only. Die Verbindungszeichenfolge für das Speicherkonto, in dem der Code der Funktionen-App und die Konfiguration gespeichert werden.Connection string for storage account where the function app code and configuration are stored. Weitere Informationen finden Sie unter Erstellen einer Funktionen-App.See Create a function app.

SchlüsselKey BeispielwertSample value
WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGWEBSITE_CONTENTAZUREFILECONNECTIONSTRING DefaultEndpointsProtocol=https;AccountName=[Name];AccountKey=[Schlüssel]DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]

WEBSITE_CONTENTSHAREWEBSITE_CONTENTSHARE

Nur für Verbrauchs- und Premium-Tarife.For consumption & Premium plans only. Der Dateipfad zum Code der Funktionen-App und zur Konfiguration.The file path to the function app code and configuration. Wird mit WEBSITE_CONTENTAZUREFILECONNECTIONSTRING verwendet.Used with WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. Standardmäßig wird eine eindeutige Zeichenfolge verwendet, die mit dem Namen der Funktionen-App beginnt.Default is a unique string that begins with the function app name. Weitere Informationen finden Sie unter Erstellen einer Funktionen-App.See Create a function app.

SchlüsselKey BeispielwertSample value
WEBSITE_CONTENTSHAREWEBSITE_CONTENTSHARE functionapp091999e2functionapp091999e2

WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUTWEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT

Die maximale Anzahl der Instanzen, auf denen die Funktionen-App horizontal hochskaliert werden kann.The maximum number of instances that the function app can scale out to. Dieser Wert ist standardmäßig unbegrenzt.Default is no limit.

Hinweis

Diese Einstellung ist ein Vorschaufeature und funktioniert nur dann zuverlässig, wenn sie auf einen Wert <= 5 festgelegt wird.This setting is a preview feature - and only reliable if set to a value <= 5

SchlüsselKey BeispielwertSample value
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUTWEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT 55

WEBSITE_NODE_DEFAULT_VERSIONWEBSITE_NODE_DEFAULT_VERSION

Der Standardwert ist „8.11.1“.Default is "8.11.1".

SchlüsselKey BeispielwertSample value
WEBSITE_NODE_DEFAULT_VERSIONWEBSITE_NODE_DEFAULT_VERSION 8.11.18.11.1

WEBSITE_RUN_FROM_PACKAGEWEBSITE_RUN_FROM_PACKAGE

Ermöglicht es Ihrer Funktions-App, über eine bereitgestellte Paketdatei ausgeführt zu werden.Enables your function app to run from a mounted package file.

SchlüsselKey BeispielwertSample value
WEBSITE_RUN_FROM_PACKAGEWEBSITE_RUN_FROM_PACKAGE 11

Gültige Werte sind entweder eine URL, die in den Speicherort einer Bereitstellungspaketdatei aufgelöst werden kann, oder 1.Valid values are either a URL that resolves to the location of a deployment package file, or 1. Bei einer Festlegung auf 1 muss sich das Paket im Ordner d:\home\data\SitePackages befinden.When set to 1, the package must be in the d:\home\data\SitePackages folder. Wenn Sie die Zip-Bereitstellung mit dieser Einstellung verwenden, wird das Paket automatisch an diesen Speicherort hochgeladen.When using zip deployment with this setting, the package is automatically uploaded to this location. In der Vorschau wurde diese Einstellung als WEBSITE_RUN_FROM_ZIP bezeichnet.In preview, this setting was named WEBSITE_RUN_FROM_ZIP. Weitere Informationen finden Sie unter Ausführen von Azure Functions über eine Paketdatei.For more information, see Run your functions from a package file.

AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALLAZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL

Standardmäßig nutzen Functions-Proxys eine Verknüpfung, um API-Aufrufe von Proxys direkt an Funktionen in derselben Funktionen-App zu senden, anstatt eine neue HTTP-Anforderung zu erstellen.By default Functions proxies will utilize a shortcut to send API calls from proxies directly to functions in the same Function App, rather than creating a new HTTP request. Mit dieser Einstellung können Sie dieses Verhalten deaktivieren.This setting allows you to disable that behavior.

SchlüsselKey WertValue BESCHREIBUNGDescription
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALLAZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL truetrue Aufrufe mit einer Back-End-URL, die auf eine Funktion in der lokalen Funktionen-App verweist, werden nicht mehr direkt an die Funktion gesendet. Stattdessen werden sie an das HTTP-Front-End für die Funktionen-App zurückgeleitet.Calls with a backend url pointing to a function in the local Function App will no longer be sent directly to the function, and will instead be directed back to the HTTP front end for the Function App
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALLAZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL falsefalse Dies ist der Standardwert.This is the default value. Aufrufe mit einer Back-End-URL, die auf eine Funktion in der lokalen Funktionen-App verweist, werden direkt an diese Funktion geleitet.Calls with a backend url pointing to a function in the local Function App will be forwarded directly to that Function

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHESAZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES

Diese Einstellung steuert, ob %2F in Routenparametern als Schrägstrich decodiert wird, wenn dieser Code in der Back-End-URL eingefügt wird.This setting controls whether %2F is decoded as slashes in route parameters when they are inserted into the backend URL.

SchlüsselKey WertValue BESCHREIBUNGDescription
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHESAZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES truetrue Bei Routenparameter mit codierten Schrägstrichen werden diese decodiert.Route parameters with encoded slashes will have them decoded. example.com/api%2ftest wird zu example.com/api/test.example.com/api%2ftest will become example.com/api/test
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHESAZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES falsefalse Dies ist das Standardverhalten.This is the default behavior. Alle Routenparameter werden unverändert übergeben.All route parameters will be passed along unchanged

BeispielExample

Hier sehen Sie ein Beispiel für „proxies.json“ in einer Funktionen-App unter der URL myfunction.com.Here is an example proxies.json in a function app at the URL myfunction.com

{
    "$schema": "http://json.schemastore.org/proxies",
    "proxies": {
        "root": {
            "matchCondition": {
                "route": "/{*all}"
            },
            "backendUri": "example.com/{all}"
        }
    }
}
URL-DecodierungURL Decoding EingabeInput OutputOutput
truetrue myfunction.com/test%2fapimyfunction.com/test%2fapi example.com/test/apiexample.com/test/api
falsefalse myfunction.com/test%2fapimyfunction.com/test%2fapi example.com/test%2fapiexample.com/test%2fapi

Nächste SchritteNext steps

Informationen zum Aktualisieren von App-EinstellungenLearn how to update app settings

Weitere Informationen finden Sie unter den globalen Einstellungen in der Datei host.jsonSee global settings in the host.json file

Weitere App-Einstellungen für App Service-AppsSee other app settings for App Service apps