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

Set-AzFrontDoor

模块:: Az.FrontDoor Module

更新 Front Door 负载均衡器

语法

ByFieldsParameterSet （默认值）

Set-AzFrontDoor
    -ResourceGroupName <String>
    -Name <String>
    [-RoutingRule <PSRoutingRule[]>]
    [-BackendPool <PSBackendPool[]>]
    [-FrontendEndpoint <PSFrontendEndpoint[]>]
    [-LoadBalancingSetting <PSLoadBalancingSetting[]>]
    [-HealthProbeSetting <PSHealthProbeSetting[]>]
    [-Tag <Hashtable>]
    [-EnabledState <PSEnabledState>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByFieldsWithCertificateNameCheckParameterSet

Set-AzFrontDoor
    -ResourceGroupName <String>
    -Name <String>
    [-RoutingRule <PSRoutingRule[]>]
    [-BackendPool <PSBackendPool[]>]
    [-FrontendEndpoint <PSFrontendEndpoint[]>]
    [-LoadBalancingSetting <PSLoadBalancingSetting[]>]
    [-HealthProbeSetting <PSHealthProbeSetting[]>]
    [-Tag <Hashtable>]
    [-EnabledState <PSEnabledState>]
    [-DisableCertificateNameCheck]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByFieldsWithBackendPoolsSettingParameterSet

Set-AzFrontDoor
    -ResourceGroupName <String>
    -Name <String>
    -BackendPoolsSetting <PSBackendPoolsSetting>
    [-RoutingRule <PSRoutingRule[]>]
    [-BackendPool <PSBackendPool[]>]
    [-FrontendEndpoint <PSFrontendEndpoint[]>]
    [-LoadBalancingSetting <PSLoadBalancingSetting[]>]
    [-HealthProbeSetting <PSHealthProbeSetting[]>]
    [-Tag <Hashtable>]
    [-EnabledState <PSEnabledState>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObjectParameterSet

Set-AzFrontDoor
    -InputObject <PSFrontDoor>
    [-RoutingRule <PSRoutingRule[]>]
    [-BackendPool <PSBackendPool[]>]
    [-FrontendEndpoint <PSFrontendEndpoint[]>]
    [-LoadBalancingSetting <PSLoadBalancingSetting[]>]
    [-HealthProbeSetting <PSHealthProbeSetting[]>]
    [-Tag <Hashtable>]
    [-EnabledState <PSEnabledState>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObjectWithCertificateNameCheckParameterSet

Set-AzFrontDoor
    -InputObject <PSFrontDoor>
    [-RoutingRule <PSRoutingRule[]>]
    [-BackendPool <PSBackendPool[]>]
    [-FrontendEndpoint <PSFrontendEndpoint[]>]
    [-LoadBalancingSetting <PSLoadBalancingSetting[]>]
    [-HealthProbeSetting <PSHealthProbeSetting[]>]
    [-Tag <Hashtable>]
    [-EnabledState <PSEnabledState>]
    [-DisableCertificateNameCheck]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObjectWithBackendPoolsSettingParameterSet

Set-AzFrontDoor
    -InputObject <PSFrontDoor>
    -BackendPoolsSetting <PSBackendPoolsSetting>
    [-RoutingRule <PSRoutingRule[]>]
    [-BackendPool <PSBackendPool[]>]
    [-FrontendEndpoint <PSFrontendEndpoint[]>]
    [-LoadBalancingSetting <PSLoadBalancingSetting[]>]
    [-HealthProbeSetting <PSHealthProbeSetting[]>]
    [-Tag <Hashtable>]
    [-EnabledState <PSEnabledState>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByResourceIdParameterSet

Set-AzFrontDoor
    -ResourceId <String>
    [-RoutingRule <PSRoutingRule[]>]
    [-BackendPool <PSBackendPool[]>]
    [-FrontendEndpoint <PSFrontendEndpoint[]>]
    [-LoadBalancingSetting <PSLoadBalancingSetting[]>]
    [-HealthProbeSetting <PSHealthProbeSetting[]>]
    [-Tag <Hashtable>]
    [-EnabledState <PSEnabledState>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByResourceIdWithCertificateNameCheckParameterSet

Set-AzFrontDoor
    -ResourceId <String>
    [-RoutingRule <PSRoutingRule[]>]
    [-BackendPool <PSBackendPool[]>]
    [-FrontendEndpoint <PSFrontendEndpoint[]>]
    [-LoadBalancingSetting <PSLoadBalancingSetting[]>]
    [-HealthProbeSetting <PSHealthProbeSetting[]>]
    [-Tag <Hashtable>]
    [-EnabledState <PSEnabledState>]
    [-DisableCertificateNameCheck]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByResourceIdWithBackendPoolsSettingParameterSet

Set-AzFrontDoor
    -ResourceId <String>
    -BackendPoolsSetting <PSBackendPoolsSetting>
    [-RoutingRule <PSRoutingRule[]>]
    [-BackendPool <PSBackendPool[]>]
    [-FrontendEndpoint <PSFrontendEndpoint[]>]
    [-LoadBalancingSetting <PSLoadBalancingSetting[]>]
    [-HealthProbeSetting <PSHealthProbeSetting[]>]
    [-Tag <Hashtable>]
    [-EnabledState <PSEnabledState>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Set-AzFrontDoor cmdlet 更新 Front Door 负载均衡器。如果未提供输入参数，将使用现有 Front Door 中的旧参数。

示例

示例 1：使用 FrontDoorName 和 ResourceGroupName 更新现有 Front Door。

Set-AzFrontDoor -Name "frontDoor1" -ResourceGroupName "resourceGroup1" -RoutingRule $routingrule1 -BackendPool $backendpool1 -FrontendEndpoint $frontendEndpoint1 -LoadBalancingSetting $loadBalancingSetting1 -HealthProbeSetting $healthProbeSetting1 -BackendPoolsSetting $backendPoolsSetting1

FriendlyName                : frontdoor1
RoutingRules                : {routingrule1}
BackendPools                : {backendpool1}
BackendPoolsSetting         : {backendPoolsSetting1}
EnforceCertificateNameCheck : {backendPoolsSetting1.EnforceCertificateNameCheck}
HealthProbeSettings         : {healthProbeSetting1}
LoadBalancingSettings       : {loadbalancingsetting1}
FrontendEndpoints           : {frontendendpoint1}
EnabledState                : Enabled
ResourceState               : Enabled
ProvisioningState           : Succeeded
Cname                       :
Tags                        : {tag1, tag2}
Id                          : /subscriptions/{guid}/resourcegroups/{guid}/providers/Microsoft.Network/frontdoors/frontdoor1
Name                        : frontdoor1
Type                        : Microsoft.Network/frontdoors

更新现有的 FrontDoor。

示例 2：使用 PSFrontDoor 对象更新现有 Front Door。

Set-AzFrontDoor -InputObject $frontDoor1 -RoutingRule $routingrule1 -BackendPool $backendpool1 -FrontendEndpoint $frontendEndpoint1 -LoadBalancingSetting $loadBalancingSetting1 -HealthProbeSetting $healthProbeSetting1 -BackendPoolsSetting $backendPoolsSetting1

FriendlyName                : frontdoor1
RoutingRules                : {routingrule1}
BackendPools                : {backendpool1}
BackendPoolsSetting         : {backendPoolsSetting1}
EnforceCertificateNameCheck : {backendPoolsSetting1.EnforceCertificateNameCheck}
HealthProbeSettings         : {healthProbeSetting1}
LoadBalancingSettings       : {loadbalancingsetting1}
FrontendEndpoints           : {frontendendpoint1}
EnabledState                : Enabled
ResourceState               : Enabled
ProvisioningState           : Succeeded
Cname                       :
Tags                        : {tag1, tag2}
Id                          : /subscriptions/{guid}/resourcegroups/{guid}/providers/Microsoft.Network/frontdoors/frontdoor1
Name                        : frontdoor1
Type                        : Microsoft.Network/frontdoor1

更新现有的 FrontDoor。

示例 3：使用 ResourceId 更新现有 Front Door

Set-AzFrontDoor -ResourceId $resourceId -RoutingRule $routingrule1 -BackendPool $backendpool1 -FrontendEndpoint $frontendEndpoint1 -LoadBalancingSetting $loadBalancingSetting1 -HealthProbeSetting $healthProbeSetting1 -BackendPoolsSetting $backendPoolsSetting1

FriendlyName                : frontdoor1
RoutingRules                : {routingrule1}
BackendPools                : {backendpool1}
BackendPoolsSetting         : {backendPoolsSetting1}
EnforceCertificateNameCheck : {backendPoolsSetting1.EnforceCertificateNameCheck}
HealthProbeSettings         : {healthProbeSetting1}
LoadBalancingSettings       : {loadbalancingsetting1}
FrontendEndpoints           : {frontendendpoint1}
EnabledState                : Enabled
ResourceState               : Enabled
ProvisioningState           : Succeeded
Cname                       :
Tags                        : {tag1, tag2}
Id                          : /subscriptions/{guid}/resourcegroups/{guid}/providers/Microsoft.Network/frontdoors/frontdoor1
Name                        : frontdoor1
Type                        : Microsoft.Network/frontdoor1

更新现有的 FrontDoor。

示例 4：使用 -DisableCertificateNameCheck switch 参数更新现有 Front Door 的 BackendPoolSetting 属性 EnforceCertificateNameCheck

可以使用 FrontDoorName 和 ResourceGroupName、PSFrontDoor 对象或 ResourceId 标识要更新的 Front Door。（请参阅上面的 3 个示例，例如）下面的示例使用 PSFrontDoor 对象。

Set-AzFrontDoor -InputObject $frontDoor1 -RoutingRule $routingrule1 -BackendPool $backendpool1 -FrontendEndpoint $frontendEndpoint1 -LoadBalancingSetting $loadBalancingSetting1 -HealthProbeSetting $healthProbeSetting1 -DisableCertificateNameCheck

FriendlyName                : frontdoor1
RoutingRules                : {routingrule1}
BackendPools                : {backendpool1}
BackendPoolsSetting         : {PSBackendPoolsSetting object with EnforceCertificateNameCheck is set to Disabled}
EnforceCertificateNameCheck : Disabled
HealthProbeSettings         : {healthProbeSetting1}
LoadBalancingSettings       : {loadbalancingsetting1}
FrontendEndpoints           : {frontendendpoint1}
EnabledState                : Enabled
ResourceState               : Enabled
ProvisioningState           : Succeeded
Cname                       :
Tags                        : {tag1, tag2}
Id                          : /subscriptions/{guid}/resourcegroups/{guid}/providers/Microsoft.Network/frontdoors/frontdoor1
Name                        : frontdoor1
Type                        : Microsoft.Network/frontdoor1

更新现有的 FrontDoor。

参数

-BackendPool

可用于路由规则的后端池。

参数属性

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

参数集

(All)

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

-BackendPoolsSetting

所有 backendPools 的设置。

参数属性

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

参数集

ByFieldsWithBackendPoolsSettingParameterSet

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

ByObjectWithBackendPoolsSettingParameterSet

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

ByResourceIdWithBackendPoolsSettingParameterSet

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

-Confirm

在运行 cmdlet 之前，提示你进行确认。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

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

-DefaultProfile

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

参数属性

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

参数集

(All)

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

-DisableCertificateNameCheck

是否禁用对所有后端池的 HTTPS 请求的证书名称检查。对非 HTTPS 请求没有影响。

参数属性

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

参数集

ByFieldsWithCertificateNameCheckParameterSet

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

ByObjectWithCertificateNameCheckParameterSet

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

ByResourceIdWithCertificateNameCheckParameterSet

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

-EnabledState

Front Door 负载均衡器的操作状态。

参数属性

类型:	PSEnabledState
默认值:	None
接受的值:	Enabled, Disabled
支持通配符:	False
不显示:	False

参数集

(All)

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

-FrontendEndpoint

可用于路由规则的前端终结点。

参数属性

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

参数集

(All)

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

-HealthProbeSetting

与此 Front Door 实例关联的运行状况探测设置。

参数属性

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

参数集

(All)

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

-InputObject

要更新的 Front Door 对象。

参数属性

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

参数集

ByObjectParameterSet

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

ByObjectWithCertificateNameCheckParameterSet

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

ByObjectWithBackendPoolsSettingParameterSet

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

-LoadBalancingSetting

与此 Front Door 实例关联的负载均衡设置。

参数属性

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

参数集

(All)

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

-Name

要更新的 Front Door 的名称。

参数属性

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

参数集

ByFieldsParameterSet

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

ByFieldsWithCertificateNameCheckParameterSet

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

ByFieldsWithBackendPoolsSettingParameterSet

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

-ResourceGroupName

Front Door 所属的资源组。

参数属性

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

参数集

ByFieldsParameterSet

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

ByFieldsWithCertificateNameCheckParameterSet

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

ByFieldsWithBackendPoolsSettingParameterSet

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

-ResourceId

要更新的 Front Door 的资源 ID

参数属性

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

参数集

ByResourceIdParameterSet

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

ByResourceIdWithCertificateNameCheckParameterSet

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

ByResourceIdWithBackendPoolsSettingParameterSet

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

-RoutingRule

与此 FrontDoor 关联的路由规则

参数属性

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

参数集

(All)

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

-Tag

与 FrontDoor 关联的标记。

参数属性

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

参数集

(All)

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

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

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

CommonParameters

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

通过

Set-AzFrontDoor

语法

ByFieldsParameterSet （默认值）

ByFieldsWithCertificateNameCheckParameterSet

ByFieldsWithBackendPoolsSettingParameterSet

ByObjectParameterSet

ByObjectWithCertificateNameCheckParameterSet

ByObjectWithBackendPoolsSettingParameterSet

ByResourceIdParameterSet

ByResourceIdWithCertificateNameCheckParameterSet

ByResourceIdWithBackendPoolsSettingParameterSet

说明

示例

示例 1：使用 FrontDoorName 和 ResourceGroupName 更新现有 Front Door。

示例 2：使用 PSFrontDoor 对象更新现有 Front Door。

示例 3：使用 ResourceId 更新现有 Front Door

示例 4：使用 -DisableCertificateNameCheck switch 参数更新现有 Front Door 的 BackendPoolSetting 属性 EnforceCertificateNameCheck

参数

-BackendPool

参数属性

参数集

-BackendPoolsSetting

参数属性

参数集

-Confirm

参数属性

参数集

-DefaultProfile

参数属性

参数集

-DisableCertificateNameCheck

参数属性

参数集

-EnabledState

参数属性

参数集

-FrontendEndpoint

参数属性

参数集

-HealthProbeSetting

参数属性

参数集

-InputObject

参数属性

参数集

-LoadBalancingSetting

参数属性

参数集

-Name

参数属性

参数集

-ResourceGroupName

参数属性

参数集

-ResourceId

参数属性

参数集

-RoutingRule

参数属性

参数集

-Tag

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters

输入

PSFrontDoor

String

输出

PSFrontDoor

相关链接

反馈