Udostępnij za pośrednictwem

Add-AzRouteConfig

  • Odwołanie
Moduł:
Az.Network

Dodaje trasę do tabeli tras.

Składnia

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

Opis

Polecenie cmdlet Add-AzRouteConfig dodaje trasę do tabeli tras platformy Azure.

Przykłady

Przykład 1. Dodawanie trasy do tabeli tras

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

Pierwsze polecenie pobiera tabelę tras o nazwie RouteTable01 przy użyciu polecenia cmdlet Get-AzRouteTable. Polecenie przechowuje tabelę w zmiennej $RouteTable. Drugie polecenie dodaje trasę o nazwie Route13 do tabeli tras przechowywanej w $RouteTable. Ta trasa przekazuje pakiety do lokalnej sieci wirtualnej.

Przykład 2. Dodawanie trasy do tabeli tras przy użyciu potoku

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

To polecenie pobiera tabelę tras o nazwie RouteTable01 przy użyciu polecenia Get-AzRouteTable. Polecenie przekazuje tabelę do bieżącego polecenia cmdlet przy użyciu operatora potoku. Bieżące polecenie cmdlet dodaje trasę o nazwie Route02, a następnie przekazuje wynik do polecenia cmdlet Set-AzRouteTable , które aktualizuje tabelę w celu odzwierciedlenia zmian.

Przykład 3. Dodawanie trasy z tagiem usługi do tabeli tras (publiczna wersja zapoznawcza)

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

Pierwsze polecenie pobiera tabelę tras o nazwie RouteTable01 przy użyciu polecenia cmdlet Get-AzRouteTable. Polecenie przechowuje tabelę w zmiennej $RouteTable. Drugie polecenie dodaje trasę o nazwie Route13 do tabeli tras przechowywanej w $RouteTable. Ta trasa przekazuje ruch do prefiksów IP zawartych w tagu usługi AppService do urządzenia wirtualnego.

Parametry

-AddressPrefix

Określa miejsce docelowe w formacie CIDR (Classless Interdomain Routing), do którego ma zastosowanie trasa. Możesz również określić tutaj tag usługi (ta funkcja jest dostępna w publicznej wersji zapoznawczej).

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę trasy, która ma zostać dodana do tabeli tras.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-NextHopIpAddress

Określa adres IP urządzenia wirtualnego dodawanego do sieci wirtualnej platformy Azure. Ta trasa przekazuje pakiety do tego adresu. Określ ten parametr tylko wtedy, gdy określisz wartość parametru VirtualAppliance dla parametru NextHopType .

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-NextHopType

Określa sposób przekazywania pakietów przez tę trasę. Dopuszczalne wartości tego parametru to:

  • Internet. Domyślna brama internetowa zapewniana przez platformę Azure.
  • Brak. Jeśli określisz tę wartość, trasa nie przekazuje pakietów.
  • VirtualAppliance. Urządzenie wirtualne dodawane do sieci wirtualnej platformy Azure.
  • VirtualNetworkGateway. Wirtualna brama sieci prywatnej na serwerze platformy Azure.
  • VnetLocal. Lokalna sieć wirtualna. Jeśli masz dwie podsieci, 10.1.0.0/16 i 10.2.0.0/16 w tej samej sieci wirtualnej, wybierz wartość VnetLocal dla każdej podsieci, aby przekazać dalej do innej podsieci.
Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-RouteTable

Określa tabelę tras, do której to polecenie cmdlet dodaje trasę.

Typ:PSRouteTable
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PSRouteTable

String

Dane wyjściowe

PSRouteTable