Partager via


Add-AzureRmExpressRouteCircuitAuthorization

Ajoute une autorisation de circuit ExpressRoute.

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

Add-AzureRmExpressRouteCircuitAuthorization
   -Name <String>
   -ExpressRouteCircuit <PSExpressRouteCircuit>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Add-AzureRmExpressRouteCircuitAuthorization ajoute une autorisation à un circuit ExpressRoute. Les circuits ExpressRoute connectent votre réseau local au cloud Microsoft à l’aide d’un fournisseur de connectivité au lieu d’Internet public. Le propriétaire d’un circuit ExpressRoute peut créer autant de 10 autorisations pour chaque circuit ; ces autorisations génèrent une clé d’autorisation qui peut être utilisée par un propriétaire de réseau virtuel pour connecter son réseau au circuit (une autorisation par réseau virtuel). Add-AzureRmExpressRouteCircuitAuthorization ajoute une nouvelle autorisation à un circuit et, en même temps, génère la clé d’autorisation correspondante. Ces clés peuvent être consultées à tout moment en exécutant l’applet de commande Get-AzureRmExpressRouteClientAuthorization et, si nécessaire, peuvent ensuite être copiées et transférées au propriétaire du réseau approprié. Notez que, après avoir exécuté Add-AzureRmExpressRouteCircuitAuthorization, vous devez appeler l’applet de commande Set-AzureRmExpressRouteCircuit pour activer la clé. Si vous n’appelez pas Set-AzureRmExpressRouteCircuit , l’autorisation est ajoutée au circuit, mais n’est pas activée pour une utilisation.

Exemples

Exemple 1 : Ajouter une autorisation au circuit ExpressRoute spécifié

$Circuit = Get-AzureRmExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
Add-AzureRmExpressRouteCircuitAuthorization -Name "ContosoCircuitAuthorization" -Circuit $Circuit
Set-AzureRmExpressRouteCircuit -ExpressRouteCircuit $Circuit

Les commandes de cet exemple ajoutent une nouvelle autorisation à un circuit ExpressRoute existant. La première commande utilise Get-AzureRmExpressRouteCircuit pour créer une référence d’objet à un circuit nommé ContosoCircuit. Cette référence d’objet est stockée dans une variable nommée $Circuit. Dans la deuxième commande, l’applet de commande Add-AzureRmExpressRouteCircuitAuthorization est utilisée pour ajouter une nouvelle autorisation (ContosoCircuitAuthorization) au circuit ExpressRoute. Cette commande ajoute l’autorisation, mais n’active pas cette autorisation. L’activation d’une autorisation nécessite l’affichage Set-AzureRmExpressRouteCircuit dans la commande finale de l’exemple.

Paramètres

-DefaultProfile

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

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

-ExpressRouteCircuit

Spécifie le circuit ExpressRoute auquel cette applet de commande ajoute l’autorisation.

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

-Name

Spécifie le nom de l’autorisation de circuit à ajouter.

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

Entrées

PSExpressRouteCircuit

Paramètres : ExpressRouteCircuit (ByValue)

Sorties

PSExpressRouteCircuit