Udostępnij przez

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).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RouteTable

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

Type:PSRouteTable
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

PSRouteTable

String

Dane wyjściowe

PSRouteTable