Set-AzApplicationGatewayHttpListener

Modul:

Az.Network Module

Ändrar en HTTP-lyssnare för en programgateway.

Syntax

SetByResourceId

Set-AzApplicationGatewayHttpListener
    -ApplicationGateway <PSApplicationGateway>
    -Name <String>
    -Protocol <String>
    [-FrontendIPConfigurationId <String>]
    [-FrontendPortId <String>]
    [-SslCertificateId <String>]
    [-FirewallPolicyId <String>]
    [-SslProfileId <String>]
    [-HostName <String>]
    [-HostNames <String[]>]
    [-RequireServerNameIndication <String>]
    [-CustomErrorConfiguration <PSApplicationGatewayCustomError[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResource

Set-AzApplicationGatewayHttpListener
    -ApplicationGateway <PSApplicationGateway>
    -Name <String>
    -Protocol <String>
    [-FrontendIPConfiguration <PSApplicationGatewayFrontendIPConfiguration>]
    [-FrontendPort <PSApplicationGatewayFrontendPort>]
    [-FirewallPolicy <PSApplicationGatewayWebApplicationFirewallPolicy>]
    [-SslCertificate <PSApplicationGatewaySslCertificate>]
    [-SslProfile <PSApplicationGatewaySslProfile>]
    [-HostName <String>]
    [-HostNames <String[]>]
    [-RequireServerNameIndication <String>]
    [-CustomErrorConfiguration <PSApplicationGatewayCustomError[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

Cmdleten Set-AzApplicationGatewayHttpListener ändrar en HTTP-lyssnare för en Azure-programgateway.

Exempel

Exempel 1: Ange en HTTP-lyssnare

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol Http -FrontendIpConfiguration $FIP01 -FrontendPort 80

Det första kommandot hämtar programgatewayen med namnet ApplicationGateway01 som tillhör resursgruppen med namnet ResourceGroup01 och lagrar den i variabeln $AppGw. Det andra kommandot anger HTTP-lyssnaren för gatewayen så att klientdelskonfigurationen som lagras i $FIP 01 med HTTP-protokollet på port 80 används.

Exempel 2: Lägg till en HTTPS-lyssnare med SSL och HostNames

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01 -SslCertificate $SSLCert01 -HostNames "*.contoso.com,www.microsoft.com"

Det första kommandot hämtar programgatewayen och lagrar den i variabeln $AppGw. Det andra kommandot lägger till lyssnaren, som använder HTTPS-protokollet, med SSL-certifikat och Värdnamn, till programgatewayen.

Parametrar

-ApplicationGateway

Anger den programgateway som den här cmdleten associerar HTTP-lyssnaren med.

Parameteregenskaper

Typ:	PSApplicationGateway
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	True
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-CustomErrorConfiguration

Kundfel för en programgateway

Parameteregenskaper

Typ:	PSApplicationGatewayCustomError[]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Parameteregenskaper

Typ:	IAzureContextContainer
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-FirewallPolicy

Brandväggspolicy

Parameteregenskaper

Typ:	PSApplicationGatewayWebApplicationFirewallPolicy
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

SetByResource

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-FirewallPolicyId

FirewallPolicyId

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

SetByResourceId

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-FrontendIPConfiguration

Anger klientdelens IP-adress för programgatewayen.

Parameteregenskaper

Typ:	PSApplicationGatewayFrontendIPConfiguration
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

SetByResource

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-FrontendIPConfigurationId

Anger ID för klientdelens IP-adress för programgatewayen.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

SetByResourceId

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-FrontendPort

Anger klientdelsporten för programgatewayen.

Parameteregenskaper

Typ:	PSApplicationGatewayFrontendPort
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

SetByResource

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-FrontendPortId

Anger programgatewayens port-ID för klientdelen.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

SetByResourceId

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-HostName

Anger värdnamnet som den här cmdleten skickar HTTP-lyssnaren till.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-HostNames

Värdnamn

Parameteregenskaper

Typ:	String[]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Name

Anger namnet på HTTP-lyssnaren.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Protocol

Anger det protokoll som HTTP-lyssnaren använder. De godtagbara värdena för den här parametern är:

• http (på engelska)
• Https

Parameteregenskaper

Typ:	String
Standardvärde:	None
Godkända värden:	Http, Https
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-RequireServerNameIndication

Anger om cmdleten kräver en servernamnsindikator. De godtagbara värdena för den här parametern är: true eller false.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Godkända värden:	true, false
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-SslCertificate

Anger SSL-certifikatet för HTTP-lyssnaren.

Parameteregenskaper

Typ:	PSApplicationGatewaySslCertificate
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

SetByResource

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-SslCertificateId

Anger SSL-certifikat-ID (Secure Socket Layer) för HTTP-lyssnaren.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

SetByResourceId

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-SslProfile

SslProfile

Parameteregenskaper

Typ:	PSApplicationGatewaySslProfile
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

SetByResource

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-SslProfileId

SslProfileId

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

SetByResourceId

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

PSApplicationGateway

Utdata

PSApplicationGateway

Relaterade länkar

• Add-AzApplicationGatewayHttpListener
• Get-AzApplicationGatewayHttpListener
• New-AzApplicationGatewayHttpListener
• Remove-AzApplicationGatewayHttpListener