Get-AzExpressRouteCircuitAuthorization
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.
Typ: | IAzureContextContainer |
Aliase: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ExpressRouteCircuit
Gibt die ExpressRoute-Schaltkreisautorisierung an.
Typ: | PSExpressRouteCircuit |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Name
Gibt den Namen der ExpressRoute-Schaltkreisautorisierung an, die dieses Cmdlet abruft. -Name "ContosoCircuitAuthorization"
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Eingaben
Ausgaben
PSExpressRouteCircuitAuthorization