Set-AzureRoute
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 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-RouteName
Określa nazwę nowej trasy, którą dodaje to polecenie cmdlet.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-RouteTable
Określa tabelę tras, do której to polecenie cmdlet dodaje nową trasę.
Typ: | IRouteTable |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |