Set-AzFrontDoor

Módulo:
Az.FrontDoor Module

Atualizar um balanceador de carga da porta frontal

Sintaxe

ByFieldsParameterSet (Predefinição) 

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

Description

O cmdlet Set-AzFrontDoor atualiza um balanceador de carga Front Door. Se os parâmetros de entrada não forem fornecidos, os parâmetros antigos da porta frontal existente serão usados.

Exemplos

Exemplo 1: atualize uma porta frontal existente com FrontDoorName e ResourceGroupName.

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

atualizar um FrontDoor existente.

Exemplo 2: atualizar uma porta frontal existente com o objeto PSFrontDoor.

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

atualizar um FrontDoor existente.

Exemplo 3: atualizar uma porta de entrada existente com ResourceId

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

atualizar um FrontDoor existente.

Exemplo 4: atualizar a propriedade BackendPoolSetting EnforceCertificateNameCheck de uma porta frontal existente com -DisableCertificateNameCheck parâmetro switch

A porta frontal a ser atualizada pode ser identificada usando FrontDoorName e ResourceGroupName, objeto PSFrontDoor ou ResourceId. (Ver 3 exemplos acima, por exemplo) O exemplo abaixo usa o objeto 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

atualizar um FrontDoor existente.

Parâmetros

-BackendPool

Backendpools disponíveis para a regra de roteamento.

Propriedades dos parâmetros

Tipo:

PSBackendPool[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-BackendPoolsSetting

Configurações para todos os backendPools.

Propriedades dos parâmetros

Tipo:PSBackendPoolsSetting
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ByFieldsWithBackendPoolsSettingParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ByObjectWithBackendPoolsSettingParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ByResourceIdWithBackendPoolsSettingParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DisableCertificateNameCheck

Se deseja desabilitar a verificação do nome do certificado nas solicitações HTTPS para todos os pools de back-end. Nenhum efeito em solicitações não-HTTPS.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ByFieldsWithCertificateNameCheckParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ByObjectWithCertificateNameCheckParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ByResourceIdWithCertificateNameCheckParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-EnabledState

Estado operacional do balanceador de carga Front Door.

Propriedades dos parâmetros

Tipo:PSEnabledState
Default value:None
Valores aceites:Enabled, Disabled
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-FrontendEndpoint

Pontos de extremidade de front-end disponíveis para a regra de roteamento.

Propriedades dos parâmetros

Tipo:

PSFrontendEndpoint[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-HealthProbeSetting

Configurações da sonda de integridade associadas a essa instância do Front Door.

Propriedades dos parâmetros

Tipo:

PSHealthProbeSetting[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-InputObject

O objeto Front Door a ser atualizado.

Propriedades dos parâmetros

Tipo:PSFrontDoor
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ByObjectParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ByObjectWithCertificateNameCheckParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ByObjectWithBackendPoolsSettingParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-LoadBalancingSetting

Configurações de balanceamento de carga associadas a essa instância do Front Door.

Propriedades dos parâmetros

Tipo:

PSLoadBalancingSetting[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

O nome da porta da frente a ser atualizada.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ByFieldsParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ByFieldsWithCertificateNameCheckParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ByFieldsWithBackendPoolsSettingParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ResourceGroupName

O grupo de recursos ao qual a Porta da Frente pertence.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ByFieldsParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ByFieldsWithCertificateNameCheckParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ByFieldsWithBackendPoolsSettingParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ResourceId

ID do recurso da porta da frente para atualizar

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ByResourceIdParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
ByResourceIdWithCertificateNameCheckParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
ByResourceIdWithBackendPoolsSettingParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-RoutingRule

Regras de roteamento associadas a este FrontDoor

Propriedades dos parâmetros

Tipo:

PSRoutingRule[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Tag

As tags se associam ao FrontDoor.

Propriedades dos parâmetros

Tipo:Hashtable
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

PSFrontDoor

String

Saídas

PSFrontDoor