Get-AzExpressRouteCircuitAuthorization

  • Referenz
Modul:
Az.Network

Ruft Informationen zu ExpressRoute-Schaltkreisautorisierungen ab.

Syntax

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

Beschreibung

Das Cmdlet Get-AzExpressRouteCircuitAuthorization ruft Informationen zu den Autorisierungen ab, die einem ExpressRoute-Schaltkreis zugewiesen sind. ExpressRoute-Schaltkreise verbinden Ihr lokales Netzwerk mit der Microsoft-Cloud, indem sie einen Konnektivitätsanbieter anstelle des öffentlichen Internets verwenden. Der Besitzer eines ExpressRoute-Schaltkreises kann bis zu 10 Autorisierungen für jeden Schaltkreis erstellen; Diese Autorisierungen generieren einen Autorisierungsschlüssel, der von einem virtuellen Netzwerkbesitzer verwendet werden kann, um sein Netzwerk mit dem Schaltkreis (eine Autorisierung pro virtuellem Netzwerk) zu verbinden. Autorisierungsschlüssel sowie weitere Informationen zur Autorisierung können jederzeit angezeigt werden, indem Get-AzExpressRouteCircuitAuthorization ausgeführt wird.

Beispiele

Beispiel 1: Abrufen aller ExpressRoute-Autorisierungen

$Circuit = Get-AzExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
Get-AzExpressRouteCircuitAuthorization -ExpressRouteCircuit $Circuit

Diese Befehle geben Informationen zu allen ExpressRoute-Autorisierungen zurück, die einem ExpressRoute-Schaltkreis zugeordnet sind. Der erste Befehl verwendet das Cmdlet Get-AzExpressRouteCircuit , um einen Objektverweis auf einen Schaltkreis namens ContosoCircuit zu erstellen. Dieser Objektverweis wird in der Variablen $Circuit gespeichert. Der zweite Befehl verwendet dann diesen Objektverweis und das Cmdlet Get-AzExpressRouteCircuitAuthorization , um Informationen zu den Autorisierungen zurückzugeben, die ContosoCircuit zugeordnet sind.

Beispiel 2: Abrufen aller ExpressRoute-Autorisierungen mithilfe des Where-Object-Cmdlets

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

Diese Befehle stellen eine Variation der befehle dar, die in Beispiel 1 verwendet werden. In diesem Fall werden jedoch nur Informationen für die Autorisierungen zurückgegeben, die zur Verwendung verfügbar sind (d. a. für Autorisierungen, die keinem virtuellen Netzwerk zugewiesen wurden). Hierzu werden die Schaltkreisautorisierungsinformationen in Befehl 2 zurückgegeben und an das Where-Object-Cmdlet weitergeleitet. Where-Object wählt dann nur die Autorisierungen aus, bei denen die AuthorizationUseStatus-Eigenschaft auf "Available" festgelegt ist. Wenn Sie nur die nicht verfügbaren Autorisierungen auflisten möchten, verwenden Sie diese Syntax für die Where-Klausel: {$_.AuthorizationUseStatus -ne "Available"}

Parameter

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpressRouteCircuit

Gibt die ExpressRoute-Schaltkreisautorisierung an.

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

-Name

Gibt den Namen der ExpressRoute-Schaltkreisautorisierung an, die dieses Cmdlet abruft. -Name "ContosoCircuitAuthorization"

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

Eingaben

PSExpressRouteCircuit

Ausgaben

PSExpressRouteCircuitAuthorization