Share via

Add-AzureRmRouteConfig

  • Reference
Modul:
AzureRM.Network

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

Upozorňující

Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

Syntax

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

Description

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

Příklady

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

PS C:\>$RouteTable = Get-AzureRmRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01"
PS C:\> Add-AzureRmRouteConfig -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-AzureRmRouteTable. 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

PS C:\>Get-AzureRmRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01" | Add-AzureRmRouteConfig -Name "Route02" -AddressPrefix 10.2.0.0/16 -NextHopType VnetLocal | Set-AzureRmRouteTable
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-AzureRmRouteTable. 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-AzureRmRouteTable , která aktualizuje tabulku tak, aby odrážela vaše změny.

Parametry

-AddressPrefix

Určuje cíl ve formátu technologie CIDR (Classless Interdomain Routing) (CIDR), na který se trasa vztahuje.

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

-Confirm

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

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

-DefaultProfile

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

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

-Name

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

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

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

-RouteTable

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

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

-WhatIf

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

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

Vstupy

PSRouteTable

String

Výstupy

PSRouteTable