Udostępnij za pośrednictwem

Set-AzureRoute

  • Odwołanie
Moduł:
Azure

Tworzy trasę w tabeli tras.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

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

Opis

Polecenie cmdlet Set-AzureRoute tworzy trasę w tabeli tras. Nowa trasa zaczyna obowiązywać niemal natychmiast na maszynach wirtualnych skojarzonych z tabelą tras.

Przykłady

Przykład 1. Dodawanie trasy następnego przeskoku urządzenia wirtualnego

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

To polecenie tworzy tabelę tras o nazwie ApplianceRouteTable w określonej lokalizacji. Polecenie przekazuje tę tabelę tras do bieżącego polecenia cmdlet. Bieżące polecenie cmdlet dodaje trasę o nazwie ApplianceRoute03, która jest typem następnego przeskoku usługi VirtualAppliance. Polecenie określa adres IP następnego przeskoku i prefiks adresu dla trasy.

Przykład 2. Dodawanie trasy następnego przeskoku w Internecie

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

To polecenie pobiera tabelę tras o nazwie ApplianceRouteTable. Polecenie przekazuje tę tabelę tras do bieżącego polecenia cmdlet. Bieżące polecenie cmdlet dodaje trasę o nazwie InternetRoute, która jest typem następnego przeskoku internetowego. Polecenie określa prefiks adresu dla trasy.

Parametry

-AddressPrefix

Określa prefiks adresu dla nowej trasy.

Typ:String
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-NextHopIpAddress

Określa adres IP urządzenia, które jest następnym przeskoku dla ruchu korzystającego z tej trasy. Określ tę wartość tylko wtedy, gdy określisz wartość parametru VirtualAppliance dla parametru NextHopType .

Typ:String
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-NextHopType

Określa typ następnego przeskoku dla ruchu korzystającego z tej trasy. Prawidłowe wartości to:

  • VPNGateway
  • VNETLocal
  • Internet
  • VirtualAppliance
  • Null (zero)
Typ:String
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

Typ:AzureSMProfile
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-RouteName

Określa nazwę nowej trasy, którą dodaje to polecenie cmdlet.

Typ:String
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-RouteTable

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

Typ:IRouteTable
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False