Sdílet prostřednictvím

Add-AzRouteConfig

  • Reference
Modul:
Az.Network

Přidá trasu do směrovací tabulky.

Syntaxe

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

Description

Rutina Add-AzRouteConfig přidá trasu do směrovací tabulky Azure.

Příklady

Příklad 1: Přidání trasy do směrovací tabulky

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

První příkaz získá směrovací tabulku s názvem RouteTable01 pomocí rutiny Get-AzRouteTable. Příkaz uloží tabulku do proměnné $RouteTable. Druhý příkaz přidá trasu s názvem Route13 do směrovací tabulky uložené v $RouteTable. Tato trasa předává pakety do místní virtuální sítě.

Příklad 2: Přidání trasy do směrovací tabulky pomocí kanálu

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

Tento příkaz získá směrovací tabulku s názvem RouteTable01 pomocí Rutiny Get-AzRouteTable. Příkaz předá danou tabulku aktuální rutině pomocí operátoru kanálu. Aktuální rutina přidá trasu s názvem Route02 a pak předá výsledek rutině Set-AzRouteTable , která aktualizuje tabulku tak, aby odrážela vaše změny.

Příklad 3: Přidání trasy se značkou služby do směrovací tabulky (Public Preview)

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

První příkaz získá směrovací tabulku s názvem RouteTable01 pomocí rutiny Get-AzRouteTable. Příkaz uloží tabulku do proměnné $RouteTable. Druhý příkaz přidá trasu s názvem Route13 do směrovací tabulky uložené v $RouteTable. Tato trasa předává provoz předponám IP adres obsaženým ve značce služby AppService do virtuálního zařízení.

Parametry

-AddressPrefix

Určuje cíl ve formátu technologie CIDR (Classless Interdomain Routing) (CIDR), na který se trasa vztahuje. Tady můžete také zadat značku služby (tato funkce je ve verzi Public Preview).

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje název trasy, která se má přidat do směrovací tabulky.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NextHopIpAddress

Určuje IP adresu virtuálního zařízení, které přidáte do virtuální sítě Azure. Tato trasa předává pakety na tuto adresu. Tento parametr zadejte pouze v případě, že pro parametr NextHopType zadáte hodnotu VirtualAppliance.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-NextHopType

Určuje, jak tato trasa předává pakety. Tento parametr přijímá tyto hodnoty:

  • Internet. Výchozí internetová brána poskytovaná Azure.
  • Nezaokrouhlovat. Pokud zadáte tuto hodnotu, trasa nepředává pakety.
  • VirtualAppliance. Virtuální zařízení, které přidáte do virtuální sítě Azure.
  • VirtualNetworkGateway. Brána virtuální privátní sítě Azure typu server-server.
  • VnetLocal. Místní virtuální síť. Pokud máte ve stejné virtuální síti dvě podsítě, 10.1.0.0/16 a 10.2.0.0/16, vyberte pro každou podsíť hodnotu VNetLocal, která se má předat do druhé podsítě.
Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-RouteTable

Určuje směrovací tabulku, do které tato rutina přidá trasu.

Typ:PSRouteTable
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSRouteTable

String

Výstupy

PSRouteTable