Freigeben über

Set-AzureRoute

  • Referenz
Modul:
Azure

Erstellt eine Route in einer Routentabelle.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

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

Beschreibung

Das Cmdlet Set-AzureRoute erstellt eine Route in einer Routentabelle. Die neue Route wird fast sofort auf den virtuellen Computern wirksam, die der Routentabelle zugeordnet sind.

Beispiele

Beispiel 1: Hinzufügen einer virtuellen Appliance für die nächste Hoproute

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

Mit diesem Befehl wird eine Routetabelle namens ApplianceRouteTable an dem angegebenen Speicherort erstellt. Der Befehl übergibt diese Routingtabelle an das aktuelle Cmdlet. Das aktuelle Cmdlet fügt eine Route namens ApplianceRoute03 hinzu, bei der es sich um einen virtualAppliance-Nächsten Hoptyp handelt. Der Befehl gibt die nächste Hop-IP-Adresse und das Adresspräfix für die Route an.

Beispiel 2: Hinzufügen einer nächsten Hoproute für das Internet

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

Dieser Befehl ruft eine Routentabelle namens ApplianceRouteTable ab. Der Befehl übergibt diese Routingtabelle an das aktuelle Cmdlet. Das aktuelle Cmdlet fügt eine Route namens InternetRoute hinzu, bei der es sich um einen nächsten Hoptyp für das Internet handelt. Der Befehl gibt das Adresspräfix für die Route an.

Parameter

-AddressPrefix

Gibt ein Adresspräfix für die neue Route an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NextHopIpAddress

Gibt die IP-Adresse der Appliance an, bei der es sich um den nächsten Hop für Datenverkehr handelt, der diese Route verwendet. Geben Sie diesen Wert nur an, wenn Sie einen Wert von VirtualAppliance für den Parameter NextHopType angeben.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NextHopType

Gibt den nächsten Hoptyp für Datenverkehr an, der diese Route verwendet. Gültige Werte sind:

  • VPNGateway
  • VNETLocal
  • Internet
  • VirtualAppliance
  • Null
Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RouteName

Gibt einen Namen für die neue Route an, die dieses Cmdlet hinzufügt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RouteTable

Gibt die Routentabelle an, der dieses Cmdlet die neue Route hinzufügt.

Typ:IRouteTable
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False