Update-AzFunctionAppSetting

Aggiunge o aggiorna le impostazioni dell'app in un'app per le funzioni.

Sintassi

Update-AzFunctionAppSetting
      -Name <String>
      -ResourceGroupName <String>
      -AppSetting <Hashtable>
      [-SubscriptionId <String>]
      [-Force]
      [-DefaultProfile <PSObject>]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]
Update-AzFunctionAppSetting
      -AppSetting <Hashtable>
      -InputObject <ISite>
      [-Force]
      [-DefaultProfile <PSObject>]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

Descrizione

Aggiunge o aggiorna le impostazioni dell'app in un'app per le funzioni.

Esempio

Esempio 1: Aggiungere una nuova impostazione dell'app in un'app per le funzioni.

Update-AzFunctionAppSetting -Name MyAppName -ResourceGroupName MyResourceGroupName -AppSetting @{"Name1" = "Value1"}

Questo comando aggiunge una nuova impostazione dell'app in un'app per le funzioni.

Parametri

-AppSetting

Hashtable con chiavi e valori descrivono le impostazioni dell'app da aggiungere o aggiornare nell'app per le funzioni. Ad esempio: @{"myappsetting"="123"}

Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DefaultProfile
Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Force

Forza il cmdlet ad aggiornare l'impostazione dell'app per le funzioni senza richiedere conferma.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject

Per costruire, vedere la sezione NOTES per le proprietà INPUTOBJECT e creare una tabella hash.

Type:ISite
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Name

Nome dell'app per le funzioni.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ResourceGroupName

Nome del gruppo di risorse a cui appartiene la risorsa.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SubscriptionId

ID sottoscrizione di Azure.

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Input

ISite

Output

IStringDictionary

Note

ALIAS

PROPRIETÀ DEI PARAMETRI COMPLESSI

Per creare i parametri descritti di seguito, creare una tabella hash contenente le proprietà appropriate. Per informazioni sulle tabelle hash, eseguire Get-Help about_Hash_Tables.

INPUTOBJECT <ISite>:

  • Location <String>: posizione della risorsa.
  • [Kind <String>]: tipo di risorsa.
  • [Tag <IResourceTags>]: tag delle risorse.
    • [(Any) <String>]: indica che qualsiasi proprietà può essere aggiunta a questo oggetto.
  • [ClientAffinityEnabled <Boolean?>]: true per abilitare l'affinità client; false per interrompere l'invio di cookie di affinità di sessione, che instradano le richieste client nella stessa sessione alla stessa istanza. Il valore predefinito è true.
  • [ClientCertEnabled <Boolean?>]: true per abilitare l'autenticazione del certificato client (autenticazione reciproca TLS); in caso contrario, false. Il valore predefinito è false.
  • [ClientCertExclusionPath <String>]: percorsi di esclusione delimitati da virgole per l'autenticazione del certificato client
  • [CloningInfoAppSettingsOverride <ICloningInfoAppSettingsOverrides>]: override dell'impostazione dell'applicazione per l'app clonata. Se specificato, queste impostazioni sostituiscono le impostazioni clonate dall'app di origine. In caso contrario, le impostazioni dell'applicazione dall'app di origine vengono mantenute.
    • [(Any) <String>]: indica che qualsiasi proprietà può essere aggiunta a questo oggetto.
  • [CloningInfoCloneCustomHostName <Boolean?>]: true per clonare nomi host personalizzati dall'app di origine; in caso contrario, false.
  • [CloningInfoCloneSourceControl <Boolean?>]: true per clonare il controllo del codice sorgente dall'app di origine; in caso contrario, false.
  • [CloningInfoConfigureLoadBalancing <Boolean?>]: true per configurare il bilanciamento del carico per l'app di origine e di destinazione.
  • [CloningInfoCorrelationId <String>]: ID di correlazione dell'operazione di clonazione. Questo ID associa più operazioni di clonazione per usare lo stesso snapshot.
  • [CloningInfoHostingEnvironment <String>]: ambiente del servizio app.
  • [CloningInfoOverwrite <Boolean?>]: true per sovrascrivere l'app di destinazione; in caso contrario, false.
  • [CloningInfoSourceWebAppId <String>]: ID risorsa ARM dell'app di origine. L'ID risorsa dell'app è nel formato /subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName} per gli slot di produzione e /subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/slots/{slotName} per altri slot.
  • [CloningInfoSourceWebAppLocation <String>]: posizione dell'app di origine, ad esempio Stati Uniti occidentali o Europa settentrionale
  • [CloningInfoTrafficManagerProfileId <String>]: ID risorsa ARM del profilo di Gestione traffico da usare, se esistente. L'ID risorsa di Gestione traffico è nel formato /subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{profileName}.
  • [CloningInfoTrafficManagerProfileName <String>]: nome del profilo di Gestione traffico da creare. Questa operazione è necessaria solo se il profilo di Gestione traffico non esiste già.
  • [Config <ISiteConfig>]: configurazione dell'app.
    • [AcrUseManagedIdentityCred <Boolean?>]: flag per l'uso di cred di identità gestite per il pull di Registro Azure Container
    • [AcrUserManagedIdentityId <String>]: se si usa l'identità gestita dall'utente, l'identità gestita dall'utente ClientId
    • [ActionMinProcessExecutionTime <String>]: tempo minimo per l'esecuzione del processo prima di eseguire l'azione
    • [ActionType <AutoHealActionType?>]: azione predefinita da eseguire.
    • [AlwaysOn <Boolean?>]: true se Always On è abilitato; in caso contrario, false.
    • [ApiDefinitionUrl <String>]: URL della definizione dell'API.
    • [ApiManagementConfigId <String>]: identificatore APIM-Api.
    • [AppCommandLine <String>]: riga di comando dell'app da avviare.
    • [AppSetting <INameValuePair[]>]: impostazioni dell'applicazione.
      • [Name <String>]: nome coppia.
      • [Value <String>]: valore di coppia.
    • [AutoHealEnabled <Boolean?>]: true se la correzione automatica è abilitata; in caso contrario, false.
    • [AutoSwapSlotName <String>]: nome dello slot di scambio automatico.
    • [ConnectionString <IConnStringInfo[]>]: stringhe di connessione.
      • [ConnectionString <String>]: valore della stringa di connessione.
      • [Name <String>]: nome della stringa di connessione.
      • [Type <ConnectionStringType?>]: tipo di database.
    • [CorAllowedOrigin <String[]>]: ottiene o imposta l'elenco di origini che devono essere autorizzate a effettuare chiamate tra le origini, ad esempio . http://example.com:12345 Usare "*" per consentirli tutti.
    • [CorSupportCredentials <Boolean?>]: ottiene o imposta un valore che indica se le richieste CORS con credenziali sono consentite. Per informazioni dettagliate, vedere https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#Requests_with_credentials.
    • [CustomActionExe <String>]: eseguibile da eseguire.
    • [CustomActionParameter <String>]: parametri per l'eseguibile.
    • [DefaultDocument <String[]>]: documenti predefiniti.
    • [DetailedErrorLoggingEnabled <Boolean?>]: true se la registrazione dettagliata degli errori è abilitata; in caso contrario, false.
    • [DocumentRoot <String>]: radice del documento.
    • [DynamicTagsJson <String>]: ottiene o imposta una stringa JSON contenente un elenco di tag dinamici che verranno valutati dalle attestazioni utente nell'endpoint di registrazione push.
    • [ExperimentRampUpRule <IRampUpRule[]>]: elenco di regole di ramp-up.
      • [ActionHostName <String>]: nome host di uno slot a cui verrà reindirizzato il traffico se si decide. Ad esempio, myapp-stage.azurewebsites.net.
      • [ChangeDecisionCallbackUrl <String>]: l'algoritmo decisionale personalizzato può essere fornito nell'estensione del sito TiPCallback che è possibile specificare l'URL. Vedere Estensione del sito TiPCallback per lo scaffolding e i contratti. https://www.siteextensions.net/packages/TiPCallback/
      • [ChangeIntervalInMinute <Int32?>]: specifica l'intervallo in minuti per rivalutare ReroutePercentage.
      • [ChangeStep <Double?>]: nello scenario di aumento automatico si tratta del passaggio da cui aggiungere/rimuovere ReroutePercentage finché non raggiunge \nMinReroutePercentage o MaxReroutePercentage. Le metriche del sito vengono controllate ogni N minuti specificati in ChangeIntervalInMinutes.\nL'algoritmo decisionale personalizzato può essere fornito nell'estensione del sito TiPCallback che l'URL può essere specificato in ChangeDecisionCallbackUrl.
      • [MaxReroutePercentage <Double?>]: specifica il limite superiore al di sotto del quale rimarrà ReroutePercentage.
      • [MinReroutePercentage <Double?>]: specifica un limite inferiore al di sopra del quale rimarrà ReroutePercentage.
      • [Name <String>]: nome della regola di routing. Il nome consigliato è puntare allo slot che riceverà il traffico nell'esperimento.
      • [ReroutePercentage <Double?>]: percentuale del traffico che verrà reindirizzato a ActionHostName.
    • [FtpsState <FtpsState?>]: stato del servizio FTP/FTPS
    • [HandlerMapping <IHandlerMapping[]>]: mapping dei gestori.
      • [Argument <String>]: argomenti della riga di comando da passare al processore di script.
      • [Extension <String>]: le richieste con questa estensione verranno gestite usando l'applicazione FastCGI specificata.
      • [ScriptProcessor <String>]: percorso assoluto dell'applicazione FastCGI.
    • [HealthCheckPath <String>]: percorso controllo integrità
    • [Http20Enabled <Boolean?>]: Http20Enabled: configura un sito Web per consentire ai client di connettersi tramite http2.0
    • [HttpLoggingEnabled <Boolean?>]: true se la registrazione HTTP è abilitata; in caso contrario, false.
    • [IPSecurityRestriction <IIPSecurityRestriction[]>]: restrizioni di sicurezza IP per main.
      • [Action <String>]: consente o nega l'accesso per questo intervallo IP.
      • [Description <String>]: descrizione della regola di restrizione IP.
      • [IPAddress <String>]: indirizzo IP per cui è valida la restrizione di sicurezza. Può essere in forma di indirizzo ipv4 puro (proprietà SubnetMask obbligatoria) o notazione CIDR, ad esempio ipv4/mask (corrispondenza di bit iniziale). Per CIDR, la proprietà SubnetMask non deve essere specificata.
      • [Name <String>]: nome della regola di restrizione IP.
      • [Priority <Int32?>]: priorità della regola di restrizione IP.
      • [SubnetMask <String>]: subnet mask per l'intervallo di indirizzi IP per cui la restrizione è valida.
      • [SubnetTrafficTag <Int32?>]: tag di traffico subnet (interno)
      • [Tag <IPFilterTag?>]: definisce per quale verrà usato questo filtro IP. Si tratta di supportare il filtro IP sui proxy.
      • [VnetSubnetResourceId <String>]: ID risorsa di rete virtuale
      • [VnetTrafficTag <Int32?>]: tag del traffico di rete virtuale (interno)
    • [IsPushEnabled <Boolean?>]: ottiene o imposta un flag che indica se l'endpoint push è abilitato.
    • [JavaContainer <String>]: contenitore Java.
    • [JavaContainerVersion <String>]: versione del contenitore Java.
    • [JavaVersion <String>]: versione Java.
    • [LimitMaxDiskSizeInMb <Int64?>]: utilizzo massimo delle dimensioni del disco consentite in MB.
    • [LimitMaxMemoryInMb <Int64?>]: utilizzo massimo della memoria consentito in MB.
    • [LimitMaxPercentageCpu <Double?>]: percentuale massima di utilizzo della CPU consentita.
    • [LinuxFxVersion <String>]: Linux App Framework e versione
    • [LoadBalancing <SiteLoadBalancing?>]: bilanciamento del carico del sito.
    • [LocalMySqlEnabled <Boolean?>]: true per abilitare MySQL locale; in caso contrario, false.
    • [LogsDirectorySizeLimit <Int32?>]: limite di dimensioni della directory dei log HTTP.
    • [MachineKeyDecryption <String>]: algoritmo usato per la decrittografia.
    • [MachineKeyDecryptionKey <String>]: chiave di decrittografia.
    • [MachineKeyValidation <String>]: convalida di MachineKey.
    • [MachineKeyValidationKey <String>]: chiave di convalida.
    • [ManagedPipelineMode <ManagedPipelineMode?>]: modalità pipeline gestita.
    • [ManagedServiceIdentityId <Int32?>]: ID identità del servizio gestito
    • [MinTlsVersion <SupportedTlsVersions?>]: MinTlsVersion: configura la versione minima di TLS necessaria per le richieste SSL
    • [NetFrameworkVersion <String>]: versione di .NET Framework.
    • [NodeVersion <String>]: versione di Node.js.
    • [NumberOfWorker <Int32?>]: numero di lavoratori.
    • [PhpVersion <String>]: versione di PHP.
    • [PowerShellVersion <String>]: versione di PowerShell.
    • [PreWarmedInstanceCount <Int32?>]: numero di istanze preWarmed. Questa impostazione si applica solo ai piani elastici e di consumo
    • [PublishingUsername <String>]: pubblicazione del nome utente.
    • [PushKind <String>]: tipo di risorsa.
    • [PythonVersion <String>]: versione di Python.
    • [RemoteDebuggingEnabled <Boolean?>]: true se il debug remoto è abilitato; in caso contrario, false.
    • [RemoteDebuggingVersion <String>]: versione di debug remoto.
    • [RequestCount <Int32?>]: Conteggio richieste.
    • [RequestTimeInterval <String>]: intervallo di tempo.
    • [RequestTracingEnabled <Boolean?>]: true se la traccia della richiesta è abilitata; in caso contrario, false.
    • [RequestTracingExpirationTime <DateTime?>]: data di scadenza della traccia della richiesta.
    • [ScmIPSecurityRestriction <IIPSecurityRestriction[]>]: restrizioni di sicurezza IP per scm.
    • [ScmIPSecurityRestrictionsUseMain <Boolean?>]: restrizioni di sicurezza IP per scm da usare main.
    • [ScmType <ScmType?>]: tipo SCM.
    • [SlowRequestCount <Int32?>]: Conteggio richieste.
    • [SlowRequestTimeInterval <String>]: intervallo di tempo.
    • [SlowRequestTimeTaken <String>]: tempo impiegato.
    • [TagWhitelistJson <String>]: ottiene o imposta una stringa JSON contenente un elenco di tag consentiti da usare dall'endpoint di registrazione push.
    • [TagsRequiringAuth <String>]: ottiene o imposta una stringa JSON contenente un elenco di tag che richiedono l'autenticazione utente da usare nell'endpoint di registrazione push. I tag possono essere costituiti da caratteri alfanumerici e i seguenti: '_', '@', '#', '.', ':', '-'. La convalida deve essere eseguita in PushRequestHandler.
    • [TracingOption <String>]: opzioni di traccia.
    • [TriggerPrivateBytesInKb <Int32?>]: regola basata su byte privati.
    • [TriggerStatusCode <IStatusCodesBasedTrigger[]>]: regola basata sui codici di stato.
      • [Count <Int32?>]: Conteggio richieste.
      • [Status <Int32?>]: codice di stato HTTP.
      • [SubStatus <Int32?>]: Stato secondario della richiesta.
      • [TimeInterval <String>]: intervallo di tempo.
      • [Win32Status <Int32?>]: codice di errore Win32.
    • [Use32BitWorkerProcess <Boolean?>]: true per usare il processo di lavoro a 32 bit; in caso contrario, false.
    • [VirtualApplication <IVirtualApplication[]>]: applicazioni virtuali.
      • [PhysicalPath <String>]: percorso fisico.
      • [PreloadEnabled <Boolean?>]: true se il preload è abilitato; in caso contrario, false.
      • [VirtualDirectory <IVirtualDirectory[]>]: directory virtuali per l'applicazione virtuale.
        • [PhysicalPath <String>]: percorso fisico.
        • [VirtualPath <String>]: percorso dell'applicazione virtuale.
      • [VirtualPath <String>]: percorso virtuale.
    • [VnetName <String>]: Rete virtuale nome.
    • [WebSocketsEnabled <Boolean?>]: true se WebSocket è abilitato; in caso contrario, false.
    • [WindowsFxVersion <String>]: Xenon App Framework e versione
    • [XManagedServiceIdentityId <Int32?>]: ID identità del servizio gestito esplicito
  • [ContainerSize <Int32?>]: dimensione del contenitore di funzioni.
  • [DailyMemoryTimeQuota <Int32?>]: quota giornaliera massima consentita per la memoria (applicabile solo nelle app dinamiche).
  • [Enabled <Boolean?>]: true se l'app è abilitata; in caso contrario, false. L'impostazione di questo valore su false disabilita l'app (accetta l'app offline).
  • [HostNameSslState <IHostNameSslState[]>]: gli stati SSL nome host vengono usati per gestire le associazioni SSL per i nomi host dell'app.
    • [HostType <HostType?>]: indica se il nome host è un nome host standard o repository.
    • [Name <String>]: nome host.
    • [SslState <SslState?>]: tipo SSL.
    • [Thumbprint <String>]: identificazione personale del certificato SSL.
    • [ToUpdate <Boolean?>]: impostare su per true aggiornare il nome host esistente.
    • [VirtualIP <String>]: indirizzo IP virtuale assegnato al nome host se è abilitato SSL basato su IP.
  • [HostNamesDisabled <Boolean?>]: true per disabilitare i nomi host pubblici dell'app; in caso contrario, false. Se true, l'app è accessibile solo tramite il processo di gestione API.
  • [HostingEnvironmentProfileId <String>]: ID risorsa dell'ambiente del servizio app.
  • [HttpsOnly <Boolean?>]: HttpsOnly: configura un sito Web per accettare solo richieste https. Problemi di reindirizzamento per le richieste http
  • [HyperV <Boolean?>]: sandbox Hyper-V.
  • [IdentityType <ManagedServiceIdentityType?>]: tipo di identità del servizio gestito.
  • [IdentityUserAssignedIdentity <IManagedServiceIdentityUserAssignedIdentities>]: elenco delle identità assegnate dall'utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel modulo: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}
    • [(Any) <IComponents1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties>]: indica che qualsiasi proprietà può essere aggiunta a questo oggetto.
  • [IsXenon <Boolean?>]: obsoleto: sandbox Hyper-V.
  • [RedundancyMode <RedundancyMode?>]: modalità di ridondanza del sito
  • [Reserved <Boolean?>]: true se riservato; in caso contrario, false.
  • [ScmSiteAlsoStopped <Boolean?>]: true per arrestare il sito SCM (KUDU) quando l'app viene arrestata; in caso contrario, false. Il valore predefinito è false.
  • [ServerFarmId <String>]: ID risorsa del piano di servizio app associato, formattato come : "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}".