Partager via

Get-AzureRmExpressRouteCircuitAuthorization

  • Référence
Module:
AzureRM.Network

Obtient des informations sur les autorisations 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

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

Description

L’applet de commande Get-AzureRmExpressRouteCircuitAuthorization obtient des informations sur les autorisations affectées à 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). Les clés d’autorisation, ainsi que d’autres informations sur l’autorisation, peuvent être consultées à tout moment en exécutant Get-AzureRmExpressRouteCircuitAuthorization.

Exemples

Exemple 1 : Obtenir toutes les autorisations ExpressRoute

$Circuit = Get-AzureRmExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
Get-AzureRmExpressRouteCircuitAuthorization -Circuit $Circuit

Ces commandes retournent des informations sur toutes les autorisations ExpressRoute associées à un circuit ExpressRoute. La première commande utilise l’applet de commande 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 la variable $Circuit. La deuxième commande utilise ensuite cette référence d’objet et l’applet de commande Get-AzureRmExpressRouteCircuitAuthorization pour retourner des informations sur les autorisations associées à ContosoCircuit.

Exemple 2 : Obtenir toutes les autorisations ExpressRoute à l’aide de l’applet de commande Where-Object

$Circuit = Get-AzureRmExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
 Get-AzureRmExpressRouteCircuitAuthorization -Circuit $Circuit | Where-Object {$_.AuthorizationUseStatus -eq "Available"}

Ces commandes représentent une variante des commandes utilisées dans l’exemple 1. Dans ce cas, toutefois, les informations sont retournées uniquement pour les autorisations disponibles pour une utilisation (c’est-à-dire pour les autorisations qui n’ont pas été affectées à un réseau virtuel). Pour ce faire, les informations d’autorisation du circuit sont retournées dans la commande 2 et sont redirigées vers l’applet de commande Where-Object . Where-Object sélectionne ensuite uniquement les autorisations où la propriété AuthorizationUseStatus est définie sur Available. Pour répertorier uniquement les autorisations qui ne sont pas disponibles, utilisez cette syntaxe pour la clause Where : {$_.AuthorizationUseStatus -ne "Available"}

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 l’autorisation du circuit ExpressRoute.

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 du circuit ExpressRoute que cette applet de commande obtient. -Name « ContosoCircuitAuthorization »

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

Entrées

PSExpressRouteCircuit

Paramètres : ExpressRouteCircuit (ByValue)

Sorties

PSExpressRouteCircuitAuthorization