Add-AzApplicationGatewayHttpListener

Modul:

Az.Network Module

Lägger till en HTTP-lyssnare i en programgateway.

Syntax

SetByResourceId

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

Add-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 Add-AzApplicationGatewayHttpListener lägger till en HTTP-lyssnare i en programgateway.

Exempel

Exempel 1: Lägg till en HTTP-lyssnare

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$Appgw = Add-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "listener01" -Protocol "Http" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01

Det första kommandot hämtar programgatewayen och lagrar den i variabeln $AppGw. Det andra kommandot lägger till HTTP-lyssnaren i programgatewayen.

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

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01 -SslCertificate $SSLCert01

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, till programgatewayen.

Exempel 3: Lägga till en HTTPS-lyssnare med SSL och HostNames

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-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 lägger till en HTTP-lyssnare till.

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 klientdels-IP-resursobjektet 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 klientdels-IP-ID:t 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 klientdelsportobjektet 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 lägger till en HTTP-lyssnare i.

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å den klientdelsport som det här kommandot lägger till.

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 protokollet för HTTP-lyssnaren. Både HTTP och HTTPS stöds.

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

Cmdleten Add-AzApplicationGatewayHttpListener lägger till en HTTP-lyssnare i en programgateway.

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. Måste anges om HTTPS väljs som lyssnarprotokoll.

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 för HTTP-lyssnaren. Måste anges om HTTPS väljs som lyssnarprotokoll.

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

• Get-AzApplicationGatewayHttpListener
• New-AzApplicationGatewayHttpListener
• Remove-AzApplicationGatewayHttpListener
• Set-AzApplicationGatewayHttpListener