Partager via

Set-AzureRoute

  • Référence
Module:
Azure

Crée un itinéraire dans une table de routage.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

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

Description

L’applet de commande Set-AzureRoute crée un itinéraire dans une table de routage. La nouvelle route prend effet presque immédiatement sur les machines virtuelles associées à la table de routage.

Exemples

Exemple 1 : Ajouter un itinéraire de tronçon suivant de l’appliance virtuelle

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

Cette commande crée une table de routage nommée ApplianceRouteTable à l’emplacement spécifié. La commande transmet cette table de routage à l’applet de commande actuelle. L’applet de commande actuelle ajoute un itinéraire nommé ApplianceRoute03, qui est un type de tronçon suivant VirtualAppliance. La commande spécifie l’adresse IP du tronçon suivant et le préfixe d’adresse de l’itinéraire.

Exemple 2 : Ajouter un itinéraire de tronçon suivant 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

Cette commande obtient une table de routage nommée ApplianceRouteTable. La commande transmet cette table de routage à l’applet de commande actuelle. L’applet de commande actuelle ajoute un itinéraire nommé InternetRoute, qui est un type de tronçon suivant Internet. La commande spécifie le préfixe d’adresse de l’itinéraire.

Paramètres

-AddressPrefix

Spécifie un préfixe d’adresse pour le nouvel itinéraire.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NextHopIpAddress

Spécifie l’adresse IP de l’appliance qui est le tronçon suivant pour le trafic qui utilise cet itinéraire. Spécifiez cette valeur uniquement si vous spécifiez une valeur de VirtualAppliance pour le paramètre NextHopType .

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NextHopType

Spécifie le type de tronçon suivant pour le trafic qui utilise cet itinéraire. Les valeurs valides sont :

  • VPNGateway
  • VNETLocal
  • Internet
  • VirtualAppliance
  • Null
Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

Type:AzureSMProfile
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RouteName

Spécifie un nom pour la nouvelle route que cette applet de commande ajoute.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RouteTable

Spécifie la table de routage à laquelle cette applet de commande ajoute le nouvel itinéraire.

Type:IRouteTable
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False