Configurare un'app di App Service

Questo articolo illustra come configurare le impostazioni comuni per le app Web, un back-end per dispositivi mobili o un'app per le API. Per Funzioni di Azure, vedere Informazioni di riferimento sulle impostazioni dell'app per Funzioni di Azure.

Configurare le impostazioni applicazione

Nel Servizio app di Azure le impostazioni dell'app sono variabili passate come variabili di ambiente al codice dell'applicazione. Le condizioni seguenti si applicano alle impostazioni dell'app:

• I nomi delle impostazioni dell'app possono contenere solo lettere, numeri (0-9), punti (.) e caratteri di sottolineatura (_).
• I caratteri speciali nel valore di un'impostazione dell'app devono essere preceduti da un carattere di escape in base alle esigenze del sistema operativo di destinazione.

Ad esempio, per impostare una variabile di ambiente nel servizio app per Linux con il valore "pa$$w0rd\", la stringa per l'impostazione dell'app deve essere "pa\$\$w0rd\\".

Per le app Linux e i contenitori personalizzati, il servizio app passa le impostazioni dell'app al contenitore usando il --env flag per impostare la variabile di ambiente nel contenitore. In entrambi i casi, vengono inseriti nell'ambiente dell'app all'avvio dell'app. Quando si aggiungono, rimuovono o modificano le impostazioni dell'app, il servizio app attiva il riavvio dell'app.

Per gli sviluppatori ASP.NET e ASP.NET Core, la configurazione delle impostazioni dell'app nel servizio app è come configurarle in <appSettings>Web.config o appsettings.json. I valori nel servizio app sostituiscono quelli in Web.config o appsettings.json. È possibile mantenere le impostazioni di sviluppo, ad esempio la password MySQL locale, in Web.config o appsettings.json. È possibile mantenere i segreti di produzione, ad esempio la password del database MySQL di Azure, in modo sicuro nel servizio app. Lo stesso codice usa le impostazioni di sviluppo quando si esegue il debug in locale. Usa i segreti di produzione quando viene distribuito in Azure.

Altri stack di linguaggio ottengono le impostazioni dell'app come variabili di ambiente in fase di esecuzione. Per i passaggi specifici di ogni stack di linguaggio, vedere:

• ASP.NET Core
• Giava
• Node.JS
• Pitone
• PHP
• Contenitori personalizzati

Le impostazioni dell'app vengono sempre crittografate quando vengono archiviate (crittografate a riposo).

Nota

Se si archiviano segreti nelle impostazioni dell'app, è consigliabile usare i riferimenti ad Azure Key Vault. Se i segreti sono destinati alla connettività alle risorse back-end, prendere in considerazione le opzioni di connettività più sicure e che non richiedono segreti. Per ulteriori informazioni, vedere Connessione sicura ai servizi e ai database di Azure da Azure App Service.

Portale di Azure

1. Nel portale di Azure cercare e selezionare Servizi app, quindi selezionare la propria app.

2. Nel menu a sinistra dell'app selezionare Impostazioni>Variabili di ambiente. Selezionare quindi Impostazioni app.

   

   Per impostazione predefinita, i valori per le impostazioni app sono nascosti nel portale per motivi di sicurezza. Per visualizzare un valore nascosto di un'impostazione dell'app, in Valore selezionare Mostra valore. Per visualizzare i valori nascosti di tutte le impostazioni dell'app, selezionare Mostra valori.

   Nota

   Le autorizzazioni utente di lettura/scrittura sono necessarie per visualizzare questa sezione nel portale di Azure. I ruoli predefiniti di controllo degli accessi in base al ruolo con autorizzazioni sufficienti sono: Proprietario, Collaboratore e Collaboratore sito Web. Al ruolo Lettore soltanto non sarebbe consentito accedere a questa pagina.

3. Per aggiungere una nuova impostazione dell'app, selezionare Aggiungi. Per modificare un'impostazione, selezionare l'impostazione.

4. Nella finestra di dialogo è possibile attaccare l'impostazione allo slot corrente.

   Nota

   In un servizio app Linux predefinito o in un contenitore Linux personalizzato, qualsiasi struttura di chiave JSON annidata nel nome dell'impostazione dell'app deve essere configurata in modo diverso per il nome della chiave. Sostituire i due punti (:) con un doppio carattere di sottolineatura (__). Sostituire qualsiasi punto (.) con un singolo carattere di sottolineatura (_). Ad esempio, ApplicationInsights:InstrumentationKey deve essere configurato nel servizio app come ApplicationInsights__InstrumentationKey per il nome della chiave.

5. Al termine, selezionare Applica. Selezionare quindi Applica nella pagina Variabili di ambiente .

Interfaccia della riga di comando di Azure

Aggiungere o modificare un'impostazione dell'app usando az webapp config app settings set:

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

Sostituire <setting-name> con il nome dell'impostazione. Sostituire <value> con il valore da assegnare all'impostazione.

Visualizzare tutte le impostazioni e i relativi valori usando az webapp config appsettings list:

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

Rimuovere una o più impostazioni usando az webapp config app settings delete:

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

Azure PowerShell

Impostare una o più impostazioni dell'app usando Set-AzWebApp:

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

Questo cmdlet sostituisce l'intero set di impostazioni dell'app con quelle specificate. Per aggiungere o modificare un'impostazione dell'app all'interno di un set esistente, includere le impostazioni dell'app esistenti nella tabella hash di input usando il cmdlet Get-AzWebApp . Ad esempio:

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

# Copy app settings to a new hash table
$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

Per verificare se un'impostazione dell'app è specifica per lo slot, usare Get-AzWebAppSlotConfigName:

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

Per specificare uno o più slot di impostazioni dell'app, usare Set-AzWebAppSlotConfigName:

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

Modificare le impostazioni dell'app in blocco

Portale di Azure

1. Selezionare Modifica avanzata.
2. Modificare le impostazioni nell'area di testo.
3. Al termine, selezionare OK. Selezionare quindi Applica nella pagina Variabili di ambiente .

Le impostazioni dell'app hanno la formattazione JSON seguente:

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

Interfaccia della riga di comando di Azure

Eseguire az webapp config app settings set con il nome del file JSON:

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

Suggerimento

L'inclusione del nome del file con virgolette è obbligatoria solo in PowerShell.

Il formato di file necessario è una matrice JSON di impostazioni in cui il campo delle impostazioni dello slot è facoltativo. Ad esempio:

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

Per praticità, è possibile salvare le impostazioni esistenti in un file JSON usando az webapp config appsettings list.

# Save the settings
az webapp config appsettings list --resource-group <group-name> --name <app-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

Azure PowerShell

Non è possibile modificare le impostazioni dell'app in blocco usando un file JSON con Azure PowerShell.

Configurazione delle stringhe di connessione

Questa sezione descrive come configurare le stringhe di connessione.

Nota

Prendere in considerazione le opzioni di connettività più sicure e che non richiedono segreti di connessione. Per ulteriori informazioni, vedere Connessione sicura ai servizi e ai database di Azure da Azure App Service.

Per gli sviluppatori ASP.NET e ASP.NET Core, l'impostazione delle stringhe di connessione nel servizio app è simile all'impostazione in <connectionStrings> in Web.config. I valori impostati nel servizio app sostituiscono quelli in Web.config. È possibile mantenere le impostazioni di sviluppo, ad esempio un file di database, in Web.config. È possibile mantenere i segreti di produzione, ad esempio le credenziali del database SQL, in modo sicuro nel servizio app. Lo stesso codice usa le impostazioni di sviluppo quando si esegue il debug in locale. Usa i segreti di produzione quando viene distribuito in Azure.

Per gli altri stack di linguaggi, è preferibile invece usare le impostazioni dell'app. Le stringhe di connessione richiedono una formattazione speciale nelle chiavi delle variabili per accedere ai valori.

È possibile usare le stringhe di connessione anziché le impostazioni dell'app per le lingue non-.NET. Alcuni tipi di database di Azure vengono sottoposti a backup insieme all'app solo se si configura una stringa di connessione per il database nell'app del servizio app. Per altre informazioni, vedere Creare un backup personalizzato. Se non è necessario questo backup automatizzato, usare le impostazioni dell'app.

In fase di runtime, le stringhe di connessione sono disponibili come variabili di ambiente, precedute dai tipi di connessione seguenti:

• SQL Server: SQLCONNSTR_
• MySQL: MYSQLCONNSTR_
• Azure SQL: SQLAZURECONNSTR_
• Personalizzato: CUSTOMCONNSTR_
• PostgreSQL: POSTGRESQLCONNSTR_
• Hub di notifica di Azure: NOTIFICATIONHUBCONNSTR_
• Bus di servizio di Azure: SERVICEBUSCONNSTR_
• Hub eventi di Azure: EVENTHUBCONNSTR_
• Azure Cosmos DB: DOCDBCONNSTR_
• Cache Redis: REDISCACHECONNSTR_

Nota

Le app .NET destinate a PostgreSQL, Hub di notifica, bus di servizio, Hub eventi, Azure Cosmos DB e cache Redis devono impostare la stringa di connessione su Personalizzata come soluzione alternativa per un problema noto in .NET EnvironmentVariablesConfigurationProvider.

Ad esempio, è possibile accedere a una stringa di connessione MySQL denominata connectionstring1 come variabile di ambiente MYSQLCONNSTR_connectionString1. Per i passaggi specifici di ogni stack di linguaggio, vedere:

• ASP.NET Core
• Giava
• Node.JS
• Pitone
• PHP
• Contenitori personalizzati

Le stringhe di connessione sono sempre crittografate quando archiviate (crittografate a riposo).

Nota

È anche possibile risolvere le stringhe di connessione da Key Vault usando i riferimenti a Key Vault.

Portale di Azure

1. Nel portale di Azure cercare e selezionare Servizi app, quindi selezionare la propria app.

2. Nel menu a sinistra dell'app selezionare Impostazioni>Variabili di ambiente. Selezionare quindi Stringhe di connessione.

   Per impostazione predefinita, i valori per le stringhe di connessione sono nascosti nel portale per la sicurezza. Per visualizzare un valore nascosto di una stringa di connessione, in Valore selezionare Mostra valore. Per visualizzare i valori nascosti di tutte le stringhe di connessione, selezionare Mostra valori.

3. Per aggiungere una nuova stringa di connessione, selezionare Aggiungi. Per modificare una stringa di connessione, selezionare la stringa di connessione.

4. Nella finestra di dialogo è possibile attaccare la stringa di connessione allo slot corrente.

5. Al termine, selezionare Applica. Selezionare quindi Applica nella pagina Variabili di ambiente .

Interfaccia della riga di comando di Azure

Aggiungere o modificare un'impostazione dell'app usando az webapp config connection-string set:

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

Sostituire <string-name> con il nome della stringa di connessione. Sostituire <value> con il valore da assegnare alla stringa di connessione. Per i possibili valori di <type> (ad esempio, SQLAzure), vedere la documentazione dei comandi dell'interfaccia della riga di comando.

Visualizzare tutte le stringhe di connessione e i relativi valori usando az webapp config connection-string list:

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

Rimuovere una o più stringhe di connessione usando az webapp config connection-string delete:

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

Azure PowerShell

Impostare una o più stringhe di connessione usando 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

Ogni stringa di connessione contiene un nome (<string-name1>), un valore (<connection-string1>) e il tipo . Il tipo è un valore numerico che corrisponde a uno dei campi dell'enumeratore ConnectionStringType . Ad esempio, per AZURE SQL specificare type="2".

Questo cmdlet sostituisce l'intero set di stringhe di connessione con quelle specificate. Per aggiungere o modificare un'impostazione dell'app all'interno di un set esistente, includere le impostazioni dell'app esistenti nella tabella hash di input usando il cmdlet Get-AzWebApp . Ad esempio:

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

# Copy connection strings to a new hash table
$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

Per verificare se una stringa di connessione è specifica dello slot, usare Get-AzWebAppSlotConfigName:

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

Per specificare uno o più slot di stringhe di connessione, usare Set-AzWebAppSlotConfigName:

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

Modificare le stringhe di connessione in blocco

Portale di Azure

1. Selezionare Modifica avanzata.
2. Modificare le stringhe di connessione nell'area di testo.
3. Al termine, selezionare Applica. Non dimenticare di selezionare anche Applica nella pagina Variabili di ambiente .

Le stringhe di connessione hanno la formattazione JSON seguente:

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

Interfaccia della riga di comando di Azure

Eseguire az webapp config connection-string set con il nome del file JSON:

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

Suggerimento

L'inclusione del nome del file con virgolette è obbligatoria solo in PowerShell.

Il formato di file necessario è una matrice JSON di stringhe di connessione in cui il campo delle impostazioni dello slot è facoltativo. Ad esempio:

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

Per praticità, è possibile salvare le stringhe di connessione esistenti in un file JSON usando az webapp config connection-string list.

# 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

Azure PowerShell

Non è possibile modificare le stringhe di connessione in blocco usando un file JSON con Azure PowerShell.

Configurare le impostazioni dello stack di linguaggio

Per configurare le impostazioni dello stack di linguaggio, vedere queste risorse:

• ASP.NET Core
• Giava
• Node.JS
• Pitone
• PHP

Configurare le impostazioni generali

Per configurare le impostazioni generali, seguire la procedura per gli strumenti preferiti.

Portale di Azure

1. Nel portale di Azure cercare e selezionare Servizi app, quindi selezionare la propria app.

2. Nel menu a sinistra dell'app selezionare Configurazione impostazioni>. Selezionare quindi Impostazioni generali.

   

Qui è possibile configurare alcune impostazioni comuni per l'app. Alcune impostazioni richiedono di aumentare le prestazioni fino ai piani tariffari più elevati.

• Impostazioni dello stack: configurare le impostazioni per lo stack di software per eseguire l'app, tra cui la lingua e le versioni dell'SDK.

  Per le app Linux, è possibile selezionare la versione del runtime del linguaggio e impostare un comando di avvio facoltativo.

• Impostazioni della piattaforma: configurare le impostazioni per la piattaforma di hosting, tra cui:

  • Piattaforma: scegliere 32 bit o 64 bit. Solo per le app di Windows.

  • Stato FTP: consente solo FTPS o disabilita completamente FTP.

  • Versione HTTP: impostare su 2.0 per abilitare il supporto per il protocollo HTTPS/2 .

    Nota

    La maggior parte dei browser moderni supporta solo il protocollo HTTP/2 su TLS. Il traffico non crittografato continua a usare HTTP/1.1. Per assicurarsi che i browser client si connettano all'app con HTTP/2, proteggere il nome DNS personalizzato. Per altre informazioni, vedere Fornire sicurezza per un nome DNS personalizzato con un'associazione TLS/SSL nel servizio app.

  • Web sockets: Configurare per ASP.NET SignalR o socket.io, ad esempio.

  • Always On: attiva se vuoi mantenere l'app caricata anche quando non è presente traffico.

    Quando Always On è disattivato (impostazione predefinita), l'app viene scaricata dopo 20 minuti senza richieste in ingresso. L'app scaricata può causare una latenza elevata per le nuove richieste a causa del tempo di riscaldamento.

    Quando Always On è attivato, il servizio di bilanciamento del carico front-end invia una GET richiesta alla radice dell'applicazione ogni cinque minuti. Il ping continuo impedisce che l'app venga scaricata.

    Always On è necessario per i processi Web continui o per i processi Web attivati da un'espressione cron.

  • Affinità di sessione: in una distribuzione a più istanze, assicurarsi che il client venga instradato alla stessa istanza per la durata della sessione. È possibile impostare questa opzione su Disattivato per le applicazioni senza stato.

  • Proxy di affinità di sessione: attivarlo se l'app si trova dietro un proxy inverso (come il gateway applicazione di Azure o Frontdoor di Azure) e si sta usando il nome host predefinito. Il dominio per il cookie di affinità di sessione è allineato al nome host inoltrato dal proxy inverso.

  • Solo HTTPS: abilitare se si vuole reindirizzare tutto il traffico HTTP a HTTPS.

  • Versione minima di TLS: selezionare la versione minima della crittografia TLS richiesta dall'app.

• Debug: abilitare il debug remoto per le app ASP.NET, ASP.NET Coreo Node.js. Questa opzione si disattiva automaticamente dopo 48 ore.

• Certificati client in ingresso: È necessario richiedere i certificati client per l'autenticazione reciproca.

Interfaccia della riga di comando di Azure

È possibile impostare molte delle opzioni configurabili comuni usando az webapp config set. L'esempio seguente mostra un subset delle opzioni configurabili:

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

Per visualizzare le impostazioni esistenti, usare il comando az webapp config show.

Azure PowerShell

È possibile impostare molte delle opzioni configurabili comuni usando Set-AzWebApp. L'esempio seguente mostra un subset delle opzioni configurabili:

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

Per visualizzare le impostazioni esistenti, usare il comando Get-AzWebApp.

Configurare i documenti predefiniti

Il documento predefinito è la pagina web visualizzata nell'URL radice di un'app di App Service. Viene usato il primo file corrispondente nell'elenco. Se l'app usa moduli che instradano in base all'URL anziché fornire contenuti statici, non è necessario disporre di documenti predefiniti.

L'impostazione per configurare i documenti predefiniti è solo per le app di Windows.

Portale di Azure

1. Nel portale di Azure cercare e selezionare Servizi app, quindi selezionare la propria app.
2. Nel menu a sinistra dell'app selezionare Configurazione. Selezionare quindi Documenti predefiniti.
3. Per aggiungere un documento predefinito, selezionare Nuovo documento. Per rimuovere un documento predefinito, selezionare Elimina alla sua destra.

Interfaccia della riga di comando di Azure

Aggiungere un documento predefinito usando 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>

Azure PowerShell

Aggiungere un documento predefinito modificando l'oggetto PowerShell dell'app in aggiornamento:

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

Eseguire il mapping di un percorso URL a una directory

Per impostazione predefinita, il servizio app avvia l'app dalla directory radice del codice dell'app. Alcuni framework Web, tuttavia, non vengono avviati nella directory radice. Ad esempio, Laravel inizia nella sottodirectory public. Tale app sarà, ad esempio, accessibile in http://contoso.com/public, ma in genere si vuole indirizzare http://contoso.com alla directory public. Se il file di avvio dell'app si trova in una cartella diversa o se il repository contiene più di un'applicazione, è possibile modificare o aggiungere applicazioni e directory virtuali.

La funzionalità di mapping di una directory virtuale a un percorso fisico è disponibile solo nelle app di Windows.

Portale di Azure

1. Nel portale di Azure cercare e selezionare Servizi app, quindi selezionare la propria app.

2. Nel menu a sinistra dell'app selezionare Configurazione impostazioni>. Selezionare quindi Mappature del percorso.

3. Selezionare Nuova applicazione o directory virtuale. Eseguire quindi una di queste azioni:

   • Per eseguire il mapping di una directory virtuale a un percorso fisico, lasciare selezionata Directory. Specificare la directory virtuale e il relativo percorso (fisico) corrispondente alla radice del sito Web (D:\home).
   • Per contrassegnare una directory virtuale come applicazione Web, deselezionare Directory.

   

4. Selezionare OK. Selezionare quindi Salva nella pagina Configurazione .

Interfaccia della riga di comando di Azure

Nell'esempio seguente il percorso radice / viene impostato sulla sottodirectory public, compatibile con Laravel. Aggiunge anche una seconda applicazione virtuale nel /app2 percorso. Per eseguirlo, creare un file denominato json.txt con il contenuto seguente:

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

Modificare <group-name> e <app-name> per le risorse ed eseguire il comando seguente. Tenere presente i caratteri di escape quando si esegue questo comando. Per altre informazioni sui caratteri di escape, vedere Suggerimenti per l'uso dell'interfaccia della riga di comando di Azure.

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

Azure PowerShell

Nell'esempio seguente il percorso radice / viene impostato sulla sottodirectory public, compatibile con Laravel. Aggiunge anche una seconda applicazione virtuale nel /app2 percorso. Per eseguirlo, modificare <group-name> e <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

Configurare i mapping gestori

Per le app di Windows è possibile personalizzare i mapping dei gestori di IIS, le applicazioni virtuali e le directory. I mapping dei gestori consentono di aggiungere processori script personalizzati per gestire le richieste per estensioni di file specifiche.

Per aggiungere un gestore personalizzato:

1. Nel portale di Azure cercare e selezionare Servizi app, quindi selezionare la propria app.

2. Nel menu a sinistra dell'app selezionare Configurazione impostazioni>. Selezionare quindi Mappature del percorso.

3. Selezionare Nuovo mapping gestore. Configurare il gestore come segue:

   • Estensione. Estensione di file che si desidera gestire, ad esempio *.php o handler.fcgi.
   • Processore di script Il percorso assoluto del processore di script. Il processore di script elabora le richieste ai file che corrispondono all'estensione di file. Utilizzare il percorso D:\home\site\wwwroot per fare riferimento alla directory radice della propria app.
   • Argomenti. Argomenti facoltativi della riga dei comando per il processore script.

4. Selezionare OK. Selezionare quindi Salva nella pagina Configurazione .

Configurare contenitori personalizzati

• Configurare un contenitore personalizzato per il Servizio app di Azure
• Connettere Azure Storage come condivisione locale nel Servizio App

Contenuti correlati

• Variabili di ambiente e impostazioni dell'app nel servizio app di Azure
• Configurare un dominio personalizzato esistente nel servizio app di Azure
• Configurare gli ambienti di gestione temporanea in Servizio app di Azure
• Abilitare HTTPS per un dominio personalizzato nel servizio app di Azure
• Abilitare la registrazione diagnostica per le app nel Servizio app di Azure
• Aumentare le prestazioni di un'app nel Servizio app di Azure
• Quote e avvisi del servizio app di Azure
• Modificare le impostazioni applicationHost.config con applicationHost.xdt