Konfigurera en App Service-app

1. I Azure-portalen söker du efter och väljer App Services och väljer sedan din app.

   

2. I appens vänstra meny väljer du Inställningar för konfigurationsprogram>.

   

   Som standard döljs värden för appinställningar i portalen av säkerhetsskäl. Om du vill se ett dolt värde för en appinställning väljer du dess värdefält . Om du vill se dolda värden för alla appinställningar väljer du knappen Visa värden .

3. Om du vill lägga till en ny appinställning väljer du Ny programinställning. Om du vill redigera en inställning väljer du knappen Redigera till höger.

4. I dialogrutan kan du hålla inställningen till det aktuella facket.

   Kommentar

   I en linux-standardapptjänst eller en anpassad Linux-container måste valfri kapslad JSON-nyckelstruktur i appinställningsnamnet ApplicationInsights:InstrumentationKey konfigureras i App Service som ApplicationInsights__InstrumentationKey för nyckelnamnet. Med andra ord bör alla : ersättas med __ (dubbelt understreck). Alla perioder i appinställningens namn ersätts med ett _ (enda understreck).

5. När du är klar väljer du Uppdatera. Glöm inte att välja Spara tillbaka på sidan Konfiguration.

Lägg till eller redigera en appinställning med az webapp config app settings set:

az webapp config appsettings set --name <app-name> --resource-group <group-name> --settings <setting-name>="<value>"

Ersätt <setting-name> med namnet på inställningen och <value> med värdet som ska tilldelas till den.

Visa alla inställningar och deras värden med az webapp config appsettings list:

az webapp config appsettings list --name <app-name> --resource-group <group-name>

Ta bort en eller flera inställningar med az webapp config app settings delete:

az webapp config appsettings delete --name <app-name> --resource-group <group-name> --setting-names {<setting-name1>,<setting-name2>,...}

Ange en eller flera appinställningar med Set-AzWebApp:

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -AppSettings @{"<setting-name1>"="<value1>"; "<setting-name2>"="<value2>";...}

Den här cmdleten ersätter hela uppsättningen med appinställningar med de som du anger. Om du vill lägga till eller redigera en appinställning i en befintlig uppsättning inkluderar du de befintliga appinställningarna i hashtable-indata med hjälp av cmdleten Get-AzWebApp . Till exempel:

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy app settings to a new Hashtable
$appSettings = @{}
ForEach ($item in $webapp.SiteConfig.AppSettings) {
$appSettings[$item.Name] = $item.Value
}

# Add or edit one or more app settings
$appSettings['<setting-name1>'] = '<value1>'
$appSettings['<setting-name2>'] = '<value2>'

# Save changes
Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -AppSettings $appSettings

Om du vill kontrollera om en appinställning är platsspecifik använder du Get-AzWebAppSlotConfigName:

Get-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> | select AppSettingNames

Om du vill göra en eller flera appinställningar fackspecifika använder du Set-AzWebAppSlotConfigName:

Set-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> -AppSettingNames <setting-name1>,<setting-name2>,...

Välj knappen Avancerad redigering. Redigera inställningarna i textområdet. När du är klar väljer du Uppdatera. Glöm inte att välja Spara tillbaka på sidan Konfiguration.

Appinställningarna har följande JSON-formatering:

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

Kör az webapp config app settings set with the name of the JSON file (Kör az webapp config app settings set with the name of the JSON file).

az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings "@fileName.json"

Det filformat som behövs är en JSON-matris med inställningar där platsinställningsfältet är valfritt. Till exempel:

[
  {
    "name": "key1",
    "slotSetting": false,
    "value": "value1"
  },
  {
    "name": "key2",
    "value": "value2"
  }
]

För enkelhetens skull kan du spara befintliga inställningar i en JSON-fil med az webapp config appsettings list. Följande exempel kan köras i Bash.

# Save the settings
az webapp config appsettings list --name <app-name> --resource-group <group-name> > settings.json

# Edit the JSON file
...

# Update the app with the JSON file
az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings @settings.json

Det går inte att redigera appinställningar i grupp med hjälp av en JSON-fil med Azure PowerShell.

1. I Azure-portalen söker du efter och väljer App Services och väljer sedan din app.

   

2. I appens vänstra meny väljer du Inställningar för konfigurationsprogram>.

   

   Som standard döljs värden för anslutningssträng i portalen för säkerhet. Om du vill se ett dolt värde för en anslutningssträng väljer du fältet Värde. Om du vill se dolda värden för alla anslutningssträng väljer du knappen Visa värde.

3. Om du vill lägga till en ny anslutningssträng väljer du Nytt anslutningssträng. Om du vill redigera en anslutningssträng väljer du knappen Redigera till höger.

4. I dialogrutan kan du hålla anslutningssträng till det aktuella facket.

5. När du är klar väljer du Uppdatera. Glöm inte att välja Spara tillbaka på sidan Konfiguration.

Lägg till eller redigera en appinställning med az webapp config connection-string set:

az webapp config connection-string set --name <app-name> --resource-group <group-name> --connection-string-type <type> --settings <string-name>='<value>'

Ersätt <string-name> med namnet på anslutningssträng och <value> med värdet som ska tilldelas till den. Möjliga värden <type> för (till exempel SQLAzure), finns i CLI-kommandodokumentationen.

Visa alla anslutningssträng och deras värden med az webapp config connection-string list:

az webapp config connection-string list --name <app-name> --resource-group <group-name>

Ta bort en eller flera anslutningssträng med az webapp config connection-string delete:

az webapp config connection-string delete --name <app-name> --resource-group <group-name> --setting-names {<string-name1>,<string-name2>,...}

Ange en eller flera anslutningssträng med Set-AzWebApp:

$PropertiesObject = @{
  "<string-name1>" = @{
    value="<connection-string1>";
    type="<type>"};
  "<string-name2>" = @{
    value="<connection-string2>";
    type="<type>"}
}

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -ConnectionStrings $PropertiesObject

Varje anslutningssträng innehåller ett namn (<string-name1>), ett värde (<connection-string1>) och typen, vilket är ett numeriskt värde som motsvarar ett av Anslut ionStringType-uppräkningsfälten. För SQL Azure anger du type="2"till exempel .

Den här cmdleten ersätter hela uppsättningen med anslutningssträng med de som du anger. Om du vill lägga till eller redigera en appinställning i en befintlig uppsättning inkluderar du de befintliga appinställningarna i din indata-hashtable med hjälp av cmdleten Get-AzWebApp . Till exempel:

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy connection strings to a new hashtable
$connStrings = @{}
ForEach ($item in $webapp.SiteConfig.ConnectionStrings) {
    $connStrings[$item.Name] = @{value=$item.ConnectionString; type=$item.Type.ToString()}
}

# Add or edit one or more connection strings
$connStrings['<string-name1>'] = @{value='<connection-string1>', type='<type>'}
$connStrings['<string-name2>'] = @{value='<connection-string2>', type='<type>'}

# Save changes
Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -ConnectionStrings $connStrings

Om du vill kontrollera om en anslutningssträng är platsspecifik använder du Get-AzWebAppSlotConfigName:

Get-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> | select ConnectionStringNames

Om du vill göra en eller flera anslutningssträng s fackspecifika använder du Set-AzWebAppSlotConfigName:

Set-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> -ConnectionStringNames <string-name1>,<string-name2>,...

Välj knappen Avancerad redigering. Redigera anslutningssträng i textområdet. När du är klar väljer du Uppdatera. Glöm inte att välja Spara tillbaka på sidan Konfiguration.

Anslut ionssträngar har följande JSON-formatering:

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

Kör az webapp config connection-string set med namnet på JSON-filen.

az webapp config connection-string set --resource-group <group-name> --name <app-name> --settings "@fileName.json"

Filformatet som behövs är en JSON-matris med anslutningssträng där platsinställningsfältet är valfritt. Till exempel:

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

För enkelhetens skull kan du spara befintliga anslutningssträng i en JSON-fil med az webapp config connection-string list. Följande exempel kan köras i Bash.

# Save the connection strings
az webapp config connection-string list --resource-group <group-name> --name <app-name> > settings.json

# Edit the JSON file
...

# Update the app with the JSON file
az webapp config connection-string set --resource-group <group-name> --name <app-name> --settings @settings.json

Det går inte att redigera anslutningssträng i grupp med hjälp av en JSON-fil med Azure PowerShell.

I Azure-portalen söker du efter och väljer App Services och väljer sedan din app. I appens vänstra meny väljer du Konfiguration>Allmänna inställningar.

Här kan du konfigurera några vanliga inställningar för appen. Vissa inställningar kräver att du skalar upp till högre prisnivåer.

• Stackinställningar: Programvarustacken för att köra appen, inklusive språk- och SDK-versioner.

  För Linux-appar kan du välja språkkörningsversion och ange ett valfritt startkommando eller en startkommandofil.

  

• Plattformsinställningar: Låter dig konfigurera inställningar för värdplattformen, inklusive:

  • Plattformsbitness: 32-bitars eller 64-bitars. Endast för Windows-appar.
  • FTP-tillstånd: Tillåt endast FTPS eller inaktivera FTP helt och hållet.
  • HTTP-version: Ange till 2.0 för att aktivera stöd för HTTPS/2-protokoll .

  Kommentar

  De flesta moderna webbläsare stöder endast HTTP/2-protokoll via TLS, medan icke-krypterad trafik fortsätter att använda HTTP/1.1. Skydda ditt anpassade DNS-namn för att säkerställa att klientwebbläsare ansluter till din app med HTTP/2. Mer information finns i Skydda ett anpassat DNS-namn med en TLS/SSL-bindning i Azure App Service.

  • Webbuttag: För ASP.NET SignalR eller socket.io, till exempel.

  • AlwaysOn: Håller appen inläst även om det inte finns någon trafik. När AlwaysOn inte är aktiverat (standard) tas appen bort efter 20 minuter utan inkommande begäranden. Den borttagna appen kan orsaka långa svarstider för nya begäranden på grund av uppvärmningstiden. När Always On är aktiverat skickar frontend-lastbalanseraren en GET-begäran till programroten var femte minut. Den kontinuerliga pingen förhindrar att appen tas bort.

    AlwaysOn krävs för kontinuerliga webbjobb eller för webbjobb som utlöses med hjälp av ett CRON-uttryck.

  • ARR-tillhörighet: I en distribution med flera instanser kontrollerar du att klienten dirigeras till samma instans under sessionens livslängd. Du kan ställa in det här alternativet på Av för tillståndslösa program.

  • Endast HTTPS: När den är aktiverad omdirigeras all HTTP-trafik till HTTPS.

  • Lägsta TLS-version: Välj den lägsta TLS-krypteringsversion som krävs av din app.

• Felsökning: Aktivera fjärrfelsökning för ASP.NET, ASP.NET Core eller Node.js appar. Det här alternativet inaktiveras automatiskt efter 48 timmar.

• Inkommande klientcertifikat: kräver klientcertifikat i ömsesidig autentisering.

Du kan ange många av de vanliga konfigurerbara alternativen med az webapp config set. I följande exempel visas en delmängd av de konfigurerbara alternativen.

az webapp config set --resource-group <group-name> --name <app-name> --use-32bit-worker-process [true|false] --web-sockets-enabled [true|false] --always-on [true|false]--http20-enabled --auto-heal-enabled [true|false] --remote-debugging-enabled [true|false] --number-of-workers

Om du vill visa de befintliga inställningarna använder du kommandot az webapp config show .

Du kan ange många av de vanliga konfigurerbara alternativen med Set-AzWebApp. I följande exempel visas en delmängd av de konfigurerbara alternativen.

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -Use32BitWorkerProcess [True|False] -WebSocketsEnabled [True|False] -AlwaysOn [True|False] -NumberOfWorkers

Om du vill visa de befintliga inställningarna använder du kommandot Get-AzWebApp .

1. I Azure-portalen söker du efter och väljer App Services och väljer sedan din app.

2. I appens vänstra meny väljer du Standarddokument för konfiguration>.

   

3. Om du vill lägga till ett standarddokument väljer du Nytt dokument. Om du vill ta bort ett standarddokument väljer du Ta bort till höger.

Lägg till ett standarddokument med az resource update:

az resource update --resource-group <group-name> --resource-type "Microsoft.Web/sites/config" --name <app-name>/config/web --add properties.defaultDocuments <filename>

Lägg till ett standarddokument genom att ändra uppdateringsappens PowerShell-objekt:

$webapp = Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>
$webapp.SiteConfig.DefaultDocuments.Add("<filename>")
Set-AzWebApp $webapp

1. I Azure-portalen söker du efter och väljer App Services och väljer sedan din app.

2. I appens vänstra meny väljer du Mappningar för konfigurationssökväg>

3. Välj Nytt virtuellt program eller katalog.

   • Om du vill mappa en virtuell katalog till en fysisk sökväg lämnar du kryssrutan Katalog markerad. Ange den virtuella katalogen och motsvarande relativa (fysiska) sökväg till webbplatsroten (D:\home).
   • Om du vill markera en virtuell katalog som ett webbprogram avmarkerar du kryssrutan Katalog .

   

4. Välj OK.

I följande exempel anges rotsökvägen / till underkatalogen public (som fungerar för Laravel) och lägger även till ett andra virtuellt program på /app2 sökvägen. Om du vill köra den skapar du en fil med json.txt namnet med följande innehåll.

[
  {
    "physicalPath"':' "site\\wwwroot\\public",
    "preloadEnabled"':' false,
    "virtualDirectories"':' null,
    "virtualPath"':' "/"
  },
  {
    "physicalPath"':' "site\\wwwroot\\app2",
    "preloadEnabled"':' false,
    "virtualDirectories"':' null,
    "virtualPath"':' "/app2"
  }
]

Ändra <group-name> och <app-name> för dina resurser och kör följande kommando. Tänk på escape-tecken när du kör det här kommandot. Mer information om escape-tecken finns i Tips för att använda Azure CLI.

az resource update --resource-group <group-name> --resource-type Microsoft.Web/sites/config --name <app-name>/config/web --set properties.virtualApplications="@json.txt"

I följande exempel anges rotsökvägen / till underkatalogen public (som fungerar för Laravel) och lägger även till ett andra virtuellt program på /app2 sökvägen. Om du vill köra den ändrar du <group-name> och <app-name>.

$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Set default / path to public subdirectory
$webapp.SiteConfig.VirtualApplications[0].PhysicalPath= "site\wwwroot\public"

# Add a virtual application
$virtualApp = New-Object Microsoft.Azure.Management.WebSites.Models.VirtualApplication
$virtualApp.VirtualPath = "/app2"
$virtualApp.PhysicalPath = "site\wwwroot\app2"
$virtualApp.PreloadEnabled = $false
$webapp.SiteConfig.VirtualApplications.Add($virtualApp)

# Save settings
Set-AzWebApp $webapp