Condividi tramite


Set-AzureRmApplicationGatewayBackendHttpSettings

Aggiorna le impostazioni HTTP back-end per un gateway applicazione.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

Set-AzureRmApplicationGatewayBackendHttpSettings
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   -Port <Int32>
   -Protocol <String>
   -CookieBasedAffinity <String>
   [-RequestTimeout <Int32>]
   [-ConnectionDraining <PSApplicationGatewayConnectionDraining>]
   [-ProbeId <String>]
   [-Probe <PSApplicationGatewayProbe>]
   [-AuthenticationCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayAuthenticationCertificate]>]
   [-TrustedRootCertificate <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayTrustedRootCertificate]>]
   [-PickHostNameFromBackendAddress]
   [-HostName <String>]
   [-AffinityCookieName <String>]
   [-Path <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-AzureRmApplicationGatewayBackendHttpSettings aggiorna le impostazioni HTTP (Hypertext Transfer Protocol) back-end per un gateway applicazione di Azure. Le impostazioni HTTP back-end vengono applicate a tutti i server back-end in un pool.

Esempio

Esempio 1: Aggiornare le impostazioni HTTP back-end per un gateway applicazione

PS C:\>$AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayBackendHttpSettings -ApplicationGateway $AppGw -Name "Setting02" -Port 88 -Protocol "Http" -CookieBasedAffinity "Disabled"

Il primo comando ottiene il gateway applicazione denominato ApplicationGateway01 che appartiene al gruppo di risorse denominato ResourceGroup01 e lo archivia nella variabile $AppGw. Il secondo comando aggiorna le impostazioni HTTP del gateway applicazione nella variabile $AppGw per usare la porta 88, il protocollo HTTP e abilita l'affinità basata su cookie.

Parametri

-AffinityCookieName

Nome del cookie da usare per il cookie di affinità

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ApplicationGateway

Specifica un oggetto gateway applicazione a cui questo cmdlet associa le impostazioni HTTP back-end.

Tipo:PSApplicationGateway
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-AuthenticationCertificates

Specifica i certificati di autenticazione per il gateway applicazione.

Tipo:List<T>[PSApplicationGatewayAuthenticationCertificate]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ConnectionDraining

Svuotamento della connessione della risorsa delle impostazioni HTTP back-end.

Tipo:PSApplicationGatewayConnectionDraining
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CookieBasedAffinity

Specifica se l'affinità basata su cookie deve essere abilitata o disabilitata per il pool di server back-end. I valori accettabili per questo parametro sono: Disabled o Enabled.

Tipo:String
Valori accettati:Enabled, Disabled
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-HostName

Imposta l'intestazione host da inviare ai server back-end.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome dell'oggetto impostazioni HTTP back-end.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Path

Percorso che deve essere usato come prefisso per tutte le richieste HTTP. Se non viene specificato alcun valore per questo parametro, non verrà preceduto alcun percorso.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PickHostNameFromBackendAddress

Contrassegnare se l'intestazione host deve essere selezionata dal nome host del server back-end.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Port

Specifica la porta da usare per ogni server nel pool di server back-end.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Probe

Specifica un probe da associare alle impostazioni HTTP back-end.

Tipo:PSApplicationGatewayProbe
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProbeId

Specifica l'ID del probe da associare alle impostazioni HTTP back-end.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Protocol

Specifica il protocollo da usare per la comunicazione tra il gateway applicazione e i server back-end. I valori accettabili per questo parametro sono Http e Https. In questo parametro viene fatta distinzione tra maiuscole e minuscole.

Tipo:String
Valori accettati:Http, Https
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RequestTimeout

Specifica un valore di timeout della richiesta.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TrustedRootCertificate

Certificati radice attendibili del gateway applicazione

Tipo:List<T>[PSApplicationGatewayTrustedRootCertificate]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

PSApplicationGateway

Parametri: ApplicationGateway (ByValue)

Output

PSApplicationGateway