Freigeben über

Referenz zu App-Einstellungen für Azure Functions

App-Einstellungen in einer Funktions-App enthalten Konfigurationsoptionen, die sich auf deren Funktionen auswirken. Auf diese Einstellungen wird in Form von Umgebungsvariablen zugegriffen. In diesem Artikel werden die in Funktionen-Apps verfügbaren App-Einstellungen aufgelistet.

Es gibt mehrere Möglichkeiten zum Hinzufügen, Aktualisieren und Löschen von Funktionen-App-Einstellungen:

Zur Durchführung von Änderungen an den Funktions-App-Einstellungen muss Ihre Funktions-App neu gestartet werden.

In diesem Artikel werden Beispielwerte für Verbindungszeichenfolgen aus Gründen der Lesbarkeit abgeschnitten.

Azure Functions verwendet die Azure App Service-Plattform für das Hosting. Möglicherweise finden Sie einige Einstellungen, die für das Hosten Ihrer Funktions-App in Umgebungsvariablen und App-Einstellungen in Azure App Service relevant sind.

Überlegungen zu App-Einstellungen

Wenn Sie App-Einstellungen verwenden, sollten Sie die folgenden Überlegungen beachten:

  • Wenn Sie Anwendungseinstellungen ändern, wird ihre Funktions-App standardmäßig in allen Hostingplänen neu gestartet. Verwenden Sie bei Bereitstellungen ohne Ausfallzeiten beim Ändern von Einstellungen den Flex-Verbrauchsplan mit schrittweisen Aktualisierungen als Aktualisierungsstrategie für die Website. Weitere Hostingpläne finden Sie unter Optimieren von Bereitstellungen, um Anleitungen zur Minimierung von Ausfallzeiten zu erhalten.

  • In Einstellungsnamen sind der doppelte Unterstrich (__) und der Doppelpunkt (:) reservierte Werte. Doppelte Unterstriche werden sowohl unter Windows als auch unter Linux als hierarchische Trennzeichen interpretiert. Doppelpunkte werden nur unter Windows auf dieselbe Weise interpretiert. Die Einstellung „AzureFunctionsWebHost__hostid=somehost_123456“ würde beispielsweise als das folgende JSON-Objekt interpretiert:

    "AzureFunctionsWebHost": {
    "hostid": "somehost_123456"
}

    In diesem Artikel werden nur doppelte Unterstriche verwendet, da sie von beiden Betriebssystemen unterstützt werden. Die meisten der Einstellungen, welche Verbindungen mit verwalteter Identität unterstützen, verwenden doppelte Unterstriche.

  • Wenn Funktionen lokal ausgeführt werden, werden App-Einstellungen in der Values Sammlung im local.settings.jsonangegeben.

  • In der host.json Datei und in der local.settings.json Datei gibt es weitere Konfigurationsoptionen für Funktions-Apps.

  • Sie können Anwendungseinstellungen verwenden, um host.json-Einstellungswerte zu überschreiben, ohne die Datei „host.json“ ändern zu müssen. Dieser Ansatz ist hilfreich für Szenarien, in denen Sie bestimmte host.json Einstellungen für eine bestimmte Umgebung konfigurieren oder ändern müssen. Mit diesem Ansatz können Sie auch host.json Einstellungen ändern, ohne ihr Projekt erneut veröffentlichen zu müssen. Weitere Informationen finden Sie im Referenzartikel zu „host.json“.

  • In diesem Artikel werden die Einstellungen beschrieben, die für Ihre Funktions-Apps die größte Relevanz haben. Da Azure Functions unter App Service ausgeführt wird, werden auch andere App-Einstellungen unterstützt. Weitere Informationen finden Sie unter Umgebungsvariablen und App-Einstellungen in Azure App Service.

  • In einigen Szenarien müssen Sie auch mit Einstellungen arbeiten, die in den App Service Websiteeinstellungen dokumentiert sind.

  • Wenn Sie alle schreibgeschütztenApp Service-Anwendungseinstellungen ändern, können Sie Ihre Funktions-App in einen nicht reagierenden Zustand versetzen.

  • Beachten Sie dies beim Aktualisieren von Anwendungseinstellungen mithilfe von REST-APIs, einschließlich ARM-Vorlagen. Da diese APIs die vorhandenen Anwendungseinstellungen ersetzen, müssen Sie alle vorhandenen Einstellungen einschließen, wenn Sie Einstellungen mithilfe von REST-APIs oder ARM-Vorlagen hinzufügen oder ändern. Verwenden Sie nach Möglichkeit Azure CLI oder Azure PowerShell, um programmgesteuert mit Anwendungseinstellungen zu arbeiten. Weitere Informationen finden Sie unter Verwenden von Anwendungseinstellungen.

APPINSIGHTS_INSTRUMENTATIONKEY

Der Instrumentierungsschlüssel für Application Insights. Sie sollten weder APPINSIGHTS_INSTRUMENTATIONKEY noch APPLICATIONINSIGHTS_CONNECTION_STRING verwenden. Verwenden Sie nach Möglichkeit APPLICATIONINSIGHTS_CONNECTION_STRING. Wenn Application Insights in einer Sovereign Cloud ausgeführt wird, verwenden Sie APPLICATIONINSIGHTS_CONNECTION_STRING. Weitere Informationen finden Sie unter Konfigurieren der Überwachung für Azure Functions.

Key Beispielwert
APPINSIGHTS_INSTRUMENTATIONKEY 55555555-af77-484b-9032-64f83bb83bb

Sie sollten weder APPINSIGHTS_INSTRUMENTATIONKEY noch APPLICATIONINSIGHTS_CONNECTION_STRING verwenden. Es wird empfohlen, APPLICATIONINSIGHTS_CONNECTION_STRING zu verwenden.

APPLICATIONINSIGHTS_AUTHENTICATION_STRING

Ermöglicht den Zugriff auf Application Insights mithilfe der Microsoft Entra-Authentifizierung. Verwenden Sie diese Einstellung, wenn Sie eine Verbindung zu Ihrem Application Insights-Arbeitsbereich über die Microsoft Entra-Authentifizierung herstellen müssen. Weitere Informationen finden Sie unter Microsoft Entra-Authentifizierung für Application Insights.

Bei Verwendung von APPLICATIONINSIGHTS_AUTHENTICATION_STRING hängt der von Ihnen festgelegte spezifische Wert vom Typ der verwalteten Identität ab:

Verwaltete Identität Einstellungswert
System-assigned Authorization=AAD
User-assigned Authorization=AAD;ClientId=<USER_ASSIGNED_CLIENT_ID>

Diese Authentifizierungsanforderung wird auf Verbindungen vom Functions-Host, Momentaufnahmedebugger, Profiler und allen sprachspezifischen Agents angewendet. Um diese Einstellung zu verwenden, muss die verwaltete Identität bereits für die Funktions-App verfügbar sein, wobei eine zugewiesene Rolle dem Publisher für Überwachungsmetriken entspricht.

Note

Wenn Sie APPLICATIONINSIGHTS_AUTHENTICATION_STRING zum Herstellen einer Verbindung mit Application Insights mithilfe der Microsoft Entra-Authentifizierung verwenden, sollten Sie auch Lokale Authentifizierung für Application Insights deaktivieren. Diese Konfiguration erfordert die Microsoft Entra-Authentifizierung, damit Telemetrie in Ihren Arbeitsbereich aufgenommen werden kann.

APPLICATIONINSIGHTS_CONNECTION_STRING

Die Verbindungszeichenfolge für Application Insights. Sie sollten weder APPINSIGHTS_INSTRUMENTATIONKEY noch APPLICATIONINSIGHTS_CONNECTION_STRING verwenden. Wir empfehlen die Verwendung APPLICATIONINSIGHTS_CONNECTION_STRING in allen Fällen. Dies ist eine Anforderung in den folgenden Fällen:

  • Wenn Ihre Funktions-App die zusätzlichen Anpassungen erfordert, die bei Verwendung der Verbindungszeichenfolge unterstützt werden
  • Wenn Ihre Application Insights-Instanz in einer Sovereign Cloud ausgeführt wird, für die ein benutzerdefinierter Endpunkt erforderlich ist

Weitere Informationen finden Sie unter Verbindungszeichenfolgen.

Key Beispielwert
APPLICATIONINSIGHTS_CONNECTION_STRING InstrumentationKey=...

Um eine Verbindung zu Application Insights mit Microsoft Entra-Authentifizierung herzustellen, sollten Sie APPLICATIONINSIGHTS_AUTHENTICATION_STRING verwenden.

AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL

Important

Azure Functions-Proxys waren ein Feature der Versionen 1.x bis 3.x der Azure Functions-Laufzeit. Weitere Informationen finden Sie unter Funktionsproxys.

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES

Important

Azure Functions-Proxys waren ein Feature der Versionen 1.x bis 3.x der Azure Functions-Laufzeit. Weitere Informationen finden Sie unter Funktionsproxys.

AZURE_FUNCTIONS_ENVIRONMENT

Konfiguriert die Laufzeit-Hostingumgebung der Funktions-App, wenn diese in Azure ausgeführt wird. Dieser Wert wird während der Initialisierung gelesen. Die Laufzeit akzeptiert nur die folgenden Werte:

Value Description
Production Stellt eine Produktionsumgebung mit reduzierter Protokollierung und vollständigen Leistungsoptimierungen dar. Dieser Wert ist der Standardwert, wenn AZURE_FUNCTIONS_ENVIRONMENT entweder kein Wert festgelegt oder auf einen nicht unterstützten Wert festgelegt wird.
Staging Stellt eine Staging-Umgebung dar, z. B. wenn sie in einem staging-Slot ausgeführt wird.
Development Eine Entwicklungsumgebung unterstützt ausführlichere Protokollierung und andere reduzierte Leistungsoptimierungen. Die Azure Functions Core Tools legen AZURE_FUNCTIONS_ENVIRONMENT auf Development fest, wenn sie auf Ihrem lokalen Computer ausgeführt werden. Diese Einstellung kann in der Datei local.settings.json nicht überschrieben werden.

Verwenden Sie diese Einstellung anstelle von ASPNETCORE_ENVIRONMENT, wenn Sie die Runtimeumgebung in Azure in einen anderen Wert als Production ändern müssen. Weitere Informationen finden Sie unter Umgebungsbasierte Startklasse und -methoden.

Diese Einstellung ist in Version 1.x der Functions-Runtime nicht verfügbar.

AzureFunctionsJobHost__*

In Version 2.x und höheren Versionen der Funktionslaufzeit können Anwendungseinstellungen host.json Einstellungen in der aktuellen Umgebung außer Kraft setzen. Diese Außerkraftsetzungen werden als Anwendungseinstellungen namens AzureFunctionsJobHost__path__to__setting ausgedrückt. Weitere Informationen finden Sie unter Außerkraftsetzung der Werte in der Datei „host.json“.

AzureFunctionsWebHost__hostid

Legt die Host-ID für eine bestimmte Funktions-App fest, die eine eindeutige ID sein sollte. Diese Einstellung überschreibt den automatisch generierten Host-ID-Wert für Ihre App. Verwenden Sie diese Einstellung nur, wenn Sie Host-ID-Konflikte zwischen Funktions-Apps verhindern müssen, die das gleiche Speicherkonto gemeinsam verwenden.

Eine Host-ID muss die folgenden Anforderungen erfüllen:

  • Sie muss zwischen 1 und 32 Zeichen lang sein.
  • Nur Kleinbuchstaben, Zahlen und Striche enthalten
  • Sie darf nicht mit einem Bindestrich beginnen oder enden.
  • Sie darf keine aufeinander folgenden Bindestriche enthalten.

Eine einfache Möglichkeit, eine ID zu generieren, besteht darin, eine GUID zu verwenden, die Bindestriche zu entfernen und sie in Kleinbuchstaben umzuwandeln, z. B. indem die GUID 1835D7B5-5C98-4790-815D-072CC94C6F71 in den Wert 1835d7b55c984790815d072cc94c6f71 konvertiert wird.

Key Beispielwert
AzureFunctionsWebHost__hostid myuniquefunctionappname123456789

Weitere Informationen finden Sie unter Überlegungen zur Host-ID.

AzureWebJobsDashboard

Diese Einstellung ist veraltet und wird nur unterstützt, wenn sie auf Version 1.x der Azure Functions-Runtime ausgeführt wird.

Optionale Verbindungszeichenfolge für das Speicherkonto zum Speichern von Protokollen und Anzeigen von ihnen auf der Registerkarte "Monitor" im Azure-Portal. Das Speicherkonto muss ein allgemeines Konto sein, das BLOBs, Warteschlangen und Tabellen unterstützt. Weitere Informationen finden Sie unter Speicherkontoanforderungen.

Key Beispielwert
AzureWebJobsDashboard DefaultEndpointsProtocol=https;AccountName=...

AzureWebJobsDisableHomepage

Ein Wert von „true“ bedeutet, dass die standardmäßige Landing Page deaktiviert wird, die für die Stamm-URL einer Funktions-App angezeigt wird. Standardwert: false.

Key Beispielwert
AzureWebJobsDisableHomepage true

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.

Screenshot der Startseite der Funktions-App.

AzureWebJobsDotNetReleaseCompilation

true bedeutet, dass der Release-Modus beim Kompilieren von .NET-Code verwendet werden soll. false bedeutet, dass der Debugmodus verwendet wird. Der Standardwert ist true.

Key Beispielwert
AzureWebJobsDotNetReleaseCompilation true

AzureWebJobsFeatureFlags

Eine durch Trennzeichen getrennte Liste der zu aktivierenden Features der Betaversion. Durch diese Flags aktivierte Features der Betaversion sind nicht bereit für die Produktion, können aber zur experimentellen Verwendung aktiviert werden, bevor sie live geschaltet werden.

Key Beispielwert
AzureWebJobsFeatureFlags feature1,feature2,EnableProxies

Wenn Ihre App derzeit über diese Einstellung verfügt, fügen Sie am Ende der durch Trennzeichen getrennten Liste neue Flags hinzu.

Derzeit unterstützte Featurekennzeichnungen:

Flagwert Description
EnableProxies Reaktiviert Proxies in Version 4.x der Functions Runtime, während Sie Ihre Migration zu Azure API Management planen. Weitere Informationen finden Sie unter Erneutes Aktivieren von Proxys in Functions v4.x.
EnableAzureMonitorTimeIsoFormat Aktiviert das ISO 8601-Zeitformat in Azure Monitor-Protokollen für Linux-Apps, die auf einem dedizierten Plan (App Service) ausgeführt werden.

AzureWebJobsKubernetesSecretName

Gibt die Kubernetes-Geheimnisressource an, die zum Speichern von Schlüsseln verwendet wird. Wird nur bei Ausführung in Kubernetes unterstützt.

Key Beispielwert
AzureWebJobsKubernetesSecretName <SECRETS_RESOURCE>

Überlegungen bei verwendung einer Kubernetes Secrets-Ressource:

  • Sie müssen auch AzureWebJobsSecretStorageType auf kubernetes setzen. Wenn AzureWebJobsKubernetesSecretName nicht festgelegt ist, wird das Repository als schreibgeschützt betrachtet. In diesem Fall müssen die Werte vor der Bereitstellung generiert werden.
  • Die Azure Functions Core Tools generieren die Werte automatisch bei Bereitstellung in Kubernetes.
  • Unveränderliche Geheimschlüssel werden nicht unterstützt und die Verwendung führt zu Laufzeitfehlern.

Weitere Informationen finden Sie unter Verwalten des Schlüsselspeichers.

AzureWebJobsSecretStorageKeyVaultClientId

Die Client-ID der vom Benutzer zugewiesenen verwalteten Identität oder die App-Registrierung, die für den Zugriff auf den Tresor verwendet wird, in dem Schlüssel gespeichert werden. Diese Einstellung erfordert, dass Sie „AzureWebJobsSecretStorageType“ auf festlegen „keyvault“. Wird in Version 4.x und höher der Functions-Runtime unterstützt.

Key Beispielwert
AzureWebJobsSecretStorageKeyVaultClientId <CLIENT_ID>

Weitere Informationen finden Sie unter Verwalten des Schlüsselspeichers.

AzureWebJobsSecretStorageKeyVaultClientSecret

Das Geheimnis für die Client-ID der vom Benutzer zugewiesenen verwalteten Identität oder die App-Registrierung, die für den Zugriff auf den Tresor verwendet wird, in dem Schlüssel gespeichert werden. Diese Einstellung erfordert, dass Sie „AzureWebJobsSecretStorageType“ auf festlegen „keyvault“. Wird in Version 4.x und höher der Functions-Runtime unterstützt.

Key Beispielwert
AzureWebJobsSecretStorageKeyVaultClientSecret <CLIENT_SECRET>

Weitere Informationen finden Sie unter Verwalten des Schlüsselspeichers.

AzureWebJobsSecretStorageKeyVaultName

Diese Einstellung ist veraltet und wurde nur verwendet, als sie auf Version 3.x der Azure Functions-Runtime ausgeführt wurde.

Der Name einer Schlüsseltresorinstanz, die zum Speichern von Schlüsseln verwendet wird. Diese Einstellung wurde nur in Version 3.x der Funktionslaufzeit verwendet, die nicht mehr unterstützt wird. Verwenden Sie für Version 4.x stattdessen AzureWebJobsSecretStorageKeyVaultUri. Diese Einstellung erfordert, dass Sie „AzureWebJobsSecretStorageType“ auf festlegen „keyvault“.

Der Tresor muss über eine Zugriffsrichtlinie verfügen, die der systemseitig zugewiesenen verwalteten Identität der Hostingressource entspricht. Die Zugriffsrichtlinie sollte der Identität die folgenden Geheimnisberechtigungen gewähren: Get, Set, List und Delete.

Wenn Ihre Funktionen lokal ausgeführt werden, wird die Entwickleridentität verwendet. Die Einstellungen müssen sich in der dateilocal.settings.json befinden.

Key Beispielwert
AzureWebJobsSecretStorageKeyVaultName <VAULT_NAME>

Weitere Informationen finden Sie unter Verwalten des Schlüsselspeichers.

AzureWebJobsSecretStorageKeyVaultTenantId

Die Mandanten-ID der App-Registrierung, die für den Zugriff auf den Tresor verwendet wird, in dem Schlüssel gespeichert werden. Diese Einstellung erfordert, dass Sie „AzureWebJobsSecretStorageType“ auf festlegen „keyvault“. Wird in Version 4.x und höher der Functions-Runtime unterstützt. Weitere Informationen finden Sie unter Verwalten des Schlüsselspeichers.

Key Beispielwert
AzureWebJobsSecretStorageKeyVaultTenantId <TENANT_ID>

AzureWebJobsSecretStorageKeyVaultUri

Der Name einer Schlüsseltresorinstanz, die zum Speichern von Schlüsseln verwendet wird. Wird in Version 4.x und höher der Functions-Runtime unterstützt. Wir empfehlen diese Einstellung für die Verwendung einer Key Vault-Instanz für die Schlüsselspeicherung. Diese Einstellung erfordert, dass Sie „AzureWebJobsSecretStorageType“ auf festlegen „keyvault“.

Der AzureWebJobsSecretStorageKeyVaultUri Wert sollte der vollständige Wert des Vault-URI sein, der auf der Registerkarte " Key Vault-Übersicht " angezeigt wird, einschließlich https://.

Der Tresor muss über eine Zugriffsrichtlinie verfügen, die der systemseitig zugewiesenen verwalteten Identität der Hostingressource entspricht. Die Zugriffsrichtlinie sollte der Identität die folgenden Geheimnisberechtigungen gewähren: Get, Set, List und Delete.
Wenn Ihre Funktionen lokal ausgeführt werden, wird die Entwickleridentität verwendet, und Einstellungen müssen sich in der local.settings.json Datei befinden.

Key Beispielwert
AzureWebJobsSecretStorageKeyVaultUri https://<VAULT_NAME>.vault.azure.net

Important

Geheimnisse werden nicht über die AzureWebJobsSecretStorageKeyVaultUri-Einstellung für einzelne Funktions-Apps festgelegt. Wenn mehrere Funktions-Apps so konfiguriert sind, dass sie denselben Schlüsseltresor verwenden, verwenden sie die gleichen Geheimnisse, was möglicherweise zu Schlüsselkonflikten oder Überschreibungen führt. Um unbeabsichtigtes Verhalten zu vermeiden, empfiehlt es sich, für jede Funktions-App eine separate Key Vault-Instanz zu verwenden.

Weitere Informationen finden Sie unter Verwalten des Schlüsselspeichers.

AzureWebJobsSecretStorageSas

Ein Blob Storage SAS-URL für ein zweites Speicherkonto, das für die Schlüsselspeicherung verwendet wird. Standardmäßig verwendet Functions das in AzureWebJobsStorage festgelegte Konto. Wenn Sie diese Geheimnisspeicheroption verwenden, stellen Sie sicher, dass AzureWebJobsSecretStorageType nicht explizit oder auf blob festgelegt ist. Weitere Informationen finden Sie unter Verwalten des Schlüsselspeichers.

Key Beispielwert
AzureWebJobsSecretStorageSas <BLOB_SAS_URL>

AzureWebJobsSecretStorageType

Gibt das Repository oder den Anbieter an, das bzw. der zum Speichern von Schlüsseln verwendet wird. Schlüssel werden vor der Speicherung immer mit einem Geheimnis verschlüsselt, das für Ihre Funktions-App eindeutig ist.

Key Value Description
AzureWebJobsSecretStorageType blob Schlüssel werden in einem Blob Storage-Container in dem Konto gespeichert, das von der AzureWebJobsStorage-Einstellung bereitgestellt wird. Blob Storage ist das Standardverhalten, wenn „AzureWebJobsSecretStorageType“ nicht festgelegt ist.
Um ein anderes Speicherkonto anzugeben, verwenden Sie die AzureWebJobsSecretStorageSas-Einstellung, um die SAS-URL eines zweiten Speicherkontos anzugeben.
AzureWebJobsSecretStorageType files Schlüssel werden im Dateisystem persistent gespeichert. Dieses Verhalten ist die Standardeinstellung für Funktionen v1.x.
AzureWebJobsSecretStorageType keyvault Schlüssel werden in einer Schlüsseltresorinstanz gespeichert, die von AzureWebJobsSecretStorageKeyVaultName festgelegt wird.
AzureWebJobsSecretStorageType kubernetes Nur unterstützt, wenn die Functions-Laufzeit in Kubernetes ausgeführt wird. Wenn AzureWebJobsKubernetesSecretName nicht festgelegt ist, wird das Repository als schreibgeschützt betrachtet. In diesem Fall müssen die Werte vor der Bereitstellung generiert werden. Die Azure Functions Core Tools generieren die Werte automatisch bei Bereitstellung in Kubernetes.

Weitere Informationen finden Sie unter Verwalten des Schlüsselspeichers.

AzureWebJobsStorage

Gibt die Verbindungszeichenfolge für ein Azure Storage-Konto an, das von der Functions-Runtime für normale Vorgänge verwendet wird. Einige Verwendungsmöglichkeiten für dieses Speicherkonto durch Functions umfassen Schlüsselverwaltung, Verwaltung der Selbstauslösertrigger und Event Hubs-Prüfpunkte. Das Speicherkonto muss ein allgemeines Konto sein, das BLOBs, Warteschlangen und Tabellen unterstützt. Weitere Informationen finden Sie unter Anforderungen an das Speicherkonto.

Key Beispielwert
AzureWebJobsStorage DefaultEndpointsProtocol=https;AccountName=...

Anstelle einer Verbindungszeichenfolge können Sie eine identitätsbasierte Verbindung für dieses Speicherkonto verwenden. Weitere Informationen finden Sie unter Verbinden mit dem Hostspeicher mit einer Identität.

AzureWebJobsStorage__accountName

Wenn Sie eine identitätsbasierte Speicherverbindung verwenden, wird der Kontoname des Speicherkontos festgelegt, anstatt die Verbindungszeichenfolge in AzureWebJobsStorage zu verwenden. Diese Syntax ist für AzureWebJobsStorage eindeutig und kann nicht für andere identitätsbasierte Verbindungen verwendet werden.

Key Beispielwert
AzureWebJobsStorage__accountName <STORAGE_ACCOUNT_NAME>

Für Sovereign Clouds oder bei Verwendung eines benutzerdefinierten DNS müssen Sie stattdessen die dienstspezifischen AzureWebJobsStorage__*ServiceUri-Einstellungen verwenden.

AzureWebJobsStorage__blobServiceUri

Wenn Sie eine identitätsbasierte Speicherverbindung verwenden, wird der Datenebene-URI des BLOB-Diensts des Speicherkontos festgelegt.

Key Beispielwert
AzureWebJobsStorage__blobServiceUri https://<STORAGE_ACCOUNT_NAME>.blob.core.windows.net

Verwenden Sie diese Einstellung anstelle von AzureWebJobsStorage__accountName in Sovereign Clouds oder bei Verwendung eines benutzerdefinierten DNS. Weitere Informationen finden Sie unter Verbinden mit dem Hostspeicher mit einer Identität.

AzureWebJobsStorage__clientId

Legt die Client-ID einer bestimmten benutzerseitig zugewiesenen Identität fest, die zum Abrufen eines Zugriffstokens für die verwaltete Identitätsauthentifizierung verwendet wird. Erfordert, dass AzureWebJobsStorage__credential auf managedidentity festgelegt ist. Der Wert ist eine Client-ID, die einer der Anwendung zugewiesenen Identität entspricht. Sie können nicht sowohl AzureWebJobsStorage__managedIdentityResourceId als auch AzureWebJobsStorage__clientId festlegen. Sofern nichts angegeben ist, wird die systemseitig zugewiesene Identität verwendet.

AzureWebJobsStorage__credential

Definiert, wie ein Zugriffstoken für die Verbindung abgerufen wird. Verwenden Sie managedidentity für die Authentifizierung der verwalteten Identität. Bei Verwendung von managedidentity muss eine verwaltete Identität in der Hostingumgebung verfügbar sein. Legen Sie AzureWebJobsStorage__credential in lokalen Entwicklungsszenarien nicht fest.

AzureWebJobsStorage__managedIdentityResourceId

Legt die Ressourcen-ID einer bestimmten benutzerseitig zugewiesenen Identität fest, die zum Abrufen eines Zugriffstokens für die verwaltete Identitätsauthentifizierung verwendet wird. Erfordert, dass AzureWebJobsStorage__credential auf managedidentity festgelegt ist. Der Wert ist die Ressourcen-ID einer Identität, die der Anwendung zugewiesen ist, die für die verwaltete Identitätsauthentifizierung verwendet wird. Sie können nicht sowohl AzureWebJobsStorage__managedIdentityResourceId als auch AzureWebJobsStorage__clientId festlegen. Sofern nichts angegeben ist, wird die systemseitig zugewiesene Identität verwendet.

AzureWebJobsStorage__queueServiceUri

Bei Verwendung einer identitätsbasierten Speicherverbindung wird der Datenebene-URI des Warteschlangendiensts des Speicherkontos festgelegt.

Key Beispielwert
AzureWebJobsStorage__queueServiceUri https://<STORAGE_ACCOUNT_NAME>.queue.core.windows.net

Verwenden Sie diese Einstellung anstelle von AzureWebJobsStorage__accountName in Sovereign Clouds oder bei Verwendung eines benutzerdefinierten DNS. Weitere Informationen finden Sie unter Verbinden mit dem Hostspeicher mit einer Identität.

AzureWebJobsStorage__tableServiceUri

Bei Verwendung einer identitätsbasierten Speicherverbindung wird der Datenebene-URI eines Tabellendiensts des Speicherkontos festgelegt.

Key Beispielwert
AzureWebJobsStorage__tableServiceUri https://<STORAGE_ACCOUNT_NAME>.table.core.windows.net

Verwenden Sie diese Einstellung anstelle von AzureWebJobsStorage__accountName in Sovereign Clouds oder bei Verwendung eines benutzerdefinierten DNS. Weitere Informationen finden Sie unter Verbinden mit dem Hostspeicher mit einer Identität.

AzureWebJobs_TypeScriptPath

Der Pfad zum Compiler, der für TypeScript verwendet wird. Bei Bedarf können Sie den Standardwert außer Kraft setzen.

Key Beispielwert
AzureWebJobs_TypeScriptPath %HOME%\typescript

DOCKER_REGISTRY_SERVER_PASSWORD

Gibt das Kennwort an, das für den Zugriff auf eine private Containerregistrierung verwendet wird. Diese Einstellung ist nur erforderlich, wenn Sie Ihre containerisierte Funktions-App aus einer privaten Containerregistrierung bereitstellen. Weitere Informationen finden Sie unter Umgebungsvariablen und App-Einstellungen in Azure App Service.

DOCKER_REGISTRY_SERVER_URL

Gibt die URL einer privaten Containerregistrierung an. Diese Einstellung ist nur erforderlich, wenn Sie Ihre containerisierte Funktions-App aus einer privaten Containerregistrierung bereitstellen. Weitere Informationen finden Sie unter Umgebungsvariablen und App-Einstellungen in Azure App Service.

DOCKER_REGISTRY_SERVER_USERNAME

Gibt das Konto an, das für den Zugriff auf eine private Containerregistrierung verwendet wird. Diese Einstellung ist nur erforderlich, wenn Sie Ihre containerisierte Funktions-App aus einer privaten Containerregistrierung bereitstellen. Weitere Informationen finden Sie unter Umgebungsvariablen und App-Einstellungen in Azure App Service.

DOCKER_SHM_SIZE

Legt die Größe des gemeinsam genutzten Speichers (in Bytes) fest, wenn der Python-Worker gemeinsam genutzten Speicher verwendet. Weitere Informationen finden Sie unter "Freigegebener Speicher".

Key Beispielwert
DOCKER_SHM_SIZE 268435456

Der vorangehende Wert legt eine freigegebene Speichergröße von ~256 MB fest.

Erfordert, dass FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED auf 1 gesetzt ist.

ENABLE_ORYX_BUILD

Gibt an, ob das Oryx-Buildsystem während der Bereitstellung verwendet wird. „ENABLE_ORYX_BUILD“ muss auf „true“ festgelegt werden, wenn Remotebuildbereitstellungen unter Linux ausgeführt werden. Weitere Informationen finden Sie unter Remotebuild.

Key Beispielwert
ENABLE_ORYX_BUILD true

FUNCTION_APP_EDIT_MODE

Gibt an, ob Sie Ihre Funktions-App im Azure-Portal bearbeiten können. Gültige Werte sind readwrite und readonly.

Key Beispielwert
FUNCTION_APP_EDIT_MODE readonly

Die Laufzeit legt den Wert basierend auf dem Sprachstapel und dem Bereitstellungsstatus Ihrer Funktions-App fest. Weitere Informationen finden Sie unter Entwicklungseinschränkungen im Azure-Portal.

FUNCTIONS_EXTENSION_VERSION

Die Version der Functions-Runtime, die ihre Funktions-App hostet. Eine Tilde (~) mit Hauptversion bedeutet, die neueste Version dieser Hauptversion zu verwenden, ~4z. B. . Wenn neue kleinere Versionen für dieselbe Hauptversion verfügbar sind, werden sie automatisch in der Funktions-App installiert.

Key Beispielwert
FUNCTIONS_EXTENSION_VERSION ~4

Für die Hauptversion der Runtime werden folgende Werte unterstützt:

Value Laufzeitziel Comment
~4 4.x Recommended
~1 1.x Support endet am 14. September 2026

Der Wert ~4 bedeutet, dass Ihre App mit Version 4.x der Runtime ausgeführt wird. Der Wert ~1 heftet Ihre App an Version 1.x der Runtime an. Laufzeitversionen 2.x und 3.x werden nicht mehr unterstützt. Weitere Informationen finden Sie unter Einstellen von Runtimeversionen von Azure Functions als Ziel.

Wenn das Support-Team Sie auffordert, Ihre App auf eine bestimmte Nebenversion festzulegen, verwenden Sie z. B. die vollständige Versionsnummer, 4.0.12345. Weitere Informationen finden Sie unter Einstellen von Runtimeversionen von Azure Functions als Ziel.

FUNCTIONS_INPROC_NET8_ENABLED

Gibt an, ob eine App .NET 8 im In-Process-Modell verwenden kann. Um .NET 8 für das In-Process-Modell zu verwenden, muss dieser Wert auf 1 festgelegt werden. Umfassende Anweisungen, u. a. zu weiteren erforderlichen Konfigurationswerten, finden Sie unter Aktualisieren, um .NET 8 zu verwenden.

Key Beispielwert
FUNCTIONS_INPROC_NET8_ENABLED 1

Legen Sie die Option auf 0 fest, um die Unterstützung für .NET 8 im In-Process-Modell zu deaktivieren.

FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR

Diese App-Einstellung ist eine temporäre Möglichkeit für Node.js Apps, einen Breaking Change zu ermöglichen, der die Problembehandlung von Einstiegspunktfehlern auf Node.js v18 oder tiefer erleichtert. Wir empfehlen dringend die Verwendung von true, insbesondere für Apps mit Programmiermodell v4, die stets Einstiegspunktdateien benutzen. Das Verhalten ohne den Breaking Change (false) ignoriert Einstiegspunktfehler und protokolliert sie nicht in Application Insights.

Ab Node.js v20 hat die App-Einstellung keine Auswirkung, und das Verhalten für den Breaking Change ist immer aktiviert.

Für Node.js v18 oder niedriger wird die App-Einstellung verwendet, und das Standardverhalten hängt davon ab, ob der Fehler vor oder nach der Registrierung einer Modell v4-Funktion auftritt:

  • Wenn der Fehler zuvor ausgelöst wird, entspricht das Standardverhalten false. Wenn Sie beispielsweise Modell v3 verwenden oder Ihre Einstiegspunktdatei nicht vorhanden ist.
  • Wenn der Fehler danach ausgelöst wird, stimmt das Standardverhalten mit true überein. Wenn Sie beispielsweise versuchen, doppelte Modell-v4-Funktionen zu registrieren.
Key Value Description
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR true Blockieren Sie bei Einstiegspunktfehlern, und protokollieren Sie diese in Application Insights.
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR false Ignorieren Sie Einstiegspunktfehler, und protokollieren Sie diese nicht in Application Insights.

FUNCTIONS_REQUEST_BODY_SIZE_LIMIT

Überschreibt den Standardgrenzwert für die Textgröße von Anforderungen, die an HTTP-Endpunkte gesendet werden. Der Wert wird in Bytes angegeben, wobei die maximale Anforderungsgröße standardmäßig 104.857.600 Bytes beträgt.

Key Beispielwert
FUNCTIONS_REQUEST_BODY_SIZE_LIMIT 250000000

FUNCTIONS_V2_COMPATIBILITY_MODE

Important

Diese Einstellung wird nicht mehr unterstützt. Es wurde ursprünglich bereitgestellt, um eine kurzfristige Problemumgehung für Apps zu aktivieren, die auf die v2.x-Laufzeit ausgerichtet sind. Sie könnten stattdessen auf der v3.x-Laufzeit ausgeführt werden, solange sie noch unterstützt wird. Mit Ausnahme von Legacy-Apps, die auf Version 1.x ausgeführt werden, müssen alle Funktions-Apps auf Version 4.x der Functions-Runtime ausgeführt werden: FUNCTIONS_EXTENSION_VERSION=~4. Weitere Informationen finden Sie unter Einstellen von Runtimeversionen von Azure Functions als Ziel.

FUNCTIONS_WORKER_PROCESS_COUNT

Gibt die maximale Anzahl von Sprachworkerprozessen mit einem Standardwert von 1 an. Der zulässige Höchstwert ist 10. Funktionsaufrufe werden gleichmäßig zwischen Sprachworkerprozessen verteilt. Workerprozesse für Sprache werden alle 10 Sekunden bis zum Erreichen der von FUNCTIONS_WORKER_PROCESS_COUNT festgelegten Anzahl erzeugt. Die Verwendung mehrerer Sprachworkerprozesse ist nicht dasselbe wie Skalierung. Erwägen Sie die Verwendung dieser Einstellung, wenn Ihr Workload aus einer Mischung von CPU-gebundenen und E/A-gebundenen Aufrufen besteht. Diese Einstellung gilt für alle Sprachlaufzeiten, mit Ausnahme von .NET bei Ausführung im Prozess (FUNCTIONS_WORKER_RUNTIME=dotnet).

Key Beispielwert
FUNCTIONS_WORKER_PROCESS_COUNT 2

FUNCTIONS_WORKER_RUNTIME

Die Sprache oder der Sprachstapel der Workerruntime, die in der Funktions-App geladen werden soll. Dieser Wert entspricht der Sprache, die in Ihrer Anwendung verwendet wird, pythonz. B. . Ab Version 2.x der Azure Functions-Runtime kann eine bestimmte Funktions-App nur eine einzige Sprache unterstützen.

Key Beispielwert
FUNCTIONS_WORKER_RUNTIME node

Gültige Werte:

Value Sprache/Sprachstapel
dotnet C# (Klassenbibliothek)
C# (Skript)
dotnet-isolated C# (isolierter Workerprozess)
java Java
node JavaScript
TypeScript
powershell PowerShell
python Python
custom Other

FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED

Diese Einstellung ermöglicht es dem Python-Worker, gemeinsam genutzten Speicher zu verwenden, um den Durchsatz zu verbessern. Aktivieren Sie gemeinsam genutzten Speicher, wenn Ihre Python-Funktions-App auf Speicherengpässe trifft.

Key Beispielwert
FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED 1

Wenn diese Einstellung aktiviert ist, können Sie die Einstellung DOCKER_SHM_SIZE verwenden, um die Größe des gemeinsam genutzten Speichers festzulegen. Weitere Informationen finden Sie unter "Freigegebener Speicher".

JAVA_APPLICATIONINSIGHTS_ENABLE_TELEMETRY

Gibt an, ob der Java-Arbeitsprozess Telemetrie in einem Open Telemetry-Format an den Application Insights-Endpunkt ausgeben soll. Durch Festlegen dieses Flags auf True wird der Funktionen-Host angewiesen, den Java-Arbeitsprozess seine OpenTelemetry-Logs direkt streamen zu lassen, wodurch doppelte Einträge auf Hostebene verhindert werden. Weitere Informationen finden Sie unter Konfigurieren von Anwendungseinstellungen.

JAVA_ENABLE_SDK_TYPES

Ermöglicht Ihrer Funktions-App die Verwendung systemeigener Azure SDK-Typen in Bindungen.

Note

Die Unterstützung für die Bindung an SDK-Typen befindet sich derzeit in der Vorschau und ist auf das Azure Blob Storage SDK beschränkt. Weitere Informationen finden Sie unter SDK-Typen im Java-Referenzartikel.

Key Beispielwert
JAVA_ENABLE_SDK_TYPES true

Weitere Informationen finden Sie unter SDK-Typen im Java-Referenzartikel.

JAVA_OPTS

Wird verwendet, um den virtuellen Java-Computer (JVM) anzupassen, der verwendet wird, um Ihre Java-Funktionen auszuführen, wenn sie auf einem Premium-Plan oder einem dedizierten Plan ausgeführt werden. Wenn Sie mithilfe eines Verbrauchsplan ausgeführt werden, verwenden Sie stattdessen „languageWorkers__java__arguments“. Weitere Informationen finden Sie unter Customize JVM.

languageWorkers__java__arguments

Wird verwendet, um den virtuellen Java-Computer (JVM) anzupassen, der zum Ausführen Ihrer Java-Funktionen beim Ausführen eines Verbrauchsplans verwendet wird. Diese Einstellung erhöht die Kaltstartzeiten für Java-Funktionen, die in einem Verbrauchsplan ausgeführt werden. Verwenden Sie für einen Premium- oder Dedicated-Plan stattdessen „JAVA_OPTS“. Weitere Informationen finden Sie unter Customize JVM.

MDMaxBackgroundUpgradePeriod

Steuert den Zeitraum für Hintergrundupdates von verwalteten Abhängigkeiten für PowerShell-Funktions-Apps. Der Standardwert ist 7.00:00:00 (wöchentlich).

Jeder PowerShell-Workerprozess löst die Überprüfung auf Modulupgrades im PowerShell-Katalog beim Start des Prozesses und alle MDMaxBackgroundUpgradePeriod-Zeiträume nach dem Start aus. Wenn im PowerShell-Katalog eine neue Modulversion verfügbar ist, wird sie im Dateisystem installiert und PowerShell-Workern zur Verfügung gestellt. Wenn Sie diesen Wert verringern, kann Ihre Funktions-App neuere Modulversionen früher abrufen, aber auch die App-Ressourcenauslastung erhöhen, einschließlich Netzwerk-E/A, CPU und Speicher. Wenn Sie diesen Wert erhöhen, wird der App-Ressourceneinsatz verringert, aber möglicherweise auch die Bereitstellung neuer Modulversionen für Ihre App verzögert.

Key Beispielwert
MDMaxBackgroundUpgradePeriod 7.00:00:00

Weitere Informationen finden Sie unter "Abhängigkeitsverwaltung".

MDNewSnapshotCheckPeriod

Gibt an, wie oft jeder PowerShell-Worker überprüft, ob verwaltete Abhängigkeitsupgrades installiert sind. Die Standardhäufigkeit ist 01:00:00 (stündlich).

Nach der Installation neuer Modulversionen im Dateisystem müssen alle PowerShell-Workerprozesse neu gestartet werden. Das Neustarten von PowerShell-Mitarbeitern wirkt sich auf die App-Verfügbarkeit aus, da sie die Ausführung der aktuellen Funktion unterbrechen kann. Bis zum Abschluss des Neustarts aller PowerShell-Workerprozesse können Funktionsaufrufe entweder die alte oder neue Modulversion verwenden. Alle PowerShell-Worker werden innerhalb von MDNewSnapshotCheckPeriod neu gestartet.

In jedem MDNewSnapshotCheckPeriod-Zeitraum überprüft der PowerShell-Worker, ob Upgrades verwalteter Abhängigkeiten installiert wurden oder nicht. Wenn Upgrades installiert werden, wird ein Neustart initiiert. Das Erhöhen dieses Wert verringert die Häufigkeit von Unterbrechungen durch Neustarts. Die Erhöhung kann jedoch auch die Zeit verlängern, in der Funktionsaufrufe nicht deterministisch entweder die alte oder die neue Modulversion verwenden können.

Key Beispielwert
MDNewSnapshotCheckPeriod 01:00:00

Weitere Informationen finden Sie unter "Abhängigkeitsverwaltung".

MDMinBackgroundUpgradePeriod

Zeitraum nach einer vorherigen Upgradeüberprüfung verwalteter Abhängigkeiten, bevor eine weitere Upgradeüberprüfung gestartet wird. Der Standardwert ist 1.00:00:00 (täglich).

Um übermäßige Modulupgrades bei häufigen Workerneustarts zu vermeiden, wird die Überprüfung auf Modulupgrades nicht durchgeführt, wenn ein Worker diese Überprüfung bereits innerhalb des letzten MDMinBackgroundUpgradePeriod-Zeitraums ausgelöst hat.

Key Beispielwert
MDMinBackgroundUpgradePeriod 1.00:00:00

Weitere Informationen finden Sie unter "Abhängigkeitsverwaltung".

OTEL_EXPORTER_OTLP_ENDPOINT

Gibt die URL an, in die openTelemetry-formatierte Daten für die Aufnahme exportiert werden. Weitere Informationen finden Sie unter Verwenden von OpenTelemetry mit Azure-Funktionen.

OTEL_EXPORTER_OTLP_HEADERS

Legt eine optionale Liste von Headern fest, die auf alle ausgehenden Daten angewendet werden, die in einen OpenTelemetry-Endpunkt exportiert werden. Sie sollten diese Einstellung verwenden, wenn der OpenTelemetry-Endpunkt einen API-Schlüssel bereitstellen muss. Weitere Informationen finden Sie unter Verwenden von OpenTelemetry mit Azure-Funktionen.

PIP_INDEX_URL

Mit dieser Einstellung können Sie die Basis-URL des Python-Paketindex außer Kraft setzen, die standardmäßig https://pypi.org/simple lautet. Verwenden Sie diese Einstellung, wenn Sie einen Remotebuild mit benutzerdefinierten Abhängigkeiten ausführen müssen. Diese benutzerdefinierten Abhängigkeiten können sich in einem Paketindexrepository befinden, das PEP 503-konform (der einfachen Repository-API) ist, oder in einem lokalen Verzeichnis, das dasselbe Format einhält.

Key Beispielwert
PIP_INDEX_URL http://my.custom.package.repo/simple

Weitere Informationen finden Sie in der pip-Dokumentation für --index-url und unter Benutzerdefinierte Abhängigkeiten in der Python-Entwicklerreferenz.

PIP_EXTRA_INDEX_URL

Der Wert für diese Einstellung zeigt eine zusätzliche Index-URL für benutzerdefinierte Pakete für Python-Apps an, die zusätzlich zu --index-url verwendet werden soll. Verwenden Sie diese Einstellung, wenn Sie einen Remotebuild mit benutzerdefinierten Abhängigkeiten ausführen müssen, die sich in einem zusätzlichen Paketindex befinden. Es sollte dieselben Regeln wie „--index-url“ einhalten.

Key Beispielwert
PIP_EXTRA_INDEX_URL http://my.custom.package.repo/simple

Weitere Informationen finden Sie in der pip-Dokumentation für --extra-index-url und in der Python-Entwicklerreferenz unter Benutzerdefinierte Abhängigkeiten.

PROJECT

Eine Einstellung für die kontinuierliche Bereitstellung , die dem Kudu-Bereitstellungsdienst den Ordner in einem verbundenen Repository angibt, um das bereitstellungsfähige Projekt zu speichern.

Key Beispielwert
PROJECT WebProject/WebProject.csproj

PYTHON_APPLICATIONINSIGHTS_ENABLE_TELEMETRY

Gibt an, ob der Python-Arbeitsprozess Telemetrie in einem Open Telemetry-Format an den Application Insights-Endpunkt ausgeben soll. Wenn Sie dieses Kennzeichen auf True setzen, teilt dies dem Funktion-Host mit, dass der Python-Arbeitsprozess die OpenTelemetry-Daten an den Application Insights-Endpunkt exportieren darf. Weitere Informationen finden Sie unter Konfigurieren von Anwendungseinstellungen.

PYTHON_ISOLATE_WORKER_DEPENDENCIES

Die Konfiguration ist spezifisch für Python-Funktions-Apps. Sie definiert die Priorisierung der Modulladereihenfolge. Standardmäßig ist dieser Wert auf 0 festgelegt.

Key Value Description
PYTHON_ISOLATE_WORKER_DEPENDENCIES 0 Priorisiert das Laden der Python-Bibliotheken aus den Abhängigkeiten interner Python-Worker. Dies ist das Standardverhalten. In requirements.txt definierte Nicht-Microsoft-Bibliotheken können möglicherweise überschattet werden.
PYTHON_ISOLATE_WORKER_DEPENDENCIES 1 Priorisiert das Laden der Python-Bibliotheken aus dem in „requirements.txt“ definierten Paket der Anwendung. Dieser Wert verhindert, dass Ihre Bibliotheken mit internen Python-Workerbibliotheken kollidieren.

PYTHON_ENABLE_DEBUG_LOGGING

Aktiviert Protokollierung auf Debugebene in einer Python-Funktions-App. Der Wert 1 aktiviert Protokollierung auf Debugebene. Ohne diese Einstellung oder bei einem Wert von 0 werden nur Informationen und Protokolle auf höherer Ebene vom Python-Worker an den Functions-Host gesendet. Verwenden Sie diese Einstellung, wenn Sie Ihre Python-Funktionsausführungen debuggen oder deren Ablauf verfolgen.

Stellen Sie beim Debuggen von Python-Funktionen bei Bedarf auch eine Debug- oder Ablaufverfolgungsprotokollierungsebene in der host.json Datei fest. Weitere Informationen finden Sie unter Konfigurieren der Überwachung für Azure Functions.

PYTHON_ENABLE_OPENTELEMETRY

Gibt an, ob der Python-Arbeitsprozess Telemetrie in einen Open Telemetry-Endpunkt exportieren soll. Durch Festlegen dieses Flags True wird dem Funktionenhost mitgeteilt, dass der Python-Arbeitsprozess OpenTelemetry-Daten in die konfigurierte OTEL_EXPORTER_OTLP_ENDPOINT exportieren kann. Weitere Informationen finden Sie unter Konfigurieren von Anwendungseinstellungen.

PYTHON_ENABLE_WORKER_EXTENSIONS

Die Konfiguration ist spezifisch für Python-Funktions-Apps. Durch Festlegen dieses Werts 1 kann der Worker Python-Workererweiterungen laden, die in requirements.txt definiert sind. Sie ermöglicht Ihrer Funktions-App den Zugriff auf neue Features, die von Partnerpaketen bereitgestellt werden. Sie kann auch das Verhalten des Ladens und Aufrufs von Funktionen in Ihrer App ändern. Stellen Sie sicher, dass die von Ihnen ausgewählte Erweiterung vertrauenswürdig ist, da Sie das Risiko für die Verwendung tragen. Azure Functions gewährt keine ausdrücklichen Gewährleistungen für Erweiterungen. Informationen zur Verwendung einer Erweiterung finden Sie auf der jeweiligen Manpage oder in der Infodatei zur Erweiterung. Standardmäßig wird dieser Wert auf „0“ festgelegt.

Key Value Description
PYTHON_ENABLE_WORKER_EXTENSIONS 0 Deaktiviert alle Python-Workererweiterungen.
PYTHON_ENABLE_WORKER_EXTENSIONS 1 Erlaubt dem Python-Worker das Laden von Erweiterungen aus „requirements.txt“.

PYTHON_THREADPOOL_THREAD_COUNT

Gibt die maximale Anzahl von Threads an, die ein Python-Worker zur Ausführung von Funktionsaufrufen verwendet. Der Standardwert ist 1 für Python-Version 3.8 und darunter. Für die Python-Version 3.9 und höher ist der Wert auf None festgelegt. Diese Einstellung garantiert nicht die Anzahl von Threads, die bei Ausführungen festgelegt werden würden. Diese Einstellung ermöglicht es Python, die Anzahl von Threads auf den angegebenen Wert zu erhöhen. Die Einstellung gilt nur für Python-Funktions-Apps. Darüber hinaus gilt die Einstellung für synchrone Funktionsaufrufe und nicht für Coroutinen.

Key Beispielwert Höchstwert
PYTHON_THREADPOOL_THREAD_COUNT 2 32

SCALE_CONTROLLER_LOGGING_ENABLED

Diese Einstellung befindet sich derzeit in der Vorschauphase.

Diese Einstellung dient zum Steuern der Protokollierung über den Azure Functions-Skalierungscontroller. Weitere Informationen finden Sie unter Skalierungscontrollerprotokolle (Vorschau).

Key Beispielwert
SCALE_CONTROLLER_LOGGING_ENABLED AppInsights:Verbose

Der Wert für diesen Schlüssel wird im Format <DESTINATION>:<VERBOSITY> bereitgestellt, das wie folgt definiert ist:

Property Description
<DESTINATION> Das Ziel, an das Protokolle gesendet werden. Gültige Werte sind AppInsights und Blob.
Wenn Sie AppInsights verwenden, vergewissern Sie sich, dass Application Insights in der Funktions-App aktiviert ist.
Wenn Sie das Ziel auf Blob festgelegt haben, werden Protokolle in einem Blobcontainer mit dem Namen azure-functions-scale-controller in dem Standardspeicherkonto erstellt, das in der Anwendungseinstellung AzureWebJobsStorage festgelegt ist.
<VERBOSITY> Gibt die Protokollierungsstufe an. Unterstützte Werte sind None, Warning und Verbose.
Wenn diese Einstellung auf Verbose festgelegt ist, protokolliert der Skalierungscontroller einen Grund für jede Änderung an der Workeranzahl sowie Informationen zu den Triggern, die diese Entscheidungen beeinflussen. Ausführliche Protokolle enthalten Triggerwarnungen und die Hashes, die von den Triggern vor und nach dem Ausführen des Skalierungscontrollers verwendet werden.

Tip

Beachten Sie, dass es Auswirkungen auf die potenziellen Kosten für die Überwachung Ihrer Funktions-App haben kann, wenn die Protokollierung des Skalierungscontrollers weiterhin aktiviert ist. Erwägen Sie die Aktivierung der Protokollierung, bis Sie genügend Daten sammeln, um zu verstehen, wie der Skalierungscontroller verhält, und deaktivieren Sie sie dann.

SCM_DO_BUILD_DURING_DEPLOYMENT

Steuert das Remotebuildverhalten während der Bereitstellung. Wenn „SCM_DO_BUILD_DURING_DEPLOYMENT“ auf „true“ festgelegt ist, wird das Projekt während der Bereitstellung remote erstellt.

Key Beispielwert
SCM_DO_BUILD_DURING_DEPLOYMENT true

SCM_LOGSTREAM_TIMEOUT

Steuert das Timeout in Sekunden, wenn eine Verbindung mit Streamingprotokollen vorhanden ist. Der Standardwert beträgt 7.200 Sekunden (2 Stunden).

Key Beispielwert
SCM_LOGSTREAM_TIMEOUT 1800

Der vorherige Beispielwert von 1800 setzt ein Timeout von 30 Minuten. Weitere Informationen finden Sie unter Aktivieren des Streamings von Ausführungsprotokollen in Azure Functions.

WEBSITE_CONTENTAZUREFILECONNECTIONSTRING

Die Verbindungszeichenfolge für das Speicherkonto, in dem der Code der Funktions-App und die Konfiguration in ereignisgesteuerten Skalierungsplänen gespeichert werden. Weitere Informationen finden Sie unter Speicherkonto-Verbindungseinstellung.

Key Beispielwert
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING DefaultEndpointsProtocol=https;AccountName=...

Diese Einstellung ist sowohl für die Apps "Verbrauch" als auch für "Elastic Premium"-Pläne erforderlich. Für dedizierte Plan-Apps, die von Functions nicht dynamisch skaliert werden, ist es nicht erforderlich.

Der Flex-Verbrauchsplan ist jetzt der empfohlene serverlose Hostingplan für Azure Functions. Es bietet schnellere Skalierung, reduzierte Kaltstarts, private Netzwerke und mehr Kontrolle über Leistung und Kosten. Weitere Informationen finden Sie unter Flex Consumption Plan.

Das Ändern oder Entfernen dieser Einstellung kann dazu führen, dass Ihre Funktions-App nicht gestartet wird. Weitere Informationen finden Sie in diesem Artikel zur Problembehandlung.

Die Verwendung einer verwalteten Identität beim Zugriff auf die Dateifreigabe wird von Azure Files nicht unterstützt. Weitere Informationen finden Sie unter Unterstützte Azure Files-Authentifizierungsszenarien.

WEBSITE_CONTENTOVERVNET

Important

WEBSITE_CONTENTOVERVNET ist eine veraltete App-Einstellung, die durch die vnetContentShareEnabled Websiteeigenschaft ersetzt wurde.

Der Wert 1 ermöglicht die stempelübergreifende Skalierung Ihrer Funktions-App, wenn Sie Ihr Speicherkonto auf ein virtuelles Netzwerk beschränken. Sie sollten diese Einstellung aktivieren, wenn Sie Ihr Speicherkonto auf ein virtuelles Netzwerk einschränken. Sie ist nur erforderlich, wenn WEBSITE_CONTENTSHARE und WEBSITE_CONTENTAZUREFILECONNECTIONSTRING verwendet werden. Weitere Informationen finden Sie unter Einschränken Ihres Speicherkontos auf ein virtuelles Netzwerk.

Key Beispielwert
WEBSITE_CONTENTOVERVNET 1

Diese App-Einstellung ist für die stempelübergreifende Skalierung in den Plänen Elastisch Premium und Dedicated (App Service) (Standard und höher) erforderlich, wenn das Speicherkonto auf ein VNet beschränkt ist. Ohne diese Einstellung kann die Funktions-App nur innerhalb eines einzelnen Stempels skaliert werden (ca. 1 bis 20 Instanzen). Nicht unterstützt bei Ausführung auf einem Verbrauchsplan.

Note

Sie müssen beim Weiterleiten an die Inhaltsfreigabe in einem Speicherkonto, das von mehreren Funktions-Apps unter demselben Plan gemeinsam genutzt wird, besondere Sorgfalt anwenden. Weitere Informationen finden Sie im Artikel zu Speicherüberlegungen unter Konsistentes Routing über virtuelle Netzwerke.

WEBSITE_CONTENTSHARE

Der Name der Dateifreigabe, die Functions zum Speichern von Funktions-App-Code und Konfigurationsdateien verwendet. Dieser Inhalt wird von ereignisgesteuerten Skalierungsplänen benötigt. Wird mit WEBSITE_CONTENTAZUREFILECONNECTIONSTRING verwendet. Der Standard ist eine eindeutige, von der Runtime generierte Zeichenfolge, die mit dem Namen der Funktions-App beginnt. Weitere Informationen finden Sie unter Speicherkonto-Verbindungseinstellung.

Key Beispielwert
WEBSITE_CONTENTSHARE functionapp091999e2

Diese Einstellung ist nur für Verbrauchs- und Premium-Plan-Apps erforderlich. Sie ist nicht für Apps des dedizierten Plans erforderlich, die von Functions nicht dynamisch skaliert werden.

Der Flex-Verbrauchsplan ist jetzt der empfohlene serverlose Hostingplan für Azure Functions. Es bietet schnellere Skalierung, reduzierte Kaltstarts, private Netzwerke und mehr Kontrolle über Leistung und Kosten. Weitere Informationen finden Sie unter Flex Consumption Plan.

Die Freigabe wird erstellt, wenn Ihre Funktions-App erstellt wird. Das Ändern oder Entfernen dieser Einstellung kann dazu führen, dass Ihre Funktions-App nicht gestartet wird. Weitere Informationen finden Sie in diesem Artikel zur Problembehandlung.

Die folgenden Überlegungen gelten für die Verwendung einer Azure Resource Manager (ARM)-Vorlage oder einer Bicep-Datei zum Erstellen einer Funktions-App während der Bereitstellung:

  • Wenn Sie keinen WEBSITE_CONTENTSHARE-Wert für die Hauptfunktions-App oder Apps in Slots festlegen, werden eindeutige Freigabewerte für Sie generiert. WEBSITE_CONTENTSHARE nicht festzulegen ist der empfohlene Ansatz für eine ARM-Vorlagenbereitstellung.
  • Es gibt Szenarien, in denen Sie den WEBSITE_CONTENTSHARE-Wert auf einen vordefinierten Wert festlegen müssen, z. B. wenn Sie ein gesichertes Speicherkonto in einem virtuellen Netzwerk verwenden. In diesem Fall müssen Sie einen eindeutigen Freigabenamen für die Hauptfunktions-App und die App für jeden Bereitstellungsslot festlegen. Für ein Speicherkonto, das durch ein virtuelles Netzwerk gesichert ist, müssen Sie auch das Share selbst als Teil des automatisierten Bereitstellungsprozesses erstellen. Weitere Informationen finden Sie unter Gesicherte Bereitstellungen.
  • WEBSITE_CONTENTSHARE darf keine Sloteinstellung sein.
  • Wenn Sie WEBSITE_CONTENTSHARE angeben, muss der Wert diese Anleitung für Freigabenamen befolgen.

WEBSITE_DNS_SERVER

Legt den von einer App verwendeten DNS-Server beim Auflösen von IP-Adressen fest. Diese Einstellung ist häufig erforderlich, wenn bestimmte Netzwerkfunktionen wie private Zonen von Azure DNS und private Endpunkte verwendet werden.

Key Beispielwert
WEBSITE_DNS_SERVER 168.63.129.16

WEBSITE_ENABLE_BROTLI_ENCODING

Steuert, ob Brotli-Codierung für die Komprimierung anstelle der GZIP-Standardkomprimierung verwendet wird. Wenn WEBSITE_ENABLE_BROTLI_ENCODING auf 1 festgelegt ist, wird die Brotli-Codierung verwendet. Andernfalls wird die gzip-Codierung verwendet.

WEBSITE_FUNCTIONS_ARMCACHE_ENABLED

Deaktiviert das Zwischenspeichern bei der Bereitstellung von Funktions-Apps mithilfe von Azure Resource Manager (ARM)-Vorlagen.

Key Beispielwert
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED 0

WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT

Die maximale Anzahl der Instanzen, auf denen die App aufskaliert werden kann. Dieser Wert ist standardmäßig unbegrenzt.

Important

Diese Einstellung befindet sich in der Vorschauphase. Eine App-Eigenschaft für die maximale Skalierung der Funktion ist jetzt vorhanden. Diese Eigenschaft wird empfohlen, um eine horizontale Skalierung zu begrenzen.

Key Beispielwert
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT 5

WEBSITE_NODE_DEFAULT_VERSION

Nur Windows. Legt die Version von Node.js fest, die beim Ausführen Ihrer Funktions-App unter Windows verwendet werden soll. Sie sollten eine Tilde (~) verwenden, damit die Laufzeit die neueste verfügbare Version der Ziel-Hauptversion verwendet. Wird dieser Wert beispielsweise auf „~18“ festtgelegt, wird die neueste Version von Node.js 18 verwendet. Wenn eine Hauptversion mittels Tilde vorgegeben wird, müssen Sie die Nebenversion nicht manuell aktualisieren.

Key Beispielwert
WEBSITE_NODE_DEFAULT_VERSION ~18

WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS

Wenn Sie einen Steckplatztausch für eine Funktions-App ausführen, die auf einem Premium-Plan ausgeführt wird, kann der Tausch fehlschlagen, wenn das dedizierte Speicherkonto, das von der App verwendet wird, netzwerkeinschränkt ist. Dieser Fehler wird durch eine ältere Anwendungsprotokollierungsfunktion verursacht, die sowohl von Funktionen als auch vom App Service gemeinsam genutzt wird. Diese Einstellung überschreibt das Protokollierungsfeature der Vorgängerversion und ermöglicht den Austausch.

Key Beispielwert
WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS 0

Fügen Sie allen Slots WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS mit dem Wert 0 hinzu, um sicherzustellen, dass Ihre Austauschvorgänge nicht durch Legacydiagnoseeinstellungen blockiert werden. Sie haben auch die Möglichkeit, diese Einstellung und diesen Wert nur dem Produktionsslot als (dauerhafte) Bereitstellungsslot-Einstellung hinzufügen.

WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS

Standardmäßig sind die Versionseinstellungen für Funktions-Apps für jeden Slot spezifisch festgelegt. Diese Einstellung wird verwendet, wenn Sie Funktionen mithilfe von Deployment-Slots aktualisieren. Dieser Ansatz verhindert unerwartetes Verhalten aufgrund von Änderungsversionen nach einem Tausch. Wählen Sie für die Produktion und den Slot den Wert 0, um sicherzustellen, dass alle Versionseinstellungen ebenfalls ausgetauscht werden. Weitere Informationen finden Sie unter Aktualisieren mit Slots.

Key Beispielwert
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS 0

WEBSITE_RUN_FROM_PACKAGE

Ermöglicht es Ihrer Funktions-App, aus einer Paketdatei auszuführen, die lokal oder in einer externen URL bereitgestellt werden kann.

Key Beispielwert
WEBSITE_RUN_FROM_PACKAGE 1

Gültige Werte sind entweder eine URL, die in den Speicherort einer externen Bereitstellungspaketdatei aufgelöst werden kann, oder 1. Bei einer Festlegung auf 1 muss sich das Paket im Ordner d:\home\data\SitePackages befinden. Wenn Sie die Zip-Bereitstellung mit der Einstellung „WEBSITE_RUN_FROM_PACKAGE“ verwenden, wird das Paket automatisch an diesen Speicherort hochgeladen. Weitere Informationen finden Sie unter Ausführen Ihrer Azure Functions aus einem Paket.

Bei Verwendung von WEBSITE_RUN_FROM_PACKAGE=<URL> muss die URL in den Speicherort der Paketdatei an einem barrierefreien Speicherort aufgelöst werden, z. B. in einem Azure Blob Storage-Container. Der Container muss privat sein, um nicht autorisierten Zugriff zu verhindern. Dies erfordert, dass Sie entweder eine Shared Access Signature (SAS) in der URL oder die Microsoft Entra ID-Authentifizierung verwenden, um den Zugriff zuzulassen. Die Verwendung von Microsoft Entra ID mit verwalteten Identitäten wird empfohlen.

Dies ist ein Beispiel für die Einstellung von WEBSITE_RUN_FROM_PACKAGE auf die URL eines Bereitstellungspakets in einem Azure Blog Storage-Container:
WEBSITE_RUN_FROM_PACKAGE=https://contosostorageaccount.blob.core.windows.net/mycontainer/mypackage.zip

Bei Verwendung von SAS hängen Sie das Token als Abfrageparameter an die URL an.

Wenn Sie ein Paket aus Azure Blob Storage mithilfe einer benutzerseitig zugewiesenen verwalteten Identität bereitstellen, müssen Sie auch WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID auf die Ressourcen-ID der benutzerseitig zugewiesenen verwalteten Identität festlegen. Wenn Sie aus einer externen Paket-URL bereitstellen, müssen Sie auch Auslöser manuell synchronisieren. Weitere Informationen finden Sie unter Triggersynchronisierung.

WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID

Gibt die Ressourcen-ID einer benutzerseitig zugewiesenen verwalteten Identität an, die beim Zugriff auf ein Bereitstellungspaket aus einem externen Azure Blob Storage-Container verwendet wird, der mithilfe von Microsoft Entra ID gesichert ist. Für diese Einstellung muss WEBSITE_RUN_FROM_PACKAGE die URL des Bereitstellungspakets in einem privaten Container festgelegt werden.

Die Einstellung WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID=SystemAssigned entspricht dem Weglassen der Einstellung. In diesem Fall wird die vom System zugewiesene verwaltete Identität für die App verwendet.

WEBSITE_SKIP_CONTENTSHARE_VALIDATION

Die Einstellungen WEBSITE_CONTENTAZUREFILECONNECTIONSTRING und WEBSITE_CONTENTSHARE verfügen über zusätzliche Validierungsprüfungen, um sicherzustellen, dass die App ordnungsgemäß starten kann. Die Erstellung von Anwendungseinstellungen schlägt fehl, wenn die Funktions-App das Downstreamspeicherkonto oder Key Vault aufgrund von Netzwerkeinschränkungen oder anderen begrenzenden Faktoren nicht ordnungsgemäß aufrufen kann. Wenn WEBSITE_SKIP_CONTENTSHARE_VALIDATION auf 1 festgelegt ist, wird die Überprüfung übersprungen. Ansonsten wird der Wert auf 0 gesetzt, und die Überprüfung findet statt.

Key Beispielwert
WEBSITE_SKIP_CONTENTSHARE_VALIDATION 1

Wenn die Überprüfung übersprungen wird und entweder die Verbindungszeichenfolge oder die Inhaltsfreigabe ungültig ist, kann die App nicht ordnungsgemäß gestartet werden. In diesem Fall gibt Functions „HTTP 500“-Fehler zurück. Weitere Informationen finden Sie unter Problembehandlung für den Fehler „Azure Functions-Runtime ist nicht erreichbar“.

WEBSITE_SLOT_NAME

Read-only. Name des aktuellen Bereitstellungsslots. Der Name des Produktionsslots ist Production.

Key Beispielwert
WEBSITE_SLOT_NAME Production

WEBSITE_TIME_ZONE

Ermöglicht das Festlegen der Zeitzone für Ihre Funktions-App.

Key OS Beispielwert
WEBSITE_TIME_ZONE Windows Eastern Standard Time
WEBSITE_TIME_ZONE Linux America/New_York

Als Standardzeitzone wird in Verbindung mit den CRON-Ausdrücken die Coordinated Universal Time (UTC) verwendet. Wenn Sie möchten, dass Ihr CRON-Ausdruck auf einer anderen Zeitzone basiert, erstellen Sie eine App-Einstellung für die Funktionen-App mit dem Namen WEBSITE_TIME_ZONE.

Der Wert dieser Einstellung hängt davon ab, unter welchem Betriebssystem und Plan Ihre Funktions-App ausgeführt wird.

Betriebssystem Plan Value
Windows All Legen Sie den Wert auf den Namen der gewünschten Zeitzone fest, wie in der zweiten Zeile des vom Windows-Befehl tzutil.exe /L ausgegebenen Wertepaars angegeben.
Linux Premium
Dedicated		 Legen Sie den Wert auf den Namen der gewünschten Zeitzone fest, wie in der tz-Datenbank dargestellt.

Note

WEBSITE_TIME_ZONE und TZ werden derzeit nicht unterstützt, wenn sie unter Linux in einem Flex-Verbrauch - oder Verbrauchsplan ausgeführt werden. In diesem Fall kann das Festlegen von WEBSITE_TIME_ZONE oder TZ SSL-bezogene Probleme verursachen und dazu führen, dass Metriken für Ihre App nicht mehr funktionieren.

Ein Beispiel: Für die Zeitzone „Eastern Time“ in den USA (dargestellt durch Eastern Standard Time unter Windows oder America/New_York unter Linux) wird derzeit UTC-05:00 in der Standardzeit und UTC-04:00 in der Sommerzeit verwendet. Damit ein Timertrigger jeden Tag um 10:00 vormittags in der Zeitzone „Eastern Time“ ausgelöst wird, erstellen Sie eine App-Einstellung für Ihre Funktions-App mit dem Namen WEBSITE_TIME_ZONE, legen den Wert auf Eastern Standard Time (Windows) bzw. America/New_York (Linux) fest, und verwenden dann den folgenden NCRONTAB-Ausdruck:

"0 0 10 * * *"

Wenn Sie WEBSITE_TIME_ZONE verwenden, wird die Uhrzeit an Abweichungen in der jeweiligen Zeitzone angepasst, einschließlich Sommerzeit und Änderungen an der Standardzeit.

WEBSITE_USE_PLACEHOLDER

Gibt an, ob beim Ausführen des Verbrauchsplans eine bestimmte Kaltstartoptimierung verwendet werden soll. Legen Sie diese Einstellung auf „0“ fest, um die Optimierung des Kaltstarts für den Verbrauchsplan zu deaktivieren.

Key Beispielwert
WEBSITE_USE_PLACEHOLDER 1

WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED

Gibt an, ob beim Ausführen von .NET-Funktionen für isolierten Arbeitsprozess im Verbrauchsplan eine bestimmte Kaltstartoptimierung verwendet werden soll. Legen Sie diese Einstellung auf „0“ fest, um die Optimierung des Kaltstarts für den Verbrauchsplan zu deaktivieren.

Key Beispielwert
WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED 1

WEBSITE_VNET_ROUTE_ALL

Important

WEBSITE_VNET_ROUTE_ALL ist eine Ältere App-Einstellung, die durch die vnetRouteAllEnabled-Websiteeinstellung ersetzt wurde.

Gibt an, ob der gesamte ausgehende Datenverkehr von der App über das virtuelle Netzwerk weitergeleitet wird. Der Einstellungswert 1 gibt an, dass der gesamte Anwendungsdatenverkehr über das virtuelle Netzwerk weitergeleitet wird. Sie benötigen diese Einstellung, wenn Sie die Integration des regionalen virtuellen Netzwerks in den Elastic Premium- und dedizierten Hostingplänen konfigurieren. Sie wird auch verwendet, wenn ein Virtual Network NAT Gateway verwendet wird, um eine statische ausgehende IP-Adresse zu definieren.

Key Beispielwert
WEBSITE_VNET_ROUTE_ALL 1

WEBSITES_ENABLE_APP_SERVICE_STORAGE

Gibt an, ob das /home-Verzeichnis über skalierte Instanzen hinweg freigegeben wird, mit einem Standardwert von true. Sie sollten diesen Wert false festlegen, wenn Sie Ihre Funktions-App in einem Container bereitstellen.

App Service-Siteeinstellungen

Einige Konfigurationen, wie etwa Sprachversionen, müssen auf App Service-Ebene als Siteeinstellungen verwaltet werden. Diese Einstellungen werden im Azure-Portal mithilfe von REST-APIs oder mithilfe von Azure CLI oder Azure PowerShell verwaltet. Im Folgenden finden Sie Websiteeinstellungen, die je nach Laufzeitsprache, Betriebssystem und Versionen erforderlich sein können.

AcrUseManagedIdentityCreds

Gibt an, ob das Image von einer Azure Container Registry-Instanz mithilfe der verwalteten Identitätsauthentifizierung abgerufen wird. Ein Wert von true erfordert, dass Sie verwaltete Identität verwenden. Wir empfehlen diesen Ansatz über gespeicherte Authentifizierungsanmeldeinformationen als bewährte Methode zur Sicherheit.

AcrUserManagedIdentityID

Gibt die verwaltete Identität an, die beim Abrufen des Images aus einer Azure Container Registry-Instanz verwendet werden soll. Erfordert, dass AcrUseManagedIdentityCreds auf true festgelegt wird. Diese Werte sind gültig:

Value Description
system Die vom System zugewiesene verwaltete Identität der Funktions-App wird verwendet.
<USER_IDENTITY_RESOURCE_ID> Die vollqualifizierte Ressourcen-ID einer benutzerseitig zugewiesenen verwalteten Identität.

Die angegebene Identität muss der ACRPull-Rolle in der Containerregistrierung hinzugefügt werden. Weitere Informationen finden Sie unter Erstellen und Konfigurieren einer Funktions-App in Azure mit dem Image.

alwaysOn

Bei einer Funktions-App, die unter dem App Service-Plan „Dedicated“ ausgeführt wird, geht die Functions-Runtime nach einigen Minuten der Inaktivität in den Leerlauf, wobei nur Anfragen an einen HTTP-Trigger Ihre Funktionen aufwecken. Um sicherzustellen, dass Ihre nicht durch HTTP ausgelösten Funktionen ordnungsgemäß ausgeführt werden (einschließlich Timertrigger), aktivieren Sie Always On für die Funktions-App, indem Sie die Websiteeinstellung alwaysOn auf einen Wert von true festlegen.

functionsRuntimeAdminIsolationEnabled

Bestimmt, ob auf die in Ihrer Funktions-App integrierten Administratorendpunkte (/admin) zugegriffen werden kann. Bei Festlegung auf false (Standardeinstellung) ermöglicht die App Anforderungen an Endpunkte unter /admin, wenn diese Anforderungen einen Masterschlüssel in der Anforderung enthalten. Wenn auf true-, /admin-Endpunkte nicht zugegriffen werden können, selbst mit einem Masterschlüssel.

Diese Eigenschaft kann nicht für Apps festgelegt werden, die unter Linux in einem Verbrauchsplan ausgeführt werden. Sie kann nicht für Apps festgelegt werden, die auf Version 1.x von Azure Functions ausgeführt werden. Wenn Sie Version 1.x verwenden, müssen Sie zuerst zu Version 4.x migrieren.

Der Flex-Verbrauchsplan ist jetzt der empfohlene serverlose Hostingplan für Azure Functions. Es bietet schnellere Skalierung, reduzierte Kaltstarts, private Netzwerke und mehr Kontrolle über Leistung und Kosten. Weitere Informationen finden Sie unter Flex Consumption Plan.

linuxFxVersion

Für Funktions-Apps, die unter Linux ausgeführt werden, gibt linuxFxVersion die Sprache und Version für den sprachspezifischen Workerprozess an. Diese Informationen werden zusammen mit FUNCTIONS_EXTENSION_VERSION verwendet, um zu bestimmen, welches bestimmte Linux-Containerimage installiert ist, um Ihre Funktions-App auszuführen. Diese Einstellung kann auf einen vordefinierten Wert oder einen benutzerdefinierten Bild-URI festgelegt werden.

Dieser Wert wird für Sie festgelegt, wenn Sie Ihre Linux-Funktions-App erstellen. Möglicherweise müssen Sie ihn für ARM-Vorlagen und Bicep-Bereitstellungen und in bestimmten Upgradeszenarien festlegen.

Gültige linuxFxVersion-Werte

Sie können den folgenden Azure CLI-Befehl verwenden, um eine Tabelle der aktuellen linuxFxVersion-Werte nach unterstützter Functions-Runtimeversion anzuzeigen:

az functionapp list-runtimes --os linux --query "[].{stack:join(' ', [runtime, version]), LinuxFxVersion:linux_fx_version, SupportedFunctionsVersions:to_string(supported_functions_versions[])}" --output table

Der vorherige Befehl erfordert ein Upgrade auf Version 2.40 der Azure CLI.

Benutzerdefinierte Images

Wenn Sie Einen eigenen benutzerdefinierten Linux-Container für Ihre Funktions-App erstellen und verwalten, befindet sich der linuxFxVersion Wert stattdessen im Format DOCKER|<IMAGE_URI>, wie im folgenden Beispiel gezeigt:

linuxFxVersion = "DOCKER|contoso.com/azurefunctionsimage:v1.0.0"

In diesem Beispiel wird die Registrierungsquelle des bereitgestellten Containers angegeben. Weitere Informationen finden Sie unter Arbeiten mit Containern und Azure Functions.

Important

Wenn Sie eigene Container erstellen, müssen Sie das Basisimage Ihres Containers auf das neueste unterstützte Basisimage aktualisieren. Unterstützte Basisimages für Azure Functions sind sprachspezifisch. Siehe die Basisimage-Repositorys von Azure Functions.

Das Functions-Team ist bestrebt, monatliche Updates für diese Basisimages zu veröffentlichen. Regelmäßige Updates umfassen die aktuellen Updates der Nebenversion und Sicherheitsfixes für Functions-Runtime und -Sprachen. Sie sollten Ihren Container regelmäßig anhand des neuesten Basisimages aktualisieren und die aktualisierte Version Ihres Containers erneut bereitstellen. Weitere Informationen finden Sie unter Verwalten von benutzerdefinierten Containern.

netFrameworkVersion

Legt die spezifische Version von .NET für C#-Funktionen fest. Weitere Informationen finden Sie unter Aktualisieren Ihrer Funktions-App in Azure.

powerShellVersion

Legt die spezifische Version von PowerShell fest, auf der Ihre Funktionen ausgeführt werden. Weitere Informationen finden Sie unter Ändern der PowerShell-Version.

Bei lokaler Ausführung verwenden Sie stattdessen die FUNCTIONS_WORKER_RUNTIME_VERSION-Einstellung in der Datei „local.settings.json“.

vnetContentShareEnabled

Apps, die in einem Premium-Plan ausgeführt werden, verwenden eine Dateifreigabe zum Speichern von Inhalten. Der Name dieser Inhaltsfreigabe wird in der App-Einstellung WEBSITE_CONTENTSHARE gespeichert, und die Verbindungszeichenfolge wird in WEBSITE_CONTENTAZUREFILECONNECTIONSTRING gespeichert. Um den Datenverkehr zwischen Ihrer Funktions-App und der Inhaltsfreigabe über ein virtuelles Netzwerk weiterzuleiten, müssen Sie vnetContentShareEnabled zudem auf true festlegen. Das Aktivieren dieser Siteeigenschaft ist für die stempelübergreifende Skalierung notwendig, wenn Sie Ihr Speicherkonto auf ein virtuelles Netzwerk in den Hostingplänen „Elastisch Premium“ und „Dedicated“ beschränken. Ohne diese Einstellung kann die Funktions-App nur innerhalb eines einzelnen Stempels skaliert werden (ca. 1 bis 20 Instanzen).

Note

Sie müssen beim Weiterleiten an die Inhaltsfreigabe in einem Speicherkonto, das von mehreren Funktions-Apps unter demselben Plan gemeinsam genutzt wird, besondere Sorgfalt anwenden. Weitere Informationen finden Sie im Artikel zu Speicherüberlegungen unter Konsistentes Routing über virtuelle Netzwerke.

Diese Siteeigenschaft ersetzt die Legacyeinstellung WEBSITE_CONTENTOVERVNET.

vnetImagePullEnabled

Funktionen unterstützen Funktions-Apps, die in Linux-Containern ausgeführt werden. Um eine Verbindung mit einer Containerregistrierung in einem virtuellen Netzwerk herzustellen und Inhalte aus dieser abzurufen, müssen Sie vnetImagePullEnabled auf true festlegen. Diese Siteeigenschaft wird in den Hostingplänen „Elastic Premium“ und „Dedicated“ unterstützt. Der Plan „Flex Consumption“ benötigt keine Siteeigenschaften oder App-Einstellungen zum Konfigurieren des Netzwerks. Weitere Informationen finden Sie unter Veraltete Funktionen beim Flex-Verbrauchstarif.

vnetRouteAllEnabled

Gibt an, ob der gesamte ausgehende Datenverkehr von der App über das virtuelle Netzwerk weitergeleitet wird. Der Einstellungswert true gibt an, dass der gesamte Anwendungsdatenverkehr über das virtuelle Netzwerk weitergeleitet wird. Verwenden Sie diese Einstellung beim Konfigurieren der regionalen VNet-Integration in den Plänen „Elastic Premium“ und „Dedicated“. Sie wird auch verwendet, wenn ein Virtual Network NAT Gateway verwendet wird, um eine statische ausgehende IP-Adresse zu definieren. Weitere Informationen finden Sie unter Konfigurieren des Anwendungsroutings.

Diese Websiteeinstellung ersetzt die Legacyeinstellung WEBSITE_VNET_ROUTE_ALL .

Veraltete Funktionen beim Flex-Verbrauchstarif

Im Flex-Verbrauchstarif sind diese Websiteeigenschaften und Anwendungseinstellungen veraltet und sollten beim Erstellen von Ressourcen für Funktions-Apps nicht verwendet werden:

Setting/property Reason
ENABLE_ORYX_BUILD Ersetzt durch den Parameter remoteBuild bei der Bereitstellung für den Flex-Verbrauch
FUNCTIONS_EXTENSION_VERSION App-Einstellung wird vom Back-End festgelegt. Der Wert ~1 kann ignoriert werden.
FUNCTIONS_WORKER_RUNTIME Ersetzt durch name in properties.functionAppConfig.runtime
FUNCTIONS_WORKER_RUNTIME_VERSION Ersetzt durch version in properties.functionAppConfig.runtime
FUNCTIONS_MAX_HTTP_CONCURRENCY Ersetzt durch Triggerabschnitt für Skalierung und Parallelität
FUNCTIONS_WORKER_PROCESS_COUNT Einstellung ungültig
FUNCTIONS_WORKER_DYNAMIC_CONCURRENCY_ENABLED Einstellung ungültig
SCM_DO_BUILD_DURING_DEPLOYMENT Ersetzt durch den Parameter remoteBuild bei der Bereitstellung für den Flex-Verbrauch
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING Ersetzt durch den Abschnitt für die functionAppConfig-Bereitstellung
WEBSITE_CONTENTOVERVNET Wird für Netzwerke beim Flex-Verbrauch nicht verwendet
WEBSITE_CONTENTSHARE Ersetzt durch den Abschnitt für die functionAppConfig-Bereitstellung
WEBSITE_DNS_SERVER DNS wird vom integrierten virtuellen Netzwerk in Flex geerbt.
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT Ersetzt durch maximumInstanceCount in properties.functionAppConfig.scaleAndConcurrency
WEBSITE_NODE_DEFAULT_VERSION Ersetzt durch version in properties.functionAppConfig.runtime
WEBSITE_RUN_FROM_PACKAGE Wird für Bereitstellungen beim Flex-Verbrauch nicht verwendet
WEBSITE_SKIP_CONTENTSHARE_VALIDATION Die Inhaltsfreigabe wird beim Flex-Verbrauch nicht verwendet
WEBSITE_VNET_ROUTE_ALL Wird für Netzwerke beim Flex-Verbrauch nicht verwendet
properties.alwaysOn Ungültig
properties.containerSize Umbenannt als instanceMemoryMB
properties.ftpsState FTPS nicht unterstützt
properties.isReserved Ungültig
properties.IsXenon Ungültig
properties.javaVersion Ersetzt durch version in properties.functionAppConfig.runtime
properties.LinuxFxVersion Ersetzt durch properties.functionAppConfig.runtime
properties.netFrameworkVersion Ersetzt durch version in properties.functionAppConfig.runtime
properties.powerShellVersion Ersetzt durch version in properties.functionAppConfig.runtime
properties.siteConfig.functionAppScaleLimit Umbenannt als maximumInstanceCount
properties.siteConfig.preWarmedInstanceCount Umbenannt als alwaysReadyInstances
properties.use32BitWorkerProcess 32-Bit nicht unterstützt
properties.vnetBackupRestoreEnabled Wird für Netzwerke beim Flex-Verbrauch nicht verwendet
properties.vnetContentShareEnabled Wird für Netzwerke beim Flex-Verbrauch nicht verwendet
properties.vnetImagePullEnabled Wird für Netzwerke beim Flex-Verbrauch nicht verwendet
properties.vnetRouteAllEnabled Wird für Netzwerke beim Flex-Verbrauch nicht verwendet
properties.windowsFxVersion Ungültig

Verwandte Inhalte

  • Last updated on