Add-AzRouteConfig

  • Ссылка
Модуль:
Az.Network

Добавляет маршрут в таблицу маршрутизации.

Синтаксис

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

Описание

Командлет Add-AzRouteConfig добавляет маршрут в таблицу маршрутов Azure.

Примеры

Пример 1. Добавление маршрута в таблицу маршрутов

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

Первая команда получает таблицу маршрутов с именем RouteTable01 с помощью командлета Get-AzRouteTable. Команда сохраняет таблицу в переменной $RouteTable. Вторая команда добавляет маршрут с именем Route13 в таблицу маршрутов, хранящуюся в $RouteTable. Этот маршрут перенаправит пакеты в локальную виртуальную сеть.

Пример 2. Добавление маршрута в таблицу маршрутов с помощью конвейера

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

Эта команда получает таблицу маршрутов с именем RouteTable01 с помощью Get-AzRouteTable. Команда передает эту таблицу текущему командлету с помощью оператора конвейера. Текущий командлет добавляет маршрут с именем Route02, а затем передает результат командлету Set-AzRouteTable , который обновляет таблицу, чтобы отразить изменения.

Пример 3. Добавление маршрута с тегом службы в таблицу маршрутов (общедоступная предварительная версия)

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

Первая команда получает таблицу маршрутов с именем RouteTable01 с помощью командлета Get-AzRouteTable. Команда сохраняет таблицу в переменной $RouteTable. Вторая команда добавляет маршрут с именем Route13 в таблицу маршрутов, хранящуюся в $RouteTable. Этот маршрут перенаправляет трафик к префиксам IP-адресов, содержащимся в теге службы приложений, в виртуальную (модуль).

Параметры

-AddressPrefix

Указывает назначение в формате CIDR (CIDR), к которому применяется маршрут. Вы также можете указать тег службы здесь (эта функция доступна в общедоступной предварительной версии).

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

-Confirm

Запрос подтверждения перед выполнением командлета.

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

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

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

-Name

Задает имя маршрута, добавляемого в таблицу маршрутов.

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

-NextHopIpAddress

Указывает IP-адрес виртуальной (модуль), добавляемой в виртуальную сеть Azure. Этот маршрут перенаправит пакеты в этот адрес. Укажите этот параметр, только если указать значение VirtualAppliance для параметра NextHopType .

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

-NextHopType

Указывает, как этот маршрут перенаправит пакеты. Допустимые значения для этого параметра:

  • Интернет. Шлюз Интернета по умолчанию, предоставляемый Azure.
  • Нет. Если указать это значение, маршрут не пересылает пакеты.
  • VirtualAppliance. Виртуальная (модуль), которую вы добавляете в виртуальную сеть Azure.
  • VirtualNetworkGateway. Шлюз виртуальной частной сети Azure между серверами.
  • VnetLocal. Локальная виртуальная сеть. Если у вас есть две подсети, 10.1.0.0/16 и 10.2.0.0/16 в одной виртуальной сети выберите значение VnetLocal для каждой подсети, чтобы перенаправить другую подсеть.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RouteTable

Указывает таблицу маршрутов, в которую этот командлет добавляет маршрут.

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

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

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

Входные данные

PSRouteTable

String

Выходные данные

PSRouteTable