Sdílet prostřednictvím

Add-AzRouteConfig

Modul:
Az.Network Module

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

Syntax

Default (Výchozí) 

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 CIDR (Classless Interdomain Routing), na který se trasa vztahuje. Tady můžete také zadat značku služby (tato funkce je ve verzi Public Preview).

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DefaultProfile

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

Vlastnosti parametru

Typ:IAzureContextContainer
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Name

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-NextHopType

Určuje, jak tato trasa předává pakety. Přijatelné hodnoty pro tento parametr jsou:

  • Internet. Výchozí internetová brána poskytovaná Azure.
  • Žádné. 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ě.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-RouteTable

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

Vlastnosti parametru

Typ:PSRouteTable
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

PSRouteTable

String

Výstupy

PSRouteTable