Get-AzExpressRouteCircuitAuthorization

  • Référence
Module:
Az.Network

Obtient des informations sur les autorisations de circuit ExpressRoute.

Syntax

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

Description

L’applet de commande Get-AzExpressRouteCircuitAuthorization 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-AzExpressRouteCircuitAuthorization.

Exemples

Exemple 1 : Obtenir toutes les autorisations ExpressRoute

$Circuit = Get-AzExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
Get-AzExpressRouteCircuitAuthorization -ExpressRouteCircuit $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-AzExpressRouteCircuit 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-AzExpressRouteCircuitAuthorization 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-AzExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
 Get-AzExpressRouteCircuitAuthorization -ExpressRouteCircuit $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
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpressRouteCircuit

Spécifie l’autorisation du circuit ExpressRoute.

Type:PSExpressRouteCircuit
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Spécifie le nom de l’autorisation du circuit ExpressRoute que cette applet de commande obtient. -Name « ContosoCircuitAuthorization »

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

PSExpressRouteCircuit

Sorties

PSExpressRouteCircuitAuthorization