Verwalten Ihrer Funktions-App

Informationen zum Anzeigen Ihrer App-Einstellungen finden Sie unter Erste Schritte im Azure-Portal.

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

1. Wählen Sie Werte anzeigen aus, um die Werte der App-Einstellungen anzuzeigen.

2. 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"}

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

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

1. Suchen Sie im Azure-Portal die Seite für Ihre Funktions-App, und erweitern Sie Einstellungen>Konfiguration in der linken Spalte.

2. 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 eingestellt ist, können Sie keine Veröffentlichungsprofile verwenden. Wählen Sie daher Ein und dann Speichern aus.

3. Kehren Sie zur Seite Übersicht der Funktions-App zurück, und wählen Sie dann Veröffentlichungsprofil abrufen aus.

   

4. Speichern und kopieren Sie den Inhalt der Datei.

3. 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

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.

1. Wenn Sie den von Ihrer Funktions-App verwendeten Plantyp ermitteln möchten, navigieren Sie im Azure-Portal auf der Seite Übersicht der Funktions-App zu App Service-Plan.

   

2. 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 zum Abrufen des Hostingplantyps den folgenden Azure CLI-Befehl aus:

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 zum Abrufen des Hostingplantyps den folgenden Azure PowerShell-Befehl aus:

$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.

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

Sie können die Azure CLI-Befehle verwenden, um manuell einen neuen Plan zu erstellen, Ihre App auf die Verwendung des neuen Plans umzustellen und den ursprünglichen Plan zu löschen.

Sie können Azure PowerShell-Befehle verwenden, um manuell einen neuen Plan zu erstellen, Ihre App auf die Verwendung des neuen Plans umzustellen und den ursprünglichen Plan zu löschen.

1. Navigieren Sie im Azure-Portal zu Ihrer Verbrauchs- oder Premium-Plan-App und wählen Sie unter App Service Plan ändern die Option App Service-Plan aus.

2. Wählen Sie Premium unter Plantyp 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).

1. Navigieren Sie im Azure-Portal zu Ihrer Premium-Plan-App und wählen Sie unter App Service Plan ändern die Option App Service-Plan aus.

2. Wählen Sie Verbrauch unter Plantyp aus, erstellen Sie einen neuen Verbrauchsplan 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).

Gehen Sie wie folgt vor, um unter Windows von einem Verbrauchsplan zu einem Premium-Plan zu migrieren:

1. 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
   

2. 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>
   

3. 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.

4. 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>
   

Gehen Sie wie folgt vor, um unter Windows von einem Premium-Plan zu einem Verbrauchsplan zu migrieren:

1. 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>
   

2. 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.

3. 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
   

4. 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>
   

5. 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
   

6. 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>
   

Gehen Sie wie folgt vor, um unter Windows von einem Verbrauchsplan zu einem Premium-Plan zu migrieren:

1. 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
   

2. 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
   

3. 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
   

Gehen Sie wie folgt vor, um unter Windows von einem Premium-Plan zu einem Verbrauchsplan zu migrieren:

1. 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
   

2. 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
   

3. 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
   

4. 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
   

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.

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

Verwenden Sie den Befehl az functionapp cors add,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 Befehl az functionapp cors show, um die derzeit zulässigen Ursprünge aufzulisten.

CORS-Einstellungen können derzeit nicht mit Azure PowerShell aktualisiert werden.