Freigeben über


Get-AzExpressRouteCircuitAuthorization

Ruft Informationen zu ExpressRoute-Schaltkreisautorisierungen ab.

Syntax

Default (Standard)

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 cmdlets Where-Object

$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.

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ExpressRouteCircuit

Gibt die ExpressRoute-Schaltkreisautorisierung an.

Parametereigenschaften

Typ:PSExpressRouteCircuit
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

PSExpressRouteCircuit

Ausgaben

PSExpressRouteCircuitAuthorization