Delen via


Set-AzApplicationGatewayBackendHttpSetting

Hiermee worden back-end-HTTP-instellingen voor een toepassingsgateway bijgewerkt.

Syntax

Default (Standaard)

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>]

Description

De Set-AzApplicationGatewayBackendHttpSetting-cmdlet werkt de http-instellingen (Back-end Hypertext Transfer Protocol) voor een Azure-toepassingsgateway bij. Http-instellingen voor back-end worden toegepast op alle back-endservers in een pool.

Voorbeelden

Voorbeeld 1: De back-end-HTTP-instellingen voor een toepassingsgateway bijwerken

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayBackendHttpSetting -ApplicationGateway $AppGw -Name "Setting02" -Port 88 -Protocol "Http" -CookieBasedAffinity "Disabled"

Met de eerste opdracht wordt de toepassingsgateway met de naam ApplicationGateway01 die deel uitmaakt van de resourcegroep ResourceGroup01, opgeslagen in de variabele $AppGw. Met de tweede opdracht worden de HTTP-instellingen van de toepassingsgateway in de $AppGw variabele bijgewerkt om poort 88, het HTTP-protocol te gebruiken en op cookies gebaseerde affiniteit mogelijk te maken.

Voorbeeld 2

Hiermee worden back-end-HTTP-instellingen voor een toepassingsgateway bijgewerkt. (autogenerated)

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

Parameters

-AffinityCookieName

Cookienaam die moet worden gebruikt voor de affiniteitscookie

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ApplicationGateway

Hiermee geeft u een application gateway-object waarmee deze cmdlet back-end HTTP-instellingen koppelt.

Parametereigenschappen

Type:PSApplicationGateway
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-AuthenticationCertificates

Hiermee geeft u verificatiecertificaten voor de toepassingsgateway.

Parametereigenschappen

Type:

PSApplicationGatewayAuthenticationCertificate[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ConnectionDraining

Het leegmaken van de back-end http-instellingenresource.

Parametereigenschappen

Type:PSApplicationGatewayConnectionDraining
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-CookieBasedAffinity

Hiermee geeft u op of affiniteit op basis van cookies moet worden ingeschakeld of uitgeschakeld voor de back-endserverpool. De acceptabele waarden voor deze parameter zijn: Uitgeschakeld of Ingeschakeld.

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:Enabled, Disabled
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DedicatedBackendConnection

Schakel een speciale verbinding in of uit per back-endserver. De standaardinstelling is ingesteld op onwaar.

Parametereigenschappen

Type:

Nullable<T>[Boolean]

Default value:False
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-HostName

Hiermee stelt u de hostheader in die naar de back-endservers moet worden verzonden.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Name

Hiermee geeft u de naam van het back-end HTTP-instellingenobject.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Path

Pad dat moet worden gebruikt als voorvoegsel voor alle HTTP-aanvragen. Als er geen waarde is opgegeven voor deze parameter, wordt er geen pad voorafgegaan.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PickHostNameFromBackendAddress

Vlag toevoegen als hostheader moet worden gekozen uit de hostnaam van de back-endserver.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Port

Hiermee geeft u de poort die moet worden gebruikt voor elke server in de back-endservergroep.

Parametereigenschappen

Type:Int32
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Probe

Hiermee geeft u een test te koppelen aan de back-end HTTP-instellingen.

Parametereigenschappen

Type:PSApplicationGatewayProbe
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ProbeId

Hiermee geeft u de id van de test die moet worden gekoppeld aan de back-end HTTP-instellingen.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Protocol

Hiermee geeft u het protocol dat moet worden gebruikt voor communicatie tussen de toepassingsgateway en back-endservers. De acceptabele waarden voor deze parameter zijn: Http en Https. Deze parameter is hoofdlettergevoelig.

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:Http, Https
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-RequestTimeout

Hiermee geeft u een time-outwaarde voor aanvragen op.

Parametereigenschappen

Type:Int32
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-SniName

Geef een SNI-waarde op die overeenkomt met de algemene naam van het certificaat in de back-end. De toepassingsgateway gebruikt standaard de hostheader van de binnenkomende aanvraag als de SNI. De standaardwaarde is null.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-TrustedRootCertificate

Vertrouwde basiscertificaten voor Application Gateway

Parametereigenschappen

Type:

PSApplicationGatewayTrustedRootCertificate[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ValidateCertChainAndExpiry

Controleer of sla zowel keten- als verlopende validaties van het certificaat op de back-endserver over. De standaardinstelling is ingesteld op true.

Parametereigenschappen

Type:

Nullable<T>[Boolean]

Default value:True
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ValidateSNI

Indien ingeschakeld, wordt gecontroleerd of de algemene naam van het certificaat dat door de back-endserver is verstrekt, overeenkomt met de SNI-waarde (Server Name Indication). De standaardwaarde is waar.

Parametereigenschappen

Type:

Nullable<T>[Boolean]

Default value:True
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

PSApplicationGateway

Uitvoerwaarden

PSApplicationGateway