Поделиться через


Set-AzureRoute

Создает маршрут в таблице маршрутов.

Примечание.

Командлеты, на которые ссылается эта документация, предназначены для управления устаревшими ресурсами Azure, используюющими API Azure Service Manager (ASM). Этот устаревший модуль PowerShell не рекомендуется при создании новых ресурсов, так как ASM планируется выйти на пенсию. Дополнительные сведения см. в статье о выходе на пенсию в Azure Service Manager.

Модуль Az PowerShell — это рекомендуемый модуль PowerShell для управления ресурсами Azure Resource Manager (ARM) с помощью PowerShell.

Синтаксис

Set-AzureRoute
   -RouteName <String>
   -AddressPrefix <String>
   -NextHopType <String>
   [-NextHopIpAddress <String>]
   -RouteTable <IRouteTable>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Описание

Командлет Set-AzureRoute создает маршрут в таблице маршрутов. Новый маршрут действует почти сразу же на виртуальных машинах, связанных с таблицей маршрутов.

Примеры

Пример 1. Добавление маршрута следующего прыжка виртуального устройства

PS C:\> New-AzureRouteTable -Name "ApplianceRouteTable" -Location "Central US" -Label "Appliance Route Table" | Set-AzureRoute -RouteName "ApplianceRoute03" -AddressPrefix "10.0.0.0/24" -NextHopType VirtualAppliance -NextHopIpAddress "10.0.1.5"

Routes                        Name                          Location                      Label
------                        ----                          --------                      -----
{approute}                    AppRT                         Central US                    Appliance Route Table

Эта команда создает таблицу маршрутов с именем ApplianceRouteTable в указанном расположении. Команда передает эту таблицу маршрутов текущему командлету. Текущий командлет добавляет маршрут с именем ApplianceRoute03, который является типом следующего прыжка VirtualAppliance. Команда задает IP-адрес следующего прыжка и префикс адреса для маршрута.

Пример 2. Добавление маршрута следующего прыжка в Интернете

PS C:\> Get-AzureRouteTable -Name "ApplianceRouteTable" | Set-AzureRoute -RouteName "InternetRoute" -AddressPrefix "0.0.0.0/0" -NextHopType Internet

Routes                        Name                          Location                      Label
------                        ----                          --------                      -----
{approute, internetroute}     AppRT                         Central US                    Appliance Route Table

Эта команда получает таблицу маршрутов с именем ApplianceRouteTable. Команда передает эту таблицу маршрутов текущему командлету. Текущий командлет добавляет маршрут с именем InternetRoute, который является типом следующего прыжка в Интернете. Команда задает префикс адреса для маршрута.

Параметры

-AddressPrefix

Задает префикс адреса для нового маршрута.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NextHopIpAddress

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NextHopType

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

  • VPNGateway
  • VNETLocal
  • Интернет
  • VirtualAppliance
  • Null
Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Profile

Указывает профиль Azure, из которого считывается этот командлет. Если профиль не указан, этот командлет считывается из локального профиля по умолчанию.

Тип:AzureSMProfile
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RouteName

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

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RouteTable

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

Тип:IRouteTable
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False