你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

New-AzApplicationGatewayRedirectConfiguration

为应用程序网关创建重定向配置。

语法

SetByResourceId

New-AzApplicationGatewayRedirectConfiguration
    -Name <String>
    -RedirectType <String>
    [-TargetListenerID <String>]
    [-IncludePath <Boolean>]
    [-IncludeQueryString <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResource

New-AzApplicationGatewayRedirectConfiguration
    -Name <String>
    -RedirectType <String>
    [-TargetListener <PSApplicationGatewayHttpListener>]
    [-IncludePath <Boolean>]
    [-IncludeQueryString <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByURL

New-AzApplicationGatewayRedirectConfiguration
    -Name <String>
    -RedirectType <String>
    [-TargetUrl <String>]
    [-IncludePath <Boolean>]
    [-IncludeQueryString <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

说明

New-AzApplicationGatewayRedirectConfiguration cmdlet 为应用程序网关创建重定向配置。

示例

示例 1

$RedirectConfig = New-AzApplicationGatewayRedirectConfiguration -Name "Redirect01" -RedirectType Permanent -TargetListener $listener01

此命令创建名为 Redirect01 的重定向配置,并将结果存储在名为 $RedirectConfig 的变量中。

示例 2

为应用程序网关创建重定向配置。 (autogenerated)

New-AzApplicationGatewayRedirectConfiguration -IncludePath $false -IncludeQueryString $false -Name 'Redirect01' -RedirectType Permanent -TargetListener <PSApplicationGatewayHttpListener>

参数

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-IncludePath

在重定向 URL 中包含路径。 默认值为 true。

参数属性

类型:

Nullable<T>[Boolean]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-IncludeQueryString

在重定向 URL 中包含查询字符串。 默认值为 true。

参数属性

类型:

Nullable<T>[Boolean]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

重定向配置的名称

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RedirectType

重定向的类型

参数属性

类型:String
默认值:None
接受的值:Permanent, Found, SeeOther, Temporary
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TargetListener

将请求重定向到的 HTTP 侦听器

参数属性

类型:PSApplicationGatewayHttpListener
默认值:None
支持通配符:False
不显示:False

参数集

SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TargetListenerID

将请求重定向到的 HTTP 侦听器的 ID

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TargetUrl

目标 URL fo 重定向

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

SetByURL
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

None

输出

PSApplicationGatewayRedirectConfiguration