Add-AzRouteConfig

Módulo:
Az.Network Module

Adiciona uma rota a uma tabela de rotas.

Sintaxe

Default (Predefinição) 

Add-AzRouteConfig
    -RouteTable <PSRouteTable>
    [-Name <String>]
    [-AddressPrefix <String>]
    [-NextHopType <String>]
    [-NextHopIpAddress <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

Descrição

O cmdlet Add-AzRouteConfig adiciona uma rota a uma tabela de rotas Azure.

Exemplos

Exemplo 1: Adicionar uma rota a uma tabela de rotas

$RouteTable = Get-AzRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01"
Add-AzRouteConfig -Name "Route13" -AddressPrefix 10.3.0.0/16 -NextHopType "VnetLocal" -RouteTable $RouteTable

O primeiro comando obtém uma tabela de rotas chamada RouteTable01 usando o cmdlet Get-AzRouteTable. O comando armazena a tabela na variável $RouteTable. O segundo comando adiciona uma rota chamada Route13 à tabela de rotas armazenada no $RouteTable. Essa rota encaminha pacotes para a rede virtual local.

Exemplo 2: Adicionar uma rota a uma tabela de rotas usando o pipeline

Get-AzRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01" | Add-AzRouteConfig -Name "Route02" -AddressPrefix 10.2.0.0/16 -NextHopType VnetLocal | Set-AzRouteTable

Name              : routetable01
ResourceGroupName : ResourceGroup11
Location          : eastus
Id                : /subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Microsoft.Networ
                    k/routeTables/routetable01
Etag              : W/"f13e1bc8-d41f-44d0-882d-b8b5a1134f59"
ProvisioningState : Succeeded
Tags              :
Routes            : [
                      {
                        "Name": "route07",
                        "Etag": "W/\"f13e1bc8-d41f-44d0-882d-b8b5a1134f59\"",
                        "Id": "/subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Micro
                    soft.Network/routeTables/routetable01/routes/route07",
                        "AddressPrefix": "10.1.0.0/16",
                        "NextHopType": "VnetLocal",
                        "NextHopIpAddress": null,
                        "ProvisioningState": "Succeeded"
                      },
                      {
                        "Name": "route02",
                        "Etag": "W/\"f13e1bc8-d41f-44d0-882d-b8b5a1134f59\"",
                        "Id": "/subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Micro
                    soft.Network/routeTables/routetable01/routes/route02",
                        "AddressPrefix": "10.2.0.0/16",
                        "NextHopType": "VnetLocal",
                        "NextHopIpAddress": null,
                        "ProvisioningState": "Succeeded"
                      },
                      {
                        "Name": "route13",
                        "Etag": null,
                        "Id": null,
                        "AddressPrefix": "10.3.0.0/16",
                        "NextHopType": "VnetLocal",
                        "NextHopIpAddress": null,
                        "ProvisioningState": null
                      }
                    ]
Subnets           : []

Este comando obtém a tabela de rotas chamada RouteTable01 usando Get-AzRouteTable. O comando passa essa tabela para o cmdlet atual usando o operador de pipeline. O cmdlet atual adiciona a rota chamada Route02 e, em seguida, passa o resultado para o cmdlet Set-AzRouteTable , que atualiza a tabela para refletir suas alterações.

Exemplo 3: Adicionar uma rota com uma etiqueta de serviço a uma tabela de rotas (Visualização pública)

$RouteTable = Get-AzRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01"
Add-AzRouteConfig -Name "Route13" -AddressPrefix "AppService" -NextHopType "VirtualAppliance" -NextHopIpAddress "10.0.2.4" -RouteTable $RouteTable

O primeiro comando obtém uma tabela de rotas chamada RouteTable01 usando o cmdlet Get-AzRouteTable. O comando armazena a tabela na variável $RouteTable. O segundo comando adiciona uma rota chamada Route13 à tabela de rotas armazenada no $RouteTable. Essa rota encaminha o tráfego para prefixos IP contidos na etiqueta de serviço do AppService para um dispositivo virtual.

Parâmetros

-AcquirePolicyToken

Adquira automaticamente um token Azure Policy para esta operação de recurso.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

-AddressPrefix

Especifica o destino, no formato CIDR (Roteamento entre Domínios sem Classe), ao qual a rota se aplica. Você também pode especificar uma etiqueta de serviço aqui (esse recurso está em Visualização pública).

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

-ChangeReference

A alteração do ID de referência do recurso para esta operação de recurso.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
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
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Posto: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
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

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

-Name

Especifica um nome da rota a ser adicionada à tabela de rotas.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

-NextHopIpAddress

Especifica o(s) endereço(s) IP do próximo salto para onde esta rota encaminha os pacotes. Para um NextHopType de VirtualAppliance, forneça um único endereço IP de um appliance virtual que adiciona à sua rede virtual Azure. Para um NextHopType de VirtualApplianceEcmp, forneça entre 2 e 64 endereços IP para balancear o tráfego através do encaminhamento multi-path (ECMP) de custo igual.

Propriedades dos parâmetros

Tipo:

String[]

Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

-NextHopType

Especifica como essa rota encaminha pacotes. Os valores aceitáveis para este parâmetro são:

  • Internet. O gateway de Internet predefinido fornecido pelo Azure.
  • Nenhum. Se você especificar esse valor, a rota não encaminhará pacotes.
  • VirtualAppliance. Um appliance virtual que adiciona à sua rede virtual Azure.
  • VirtualApplianceEcmp. Múltiplos appliances virtuais cujo tráfego é balanceado em carga usando o encaminhamento multi-path (ECMP) de custo igual. Forneça os endereços IP do aparelho através do parâmetro NextHopIpAddress .
  • VirtualNetworkGateway. Um gateway virtual de rede privada Azure server-to-server.
  • VnetLocal. A rede virtual local. Se você tiver duas sub-redes, 10.1.0.0/16 e 10.2.0.0/16 na mesma rede virtual, selecione um valor de VnetLocal para cada sub-rede para encaminhar para a outra sub-rede.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

-RouteTable

Especifica a tabela de rotas à qual esse cmdlet adiciona uma rota.

Propriedades dos parâmetros

Tipo:PSRouteTable
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
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
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Posto: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

PSRouteTable

String

Saídas

PSRouteTable