Compartilhar via


Set-AzFrontDoor

Atualizar um balanceador de carga do Front Door

Sintaxe

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>]
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>]
Set-AzFrontDoor
   -ResourceGroupName <String>
   -Name <String>
   [-RoutingRule <PSRoutingRule[]>]
   [-BackendPool <PSBackendPool[]>]
   [-FrontendEndpoint <PSFrontendEndpoint[]>]
   [-LoadBalancingSetting <PSLoadBalancingSetting[]>]
   [-HealthProbeSetting <PSHealthProbeSetting[]>]
   [-Tag <Hashtable>]
   [-EnabledState <PSEnabledState>]
   -BackendPoolsSetting <PSBackendPoolsSetting>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzFrontDoor
   -InputObject <PSFrontDoor>
   [-RoutingRule <PSRoutingRule[]>]
   [-BackendPool <PSBackendPool[]>]
   [-FrontendEndpoint <PSFrontendEndpoint[]>]
   [-LoadBalancingSetting <PSLoadBalancingSetting[]>]
   [-HealthProbeSetting <PSHealthProbeSetting[]>]
   [-Tag <Hashtable>]
   [-EnabledState <PSEnabledState>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzFrontDoor
   -InputObject <PSFrontDoor>
   [-RoutingRule <PSRoutingRule[]>]
   [-BackendPool <PSBackendPool[]>]
   [-FrontendEndpoint <PSFrontendEndpoint[]>]
   [-LoadBalancingSetting <PSLoadBalancingSetting[]>]
   [-HealthProbeSetting <PSHealthProbeSetting[]>]
   [-Tag <Hashtable>]
   [-EnabledState <PSEnabledState>]
   [-DisableCertificateNameCheck]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzFrontDoor
   -InputObject <PSFrontDoor>
   [-RoutingRule <PSRoutingRule[]>]
   [-BackendPool <PSBackendPool[]>]
   [-FrontendEndpoint <PSFrontendEndpoint[]>]
   [-LoadBalancingSetting <PSLoadBalancingSetting[]>]
   [-HealthProbeSetting <PSHealthProbeSetting[]>]
   [-Tag <Hashtable>]
   [-EnabledState <PSEnabledState>]
   -BackendPoolsSetting <PSBackendPoolsSetting>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzFrontDoor
   -ResourceId <String>
   [-RoutingRule <PSRoutingRule[]>]
   [-BackendPool <PSBackendPool[]>]
   [-FrontendEndpoint <PSFrontendEndpoint[]>]
   [-LoadBalancingSetting <PSLoadBalancingSetting[]>]
   [-HealthProbeSetting <PSHealthProbeSetting[]>]
   [-Tag <Hashtable>]
   [-EnabledState <PSEnabledState>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzFrontDoor
   -ResourceId <String>
   [-RoutingRule <PSRoutingRule[]>]
   [-BackendPool <PSBackendPool[]>]
   [-FrontendEndpoint <PSFrontendEndpoint[]>]
   [-LoadBalancingSetting <PSLoadBalancingSetting[]>]
   [-HealthProbeSetting <PSHealthProbeSetting[]>]
   [-Tag <Hashtable>]
   [-EnabledState <PSEnabledState>]
   [-DisableCertificateNameCheck]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzFrontDoor
   -ResourceId <String>
   [-RoutingRule <PSRoutingRule[]>]
   [-BackendPool <PSBackendPool[]>]
   [-FrontendEndpoint <PSFrontendEndpoint[]>]
   [-LoadBalancingSetting <PSLoadBalancingSetting[]>]
   [-HealthProbeSetting <PSHealthProbeSetting[]>]
   [-Tag <Hashtable>]
   [-EnabledState <PSEnabledState>]
   -BackendPoolsSetting <PSBackendPoolsSetting>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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

Exemplos

Exemplo 1: Atualizar um Front Door 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

atualize um FrontDoor existente.

Exemplo 2: Atualizar um Front Door 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

atualize um FrontDoor existente.

Exemplo 3: Atualizar um Front Door existente com o 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

atualize um FrontDoor existente.

Exemplo 4: atualizar a propriedade BackendPoolSetting EnforceCertificateNameCheck de um Front Door existente com o parâmetro de opção -DisableCertificateNameCheck

O Front Door a ser atualizado pode ser identificado usando FrontoorName e ResourceGroupName, objeto PSFrontDoor ou ResourceId. (Veja acima 3 exemplos, 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

atualize um FrontDoor existente.

Parâmetros

-BackendPool

Backendpools disponíveis para a regra de roteamento.

Tipo:PSBackendPool[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BackendPoolsSetting

Configurações para todos os backendPools.

Tipo:PSBackendPoolsSetting
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableCertificateNameCheck

Se a verificação de nome de certificado deve ser desabilitada em solicitações HTTPS para todos os pools de back-end. Nenhum efeito em solicitações não HTTPS.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnabledState

Status operacional do balanceador de carga do Front Door.

Tipo:PSEnabledState
Valores aceitos:Enabled, Disabled
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FrontendEndpoint

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

Tipo:PSFrontendEndpoint[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-HealthProbeSetting

Configurações de investigação de integridade associadas a esta instância do Front Door.

Tipo:PSHealthProbeSetting[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

O objeto do Front Door a ser atualizado.

Tipo:PSFrontDoor
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-LoadBalancingSetting

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

Tipo:PSLoadBalancingSetting[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

O nome do Front Door a ser atualizado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceGroupName

O grupo de recursos ao qual o Front Door pertence.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceId

A ID do recurso do Front Door a ser atualizada

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-RoutingRule

Regras de roteamento associadas a este FrontDoor

Tipo:PSRoutingRule[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Tag

As marcas associadas com o FrontDoor.

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

PSFrontDoor

String

Saídas

PSFrontDoor