New-AzRouteConfig

Module:
Az.Network Module

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

Syntaxe

Default (Par défaut) 

New-AzRouteConfig
    [-Name <String>]
    [-AddressPrefix <String>]
    [-NextHopType <String>]
    [-NextHopIpAddress <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

Description

L’applet de commande New-AzRouteConfig crée un itinéraire pour une table de routage Azure.

Exemples

Exemple 1 : Créer un itinéraire

$Route = New-AzRouteConfig -Name "Route07" -AddressPrefix 10.1.0.0/16 -NextHopType "VnetLocal"
$Route

Name              : Route07
Id                :
Etag              :
ProvisioningState :
AddressPrefix     : 10.1.0.0/16
NextHopType       : VnetLocal
NextHopIpAddress  :

La première commande crée un itinéraire nommé Route07, puis le stocke dans la variable $Route. Cet itinéraire transfère les paquets au réseau virtuel local. La deuxième commande affiche les propriétés de l’itinéraire.

Exemple 2

Crée un itinéraire pour une table de routage. (autogenerated)

New-AzRouteConfig -AddressPrefix 10.1.0.0/16 -Name 'Route07' -NextHopIpAddress '12.0.0.5' -NextHopType 'VnetLocal'

Exemple 3 : Créer un itinéraire avec une balise de service

New-AzRouteConfig -Name "Route07" -AddressPrefix "AppService" -NextHopType "VirtualAppliance" -NextHopIpAddress "10.0.2.4"

Cette commande crée un itinéraire nommé Route07 qui transfère le trafic vers les préfixes IP contenus dans la balise AppService Service vers une appliance virtuelle.

Paramètres

-AcquirePolicyToken

Acquérir automatiquement un jeton Azure Policy pour cette opération de ressource.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AddressPrefix

Spécifie la destination, au format CIDR (Classless Interdomain Routing), à laquelle l’itinéraire s’applique. Vous pouvez également spécifier une balise de service ici (cette fonctionnalité est disponible en préversion publique).

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ChangeReference

ID de ressource de référence de modification pour cette opération de ressource.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

Spécifie un nom pour l’itinéraire.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-NextHopIpAddress

Spécifie l’adresse IP du tronçon suivant vers laquelle cette route transfère les paquets. Pour un NextHopType de VirtualAppliance, fournissez une adresse IP unique d’une appliance virtuelle que vous ajoutez à votre réseau virtuel Azure. Pour un NextHopType de VirtualApplianceEcmp, fournissez entre 2 et 64 adresses IP pour équilibrer la charge du trafic à l’aide du routage ECMP (Equal-Cost Multi-Path).

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-NextHopType

Spécifie la façon dont cet itinéraire transfère les paquets. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Internet. Passerelle Internet par défaut fournie par Azure.
  • None. Si vous spécifiez cette valeur, l’itinéraire ne transfère pas les paquets.
  • VirtualAppliance. Appliance virtuelle que vous ajoutez à votre réseau virtuel Azure.
  • VirtualApplianceEcmp. Plusieurs appliances virtuelles dont le trafic est équilibré en charge à l’aide du routage ECMP (Equal-Cost Multi-Path). Fournissez les adresses IP de l’appliance via le paramètre NextHopIpAddress .
  • VirtualNetworkGateway. Passerelle de réseau privé virtuel de serveur à serveur Azure.
  • VnetLocal. Réseau virtuel local. Si vous avez deux sous-réseaux, 10.1.0.0/16 et 10.2.0.0/16 dans le même réseau virtuel, sélectionnez une valeur de VnetLocal pour chaque sous-réseau à transférer vers l’autre sous-réseau.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Sorties

PSRoute