Condividi tramite


Set-AzApplicationGatewayBackendHttpSetting

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

Sintassi

Default (Impostazione predefinita)

Set-AzApplicationGatewayBackendHttpSetting
    -ApplicationGateway <PSApplicationGateway>
    -Name <String>
    -Port <Int32>
    -Protocol <String>
    -CookieBasedAffinity <String>
    [-RequestTimeout <Int32>]
    [-ConnectionDraining <PSApplicationGatewayConnectionDraining>]
    [-ProbeId <String>]
    [-Probe <PSApplicationGatewayProbe>]
    [-AuthenticationCertificates <PSApplicationGatewayAuthenticationCertificate[]>]
    [-TrustedRootCertificate <PSApplicationGatewayTrustedRootCertificate[]>]
    [-PickHostNameFromBackendAddress]
    [-HostName <String>]
    [-AffinityCookieName <String>]
    [-Path <String>]
    [-DedicatedBackendConnection <Boolean>]
    [-ValidateCertChainAndExpiry <Boolean>]
    [-ValidateSNI <Boolean>]
    [-SniName <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Descrizione

Il cmdlet Set-AzApplicationGatewayBackendHttpSetting 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

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayBackendHttpSetting -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.

Esempio 2

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

Set-AzApplicationGatewayBackendHttpSetting -ApplicationGateway <PSApplicationGateway> -CookieBasedAffinity Enabled -Name 'Setting02' -Port 88 -Probe <PSApplicationGatewayProbe> -Protocol https -RequestTimeout <Int32>

Parametri

-AffinityCookieName

Nome del cookie da usare per il cookie di affinità

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ApplicationGateway

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

Proprietà dei parametri

Tipo:PSApplicationGateway
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-AuthenticationCertificates

Specifica i certificati di autenticazione per il gateway applicazione.

Proprietà dei parametri

Tipo:

PSApplicationGatewayAuthenticationCertificate[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ConnectionDraining

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

Proprietà dei parametri

Tipo:PSApplicationGatewayConnectionDraining
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Valori accettati:Enabled, Disabled
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DedicatedBackendConnection

Abilitare o disabilitare la connessione dedicata per ogni server back-end. Il valore predefinito è impostato su false.

Proprietà dei parametri

Tipo:

Nullable<T>[Boolean]

Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DefaultProfile

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

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-HostName

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PickHostNameFromBackendAddress

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Port

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

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Probe

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

Proprietà dei parametri

Tipo:PSApplicationGatewayProbe
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ProbeId

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Valori accettati:Http, Https
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-RequestTimeout

Specifica un valore di timeout della richiesta.

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SniName

Specificare un valore SNI in modo che corrisponda al nome comune del certificato nel back-end. Per impostazione predefinita, il gateway applicazione usa l'intestazione host della richiesta in ingresso come SNI. Il valore predefinito è Null.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-TrustedRootCertificate

Certificati radice attendibili del gateway applicazione

Proprietà dei parametri

Tipo:

PSApplicationGatewayTrustedRootCertificate[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ValidateCertChainAndExpiry

Verificare o ignorare le convalide della catena e della scadenza del certificato nel server back-end. Il valore predefinito è impostato su true.

Proprietà dei parametri

Tipo:

Nullable<T>[Boolean]

Valore predefinito:True
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ValidateSNI

Se abilitata, verifica se il nome comune del certificato fornito dal server back-end corrisponde al valore SNI (Server Name Indication). Il valore predefinito è vero.

Proprietà dei parametri

Tipo:

Nullable<T>[Boolean]

Valore predefinito:True
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

PSApplicationGateway

Output

PSApplicationGateway