Verwalten Ihrer Funktions-App

In Azure Functions stellt eine Funktions-App den Ausführungskontext für Ihre einzelnen Funktionen bereit. Funktionen-App-Verhalten gelten für alle von einer bestimmten Funktionen-App gehosteten Funktionen. Alle Funktionen in einer Funktions-App müssen in der gleichen Sprache geschrieben sein.

Einzelne Funktionen in einer Funktions-App werden gemeinsam bereitgestellt und skaliert. Beim Skalieren der Funktions-App nutzen alle Funktionen in der gleichen Funktions-App die Ressourcen gemeinsam (pro Instanz).

Verbindungszeichenfolgen, Umgebungsvariablen und andere Anwendungseinstellungen werden für jede Funktions-App separat definiert. Daten, die von Funktions-Apps gemeinsam genutzt werden sollen, müssen extern in einem persistenten Speicher gespeichert werden.

Erste Schritte im Azure-Portal

Hinweis

Aufgrund von Einschränkungen beim Bearbeiten von Funktionscode im Azure-Portal sollten Sie Ihre Funktionen lokal entwickeln und Ihr Codeprojekt in einer Funktions-App in Azure veröffentlichen. Weitere Informationen finden Sie unter Entwicklungseinschränkungen im Azure-Portal

Führen Sie die folgenden Schritte aus, um die App-Einstellungen in Ihrer Funktions-App anzuzeigen:

Melden Sie sich mit Ihrem Azure-Konto beim portal Azure an. Suchen Sie nach Ihrer Funktions-App, und wählen Sie sie aus.
Erweitern Sie im linken Bereich Ihrer Funktions-App die Option Einstellungen, wählen Sie Umgebungsvariablen aus, und wählen Sie dann die Registerkarte App-Einstellungen aus.

Arbeiten mit Anwendungseinstellungen

Zusätzlich zu den vordefinierten App-Einstellungen, die von Azure Functions verwendet werden, können Sie eine beliebige Anzahl von App-Einstellungen erstellen, wie sie vom Funktionscode benötigt werden. Weitere Informationen finden Sie unter App-Einstellungsreferenz für Azure Functions.

Diese Einstellungen werden verschlüsselt gespeichert. Weitere Informationen finden Sie unter Anwendungseinstellungen.

Sie können App-Einstellungen über das portal Azure und mithilfe der Azure CLI und Azure PowerShell verwalten. Sie können App-Einstellungen auch über Visual Studio Code und von Visual Studio verwalten.

Hinweis

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.

Informationen zum Anzeigen Ihrer App-Einstellungen finden Sie unter Get started in the Azure portal.

Auf der Registerkarte App-Einstellungen werden Einstellungen verwaltet, die von Ihrer Funktions-App verwendet werden:

Wählen Sie Werte anzeigen aus, um die Werte der App-Einstellungen anzuzeigen.
Wenn Sie eine Einstellung hinzufügen möchten, wählen Sie + Hinzufügen aus, und geben Sie dann unter Name den Namen und unter Wert den Wert des neuen Schlüssel-Wert-Paars ein.

Der Befehl az functionapp config appsettings list gibt die vorhandenen Anwendungseinstellungen zurück. Beispiel:

az functionapp config appsettings list --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME>

Der Befehl az functionapp config appsettings set dient zum Hinzufügen oder Aktualisieren einer Anwendungseinstellung. Im folgenden Beispiel wird eine Einstellung mit einem Schlüssel namens CUSTOM_FUNCTION_APP_SETTING und dem Wert 12345 erstellt:

az functionapp config appsettings set --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--settings CUSTOM_FUNCTION_APP_SETTING=12345

Das Cmdlet Get-AzFunctionAppSetting gibt die vorhandenen Anwendungseinstellungen zurück. Beispiel:

Get-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME>

Der Befehl Update-AzFunctionAppSetting dient zum Hinzufügen oder Aktualisieren einer Anwendungseinstellung. Im folgenden Beispiel wird eine Einstellung mit einem Schlüssel namens CUSTOM_FUNCTION_APP_SETTING und dem Wert 12345 erstellt:

Update-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME> -AppSetting @{"CUSTOM_FUNCTION_APP_SETTING" = "12345"}

Verwenden von Anwendungseinstellungen

Die Werte für Funktions-App-Einstellungen können auch im Code als Umgebungsvariablen gelesen werden. Weitere Informationen finden Sie im Abschnitt „Umgebungsvariablen“ dieser sprachspezifischen Referenzartikel:

Wenn Sie eine Funktions-App lokal entwickeln, müssen Sie lokale Kopien dieser Werte in der Projektdatei local.settings.json speichern. Weitere Informationen finden Sie unter Datei für lokale Einstellungen.

Einstellungen für die FTPS-Bereitstellung

Azure Functions unterstützt die Bereitstellung von Projektcode in Ihrer Funktions-App mithilfe von FTPS. Da diese Bereitstellungsmethode die Synchronisierung von Triggern erfordert, wird sie nicht empfohlen. Verwenden Sie zum sicheren Übertragen von Projektdateien immer FTPS und nicht FTP.

Die für die FTPS-Bereitstellung erforderlichen Anmeldeinformationen können mithilfe einer der folgenden Methoden abgerufen werden:

Sie können die FTPS-Veröffentlichungsanmeldeinformationen im Azure Portal abrufen, indem Sie das Veröffentlichungsprofil für Ihre Funktions-App herunterladen.

Wichtig

Das Veröffentlichungsprofil enthält wichtige Sicherheitsanmeldeinformationen. Stellen Sie immer sicher, dass die heruntergeladene Datei auf Ihrem lokalen Computer geschützt ist.

So laden Sie das Veröffentlichungs Profil Ihrer Funktions-App herunter:

Suchen Sie im Azure-Portal die Seite für Ihre Funktions-App, erweitern Sie Settings>Configuration in der linken Spalte.
Wählen Sie auf der Seite Konfiguration die Registerkarte Allgemeine Einstellungen aus, und stellen Sie sicher, dass die Option Veröffentlichungsanmeldeinformationen für die SCM-Standardauthentifizierung auf Ein eingestellt ist. Wenn diese Einstellung auf Aus festgelegt ist, können Sie keine Veröffentlichungsprofile verwenden. Wählen Sie daher Ein und anschließend Anwenden.
Kehren Sie zur Seite Übersicht der Funktions-App zurück, und wählen Sie dann Veröffentlichungsprofil abrufen aus.
Speichern und kopieren Sie den Inhalt der Datei.

Suchen Sie in der Datei das Element publishProfile mit dem Attribut publishMethod="FTP". In diesem Element enthalten die Attribute publishUrl, userName und userPWD die Ziel-URL und die Anmeldeinformationen für die Veröffentlichung über FTPS.

Führen Sie diesen Azure CLI Befehl aus, der die FTPS-Anmeldeinformationen aus dem Veröffentlichungsprofil zurückgibt.

az functionapp deployment list-publishing-profiles --name <APP_NAME> --resource-group <GROUP_NAME> --query "[?publishMethod=='FTP'].{URL:publishUrl, username:userName, password:userPWD}" -o table

Ersetzen Sie <APP_NAME> in diesem Beispiel durch den Namen Ihrer Funktions-App und <GROUP_NAME> durch die Ressourcengruppe. Die zurückgegebenen Spalten URL, username und password enthalten die Ziel-URL und die Anmeldeinformationen für die FTPS-Veröffentlichung.

Führen Sie diesen Azure PowerShell Befehl aus, der die FTPS-Anmeldeinformationen aus dem Veröffentlichungsprofil zurückgibt.

$profile = [xml](Get-AzWebAppPublishingProfile -ResourceGroupName "<GROUP_NAME>" -Name "<APP_NAME>" -Format "Ftp") 
$profile.publishData.publishProfile | Where-Object -Property publishMethod -eq Ftp | Select-Object -Property @{Name="URL"; Expression = {$_.publishUrl}}, 
@{Name="username"; Expression = {$_.userName}}, @{Name="password"; Expression = {$_.userPWD}} | Format-Table

Typ des Hostingplans

Wenn Sie eine Funktions-App erstellen, erstellen Sie auch einen Hostingplan, in dem die App ausgeführt wird. Ein Plan kann mehrere Funktions-App umfassen. Funktionalität, Skalierung und Preis Ihrer Funktionen hängen vom Typ des Plans ab. Weitere Informationen finden Sie unter Azure Functions Hostingoptionen.

Sie können den Typ des Plans bestimmen, der von Ihrer Funktions-App im Azure Portal verwendet wird, oder mithilfe der Azure CLI- oder Azure PowerShell-APIs.

Die folgenden Werte geben den Plantyp an:

Plantyp	Azure Portal	Azure CLI/PowerShell
Verbrauch	Verbrauch	`Dynamic`
Premium	ElasticPremium	`ElasticPremium`
Dediziert (App Service)	Verschiedene	Verschiedene

Informationen zum Bestimmen des Typs des Plans, der von Ihrer Funktions-App verwendet wird, finden Sie auf der Seite App Service Plan im Overview Seite der Funktions-App im Azure Portal.
Um den Tarif anzuzeigen, wählen Sie unter App Service-Plan den Namen des App Service-Plans und anschließend im linken Bereich Einstellungen > Eigenschaften aus.

Führen Sie den folgenden Azure CLI Befehl aus, um Ihren Hostingplantyp abzurufen:

functionApp=<FUNCTION_APP_NAME>
resourceGroup=FunctionMonitoringExamples
appServicePlanId=$(az functionapp show --name $functionApp --resource-group $resourceGroup --query appServicePlanId --output tsv)
az appservice plan list --query "[?id=='$appServicePlanId'].sku.tier" --output tsv

Ersetzen Sie im vorherigen Beispiel <RESOURCE_GROUP> und <FUNCTION_APP_NAME> durch die Namen der Ressourcengruppe bzw. durch den Namen der Funktions-App.

Führen Sie den folgenden Azure PowerShell Befehl aus, um Ihren Hostingplantyp abzurufen:

$FunctionApp = '<FUNCTION_APP_NAME>'
$ResourceGroup = '<RESOURCE_GROUP>'

$PlanID = (Get-AzFunctionApp -ResourceGroupName $ResourceGroup -Name $FunctionApp).AppServicePlan
(Get-AzFunctionAppPlan -Name $PlanID -ResourceGroupName $ResourceGroup).SkuTier

Ersetzen Sie im vorherigen Beispiel <RESOURCE_GROUP> und <FUNCTION_APP_NAME> durch die Namen der Ressourcengruppe bzw. durch den Namen der Funktions-App.

Planen der Migration

Sie können eine Funktions-App zwischen einem Verbrauchsplan und einem Premium-Plan auf Windows migrieren.

Tipp

Es wird empfohlen, Ihre Verbrauchsplan-App in einem Flex-Verbrauchsplan anstelle eines Premium-Plans auszuführen. Bei einer Linux-Verbrauchsplan-App ist der Wechsel zum Flex-Verbrauchsplan die einzige Option. Da die In-Place Migration von Plänen zu und von Flex-Verbrauch nicht unterstützt wird, müssen Sie eine neue App im Flex-Verbrauchsplan erstellen. Weitere Informationen finden Sie unter Migrieren von Verbrauchsplan-Apps zum Flex Consumption-Plan, der Sie durch das Erstellen einer neuen Flex Consumption-App mit den gleichen Einstellungen wie Ihre vorhandene App führt.

Beachten Sie bei der Migration zwischen Plänen die folgenden Überlegungen:

Die direkte Migration zu einem dedizierten Plan (App Service) wird nicht unterstützt.
Die Migration wird unter Linux nicht unterstützt.
Der Quellplan und der Zielplan müssen sich in derselben Ressourcengruppe und geografischen Region befinden. Weitere Informationen finden Sie unter Move an app to another App Service plan (Verschieben einer App in einen anderen App Service-Plan).
Die spezifischen CLI-Befehle hängen von der Richtung der Migration ab.
Downtime bei Ihren Funktionsausführungen tritt auf, wenn die Funktions-App zwischen Plänen migriert wird.
Status- und andere App-spezifische Inhalte werden beibehalten, da dieselbe Azure Files-Freigabe sowohl vor als auch nach der Migration von der App verwendet wird.
Die In-Place Migration von Plänen in den oder aus dem Flex-Verbrauchsplan wird nicht unterstützt. Sie müssen eine neue Funktions-App im Flex Consumption-Plan erstellen.

Sie können Ihren Plan mithilfe dieser Tools migrieren:

Sie können das portal Azure verwenden, um zu einem anderen Plan zu wechseln.

Wählen Sie die Richtung der Migration für Ihre App auf Windows aus.

Navigieren Sie im Azure-Portal zu Ihrer Verbrauchsplan-App, und erweitern Sie im linken Bereich App Service-Plan und wählen Sie App Service plan aus.
Wählen Sie auf der Seite "App Service-Plan" unter "Aktueller App Service-Plan" die Option "Plan ändern" aus.
Wählen Sie im Plan "App Service ändern" den Typ "Premium für Plan" aus, erstellen Sie einen neuen Premium-Plan, und wählen Sie "OK" aus.

Weitere Informationen finden Sie unter Move an app to another App Service plan (Verschieben einer App in einen anderen App Service-Plan).

Verwenden Sie das folgende Verfahren, um von einem Verbrauchsplan zu einem Premium-Plan auf Windows zu migrieren:

Führen Sie den folgenden az functionapp create-Befehl aus, um einen neuen App Service-Plan (Elastic Premium) in derselben Region und Ressourcengruppe wie Ihre vorhandene Funktions-App zu erstellen:
```
az functionapp plan create --name <NEW_PREMIUM_PLAN_NAME> --resource-group <MY_RESOURCE_GROUP> --location <REGION> --sku EP1
```
Führen Sie den folgenden az functionapp update-Befehl aus, um die vorhandene Funktions-App zum neuen Premium-Plan zu migrieren:
```
az functionapp update --name <MY_APP_NAME> --resource-group <MY_RESOURCE_GROUP> --plan <NEW_PREMIUM_PLAN>
```
Wenn Sie den ursprünglich von der App verwendeten Verbrauchsplan nicht mehr benötigen, löschen Sie Ihren ursprünglichen Plan, nachdem Sie sich vergewissert haben, dass Sie erfolgreich zu dem neuen Plan migriert sind. Führen Sie den folgenden az functionapp plan list-Befehl aus, um eine Liste aller Verbrauchspläne in Ihrer Ressourcengruppe abzurufen:
```
az functionapp plan list --resource-group <MY_RESOURCE_GROUP> --query "[?sku.family=='Y'].{PlanName:name,Sites:numberOfSites}" -o table
```
Sie können den Plan mit 0 (null) Sites sicher löschen, denn dies ist der Plan, von dem aus Sie migriert haben.
Führen Sie den folgenden az functionapp plan delete-Befehl aus, um den Verbrauchsplan zu löschen, von dem aus Sie migriert sind.
```
az functionapp plan delete --name <CONSUMPTION_PLAN_NAME> --resource-group <MY_RESOURCE_GROUP>
```

Verwenden Sie das folgende Verfahren, um von einem Premium-Plan zu einem Verbrauchsplan auf Windows zu migrieren:

Führen Sie den folgenden az functionapp create-Befehl aus, um eine neue Funktions-App (Verbrauch) in derselben Region und Ressourcengruppe wie Ihre vorhandene Funktions-App zu erstellen. Mit diesem Befehl wird auch ein neuer Verbrauchsplan erstellt, in dem die Funktions-App ausgeführt wird:
```
az functionapp create --resource-group <MY_RESOURCE_GROUP> --name <NEW_CONSUMPTION_APP_NAME> --consumption-plan-location <REGION> --runtime <LANGUAGE_RUNTIME> --functions-version 4 --storage-account <STORAGE_NAME>
```
Führen Sie den Befehl az functionapp show wie folgt aus, um den Namen des Verbrauchsplans abzurufen, der mit der neuen Funktions-App erstellt wurde:
```
az functionapp show --resource-group <MY_RESOURCE_GROUP> --name <NEW_CONSUMPTION_APP_NAME> --query "{appServicePlanId}" -o tsv
```
Der Name des Verbrauchsplans ist das letzte Segment der vollständig qualifizierten Ressourcen-ID, die zurückgegeben wird.
Führen Sie den folgenden az functionapp update-Befehl aus, um die vorhandene Funktions-App zum neuen Verbrauchsplan zu migrieren:
```
az functionapp update --name <MY_APP_NAME> --resource-group <MY_RESOURCE_GROUP> --plan <NEW_CONSUMPTION_PLAN> --force
```
Führen Sie den folgenden az functionapp delete-Befehl aus, um die Funktions-App, die Sie im Schritt 1 erstellt haben, zu löschen, da Sie nur den Plan benötigen, der erstellt wurde, um die vorhandene Funktions-App auszuführen:
```
az functionapp delete --name <NEW_CONSUMPTION_APP_NAME> --resource-group <MY_RESOURCE_GROUP>
```
Wenn Sie den ursprünglich von der App verwendeten Premium-Plan nicht mehr benötigen, löschen Sie Ihren ursprünglichen Plan, nachdem Sie sich vergewissert haben, dass Sie erfolgreich zu dem neuen Plan migriert sind. Bis der Premium-Plan gelöscht wird, wird er Ihnen weiterhin in Rechnung gestellt. Führen Sie den folgenden az functionapp plan list-Befehl aus, um eine Liste aller Premiumpläne in Ihrer Ressourcengruppe abzurufen:
```
az functionapp plan list --resource-group <MY_RESOURCE_GROUP> --query "[?sku.family=='EP'].{PlanName:name,Sites:numberOfSites}" -o table
```
Führen Sie den folgenden az functionapp plan delete-Befehl aus, um den Premiumplan zu löschen, von dem aus Sie migriert sind:
```
az functionapp plan delete --name <PREMIUM_PLAN> --resource-group <MY_RESOURCE_GROUP>
```

Verwenden Sie das folgende Verfahren, um von einem Verbrauchsplan zu einem Premium-Plan auf Windows zu migrieren:

Führen Sie den folgenden New-AzFunctionAppPlan-Befehl aus, um einen neuen App Serviceplan (Elastic Premium) in derselben Region und Ressourcengruppe wie Ihre vorhandene Funktions-App zu erstellen:
```
New-AzFunctionAppPlan -Name <NEW_PREMIUM_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Location <REGION> -Sku EP1 -WorkerType Windows
```
Führen Sie den folgenden Update-AzFunctionApp-Befehl aus, um die vorhandene Funktions-App zum neuen Premium-Plan zu migrieren:
```
Update-AzFunctionApp -Name <MY_APP_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -PlanName <NEW_PREMIUM_PLAN> -Force
```
Wenn Sie den ursprünglich von der App verwendeten Verbrauchsplan nicht mehr benötigen, können Sie den Remove-AzFunctionAppPlan-Befehl wie folgt ausführen, um den von Ihnen migrierten Verbrauchsplan zu löschen:
```
Remove-AzFunctionAppPlan -Name <CONSUMPTION_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Force
```

Verwenden Sie das folgende Verfahren, um von einem Premium-Plan zu einem Verbrauchsplan auf Windows zu migrieren:

Führen Sie den folgenden New-AzFunctionApp-Befehl aus, um eine neue Funktions-App (Verbrauch) in derselben Region und Ressourcengruppe wie Ihre vorhandene Funktions-App zu erstellen. Mit diesem Befehl wird auch ein neuer Verbrauchsplan erstellt, in dem die Funktions-App ausgeführt wird:
```
New-AzFunctionApp -Name <NEW_CONSUMPTION_APP_NAME> -StorageAccountName <STORAGE_NAME> -Location <REGION> -ResourceGroupName <MY_RESOURCE_GROUP> -Runtime <LANGUAGE_RUNTIME> -RuntimeVersion <LANGUAGE_VERSION> -FunctionsVersion 4 -OSType Windows
```

Führen Sie den Befehl Get-AzFunctionApp wie folgt aus, um den Namen des Verbrauchsplans abzurufen, der mit der neuen Funktions-App erstellt wurde:

Get-AzFunctionApp -ResourceGroupName <MY_RESOURCE_GROUP> -Name <NEW_CONSUMPTION_APP_NAME> | Select-Object -Property AppServicePlan | Format-List

Führen Sie den folgenden Update-AzFunctionApp-Befehl aus, um die vorhandene Funktions-App zum neuen Verbrauchsplan zu migrieren:
```
Update-AzFunctionApp -Name <MY_APP_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -PlanName <NEW_CONSUMPTION_PLAN> -Force
```
Wenn Sie den ursprünglich von der App verwendeten Verbrauchsplan nicht mehr benötigen, können Sie den Remove-AzFunctionAppPlan-Befehl wie folgt ausführen, um den von Ihnen migrierten Verbrauchsplan zu löschen:
```
Remove-AzFunctionAppPlan -Name <CONSUMPTION_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Force
```

Entwicklungsbeschränkungen im Azure-Portal

Die folgende Tabelle gibt Aufschluss über die Betriebssysteme und Programmiersprachen, die Bearbeitung im Portal unterstützen:

Sprache	Prämie	Dediziert	Verbrauch
C#
Java
JavaScript (Node.js)	✔	✔	nur Windows
Python	Nur Linux	Nur Linux	Nur Linux
PowerShell	nur Windows	nur Windows	nur Windows
TypeScript (Node.js)

Berücksichtigen Sie diese Einschränkungen, wenn Sie Ihre Funktionen im Azure-Portal entwickeln:

Die In-Portal-Bearbeitung wird nur für Funktionen unterstützt, die im Azure-Portal erstellt oder zuletzt geändert wurden.
Die In-Portal-Bearbeitung wird nur für JavaScript, PowerShell, Python und C#-Skript (In-Process)-Funktionen unterstützt.
Die Bearbeitung im Portal wird derzeit im Flex-Verbrauchstarif nicht unterstützt.
Die Möglichkeit, Ihre Apps unter Linux in einem Verbrauchsplan auszuführen, ist für den Ruhestand geplant. Weitere Informationen finden Sie unter Azure Functions-Verbrauchsplan-Hosting.
Wenn Sie Code in einer Funktions-App außerhalb des Azure Portals bereitstellen, können Sie keinen Code für diese Funktions-App im Portal mehr bearbeiten. In diesem Fall verwenden Sie einfach weiterhin lokale Entwicklung.
Für Python wird die Entwicklung mit benutzerdefinierten Modulen derzeit nicht im Portal unterstützt. Um Ihrer Funktions-App benutzerdefinierte Module hinzuzufügen, müssen Sie Ihre App lokal entwickeln.
Für kompilierte C#-Funktionen und Java Funktionen können Sie die Funktions-App und zugehörige Ressourcen im Portal erstellen. Sie müssen jedoch das Codeprojekt der Funktionen lokal erstellen und dann in Azure veröffentlichen.

Entwickeln Sie Ihre Funktionen nach Möglichkeit lokal, und veröffentlichen Sie Ihr Codeprojekt in einer Funktions-App in Azure. Weitere Informationen finden Sie unter Code und testen Sie Azure Functions lokal.

Manuelles Installieren von Erweiterungen

C#-Klassenbibliotheksfunktionen können die NuGet-Pakete für Bindungserweiterungen direkt im Klassenbibliotheksprojekt enthalten. Bei anderen Nicht-.NET Sprachen und C#-Skripts sollten Sie Erweiterungspakete use extension bundles verwenden. Wenn Sie Erweiterungen manuell installieren müssen, können Sie dies tun, indem Sie using Azure Functions Core Tools lokal verwenden. Wenn Sie Erweiterungsbündel nicht verwenden und nur in der Lage sind, im Portal zu arbeiten, müssen Sie Advanced Tools (Kudu) verwenden, um die extensions.csproj-Datei direkt auf der Website manuell zu erstellen. Stellen Sie sicher, dass Sie zuerst das Element extensionBundle aus der Datei host.json entfernen.

Der gleiche Prozess funktioniert für jede andere Datei, die Sie Ihrer App hinzufügen müssen.

Wichtig

Bearbeiten Sie Dateien nach Möglichkeit nicht direkt in Ihrer Funktions-App in Azure. Wir empfehlen, Ihre App-Dateien lokal herunterzuladen, indem Sie Core Tools verwenden, um Erweiterungen und andere Pakete zu installieren, Ihre Änderungen zu überprüfen und dann Ihre App mithilfe von Core Tools oder einer der anderen unterstützten Bereitstellungsmethoden erneut zu veröffentlichen.

Mit dem im Azure Portal integrierten Funktions-Editor können Sie Ihren Funktionscode und Ihre Konfigurationsdateien direkt im Portal aktualisieren:

Wählen Sie Ihre Funktions-App und dann unter Funktionen die Option Funktionen aus.
Wählen Sie Ihre Funktion aus, und wählen Sie Code+ Test unter Entwickler aus.
Wählen Sie Ihre zu bearbeitende Datei aus, und wählen Sie Speichern aus, wenn Sie fertig sind.

Dateien am Stamm der App (z. B. „function.proj“ oder „extensions.csproj“) müssen mithilfe von Erweiterte Tools (Kudu) erstellt und bearbeitet werden:

Wählen Sie Ihre Funktions-App aus, erweitern Sie Entwicklungstools, und wählen Sie anschließend Erweiterte Tools>Go aus.
Wenn Sie dazu aufgefordert werden, melden Sie sich mit Ihren Azure Anmeldeinformationen bei der Website des Quellcodeverwaltungs-Managers (Source Control Manager, SCM) an.
Wählen Sie im Menü Debugging-Konsole die Option CMD aus.
Navigieren Sie zu .\site\wwwroot, wählen Sie oben die Plusschaltfläche (+) aus, und wählen Sie Neue Datei aus.
Geben Sie der Datei einen Namen (z. B. extensions.csproj), und drücken Sie die EINGABETASTE.
Wählen Sie die Bearbeitungsschaltfläche neben der neuen Datei aus, fügen Sie der Datei Code hinzu, oder aktualisieren Sie ihn, und wählen Sie anschließend Speichern aus.
Führen Sie für eine Projektdatei wie extensions.csproj den folgenden Befehl aus, um das Erweiterungsprojekt neu zu erstellen:
```
dotnet build extensions.csproj
```

Plattformfeatures

Funktions-Apps werden auf der Azure App Service-Plattform ausgeführt, die sie verwaltet. Daher haben Ihre Funktions-Apps Zugriff auf die meisten Features der zentralen Webhostingplattform von Azure. Wenn Sie das portal Azure verwenden, greifen Sie im linken Bereich auf die vielen Features der App Service-Plattform zu, die Sie in Ihren Funktions-Apps verwenden können.

Die folgende Matrix zeigt die Unterstützung von Azure-Portal-Funktionen je nach Hostingplan und Betriebssystem an.

Funktion	Verbrauchsplan	Flex-Verbrauchsplan	Premium-Tarif	Dedizierter Plan
Erweiterte Tools (Kudu)	Windows: ✔ Linux: X	X	✔	✔
App Service-Editor	Windows: ✔ Linux: X	X	Windows: ✔ Linux: X	Windows: ✔ Linux: X
Backups	X	X	X	✔
Konsole	Windows: Befehlszeile Linux: X	X	Windows: Befehlszeile Linux: SSH	Windows: Befehlszeile Linux: SSH

Im weiteren Verlauf dieses Artikels werden schwerpunktmäßig folgende Features im Portal behandelt, die für Ihre Funktions-Apps nützlich sind:

App Service-Editor
Konsole
Erweiterte Tools (Kudu)
Bereitstellungsoptionen
CORS
Authentifizierung

Weitere Informationen zum Arbeiten mit App Service-Einstellungen finden Sie unter Configure Azure App Service Settings.

App Service-Editor

Der App Service-Editor ist ein leistungsstarker Editor im Portal, mit dem Sie JSON-Konfigurationsdateien und Codedateien gleichermaßen bearbeiten können. Bei Auswahl dieser Option wird eine separate Browserregisterkarte mit einem einfachen Editor gestartet. Dieser Editor ermöglicht die Integration in das Git-Repository. Außerdem können Sie damit Code ausführen und debuggen sowie Einstellungen von Funktionen-Apps ändern. Im Vergleich zum integrierten Funktionen-Editor bietet dieser Editor eine erweiterte Entwicklungsumgebung für Ihre Funktionen.

Screenshot: App Service-Editor

Es empfiehlt sich, Funktionen auf dem lokalen Computer zu entwickeln. Wenn Sie lokal entwickeln und in Azure veröffentlichen, sind Ihre Projektdateien im Azure-Portal schreibgeschützt. Weitere Informationen finden Sie unter Code und testen Sie Azure Functions lokal.

Console

Die Konsole im Portal ist das ideale Entwicklungstool, wenn Sie Funktionen-Apps über die Befehlszeile konfigurieren möchten. Häufig verwendete Befehle sind z.B. Erstellen von Verzeichnissen und Dateien, Navigation sowie das Ausführen von Batchdateien und -skripts.

Screenshot: Konsole für Funktions-Apps

Bei der lokalen Entwicklung empfehlen wir die Verwendung der Azure Functions Core Tools und der Azure CLI.

Erweiterte Tools (Kudu)

Die erweiterten Tools für App Service (auch bekannt als Kudu) ermöglichen den Zugriff auf erweiterte Verwaltungsfunktionen der Funktionen-App. Über Kudu können Sie Systeminformationen, App-Einstellungen, Umgebungsvariablen, Websiteerweiterungen, HTTP-Header und Servervariablen verwalten. Sie können Kudu auch starten, indem Sie zum SCM-Endpunkt für die Funktions-App navigieren (Beispiel: https://<myfunctionapp>.scm.azurewebsites.net/).

Screenshot: Erweiterte Tools für App Service (Kudo)

Bereitstellungscenter

Wenn Sie Ihren Funktionencode mithilfe einer Quellcodeverwaltungslösung entwickeln und verwalten, können Sie im Bereitstellungscenter beim Erstellen und Bereitstellen auf die Quellcodeverwaltung zurückgreifen. Ihr Projekt wird erstellt und für Azure bereitgestellt, wenn Sie Aktualisierungen vornehmen. Weitere Informationen finden Sie unter Deployment-Technologien in Azure Functions.

Cross-Origin Resource Sharing

Um die Ausführung von schädlichem Code auf dem Client zu verhindern, blockieren moderne Browser Anforderungen, die von Webanwendungen an Ressourcen in einer separaten Domäne gerichtet werden. Mit Cross-Origin Resource Sharing (CORS) kann ein Header vom Typ Access-Control-Allow-Origin die Ursprünge deklarieren, von denen Endpunkte in Ihrer Funktions-App aufgerufen werden dürfen.

Wenn Sie die Liste Zulässige Ursprünge für Ihre Funktions-App konfigurieren, wird der Header Access-Control-Allow-Origin automatisch allen Antworten von HTTP-Endpunkten in Ihrer Funktions-App hinzugefügt.

Screenshot: Konfigurieren der CORS-Liste Ihrer Funktions-App

Wenn ein weiterer Domäneneintrag vorhanden ist, wird das Platzhalterzeichen (*) ignoriert.

Verwenden Sie den az functionapp cors add-Befehl, um der Liste mit den zulässigen Ursprüngen eine Domäne hinzuzufügen. Im folgenden Beispiel wird die Domäne „contoso.com“ hinzugefügt:

az functionapp cors add --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--allowed-origins https://contoso.com

Verwenden Sie den az functionapp cors show-Befehl, um die derzeit zulässigen Ursprünge aufzulisten.

Authentifizierung

Wenn Funktionen einen HTTP-Trigger verwenden, können Sie festlegen, dass Aufrufe zunächst authentifiziert werden müssen. Der App-Dienst unterstützt Microsoft Entra Authentifizierung und Anmeldung mit sozialen Anbietern wie Facebook, Microsoft und X. Informationen zum Konfigurieren bestimmter Authentifizierungsanbieter finden Sie unter Azure App Service Authentifizierungsübersicht.

Screenshot: Konfigurieren der Authentifizierung für eine Funktions-App

Feedback

War diese Seite hilfreich?

Last updated on 2026-03-23