Udostępnij przez

Get-AzExpressRouteCircuitAuthorization

  • Odwołanie
Moduł:
Az.Network

Pobiera informacje o autoryzacjach obwodów usługi ExpressRoute.

Składnia

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

Opis

Polecenie cmdlet Get-AzExpressRouteCircuitAuthorization pobiera informacje o autoryzacjach przypisanych do obwodu usługi ExpressRoute. Obwody usługi ExpressRoute łączą sieć lokalną z chmurą firmy Microsoft przy użyciu dostawcy łączności zamiast publicznego Internetu. Właściciel obwodu usługi ExpressRoute może utworzyć aż 10 autoryzacji dla każdego obwodu; te autoryzacje generują klucz autoryzacji, który może być używany przez właściciela sieci wirtualnej do łączenia sieci z obwodem (jedna autoryzacja na sieć wirtualną). Klucze autoryzacji, a także inne informacje o autoryzacji, można wyświetlić w dowolnym momencie, uruchamiając polecenie Get-AzExpressRouteCircuitAuthorization.

Przykłady

Przykład 1. Pobieranie wszystkich autoryzacji usługi ExpressRoute

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

Te polecenia zwracają informacje o wszystkich autoryzacjach usługi ExpressRoute skojarzonych z obwodem usługi ExpressRoute. Pierwsze polecenie używa polecenia cmdlet Get-AzExpressRouteCircuit do utworzenia obiektu odwołującego się do obwodu o nazwie ContosoCircuit; odwołanie do tego obiektu jest przechowywane w zmiennej $Circuit. Drugie polecenie następnie używa odwołania do tego obiektu i polecenia cmdlet Get-AzExpressRouteCircuitAuthorization w celu zwrócenia informacji o autoryzacjach skojarzonych z contosoCircuit.

Przykład 2. Pobieranie wszystkich autoryzacji usługi ExpressRoute przy użyciu polecenia cmdlet Where-Object

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

Te polecenia reprezentują odmianę poleceń używanych w przykładzie 1. W takim przypadku jednak informacje są zwracane tylko dla tych autoryzacji, które są dostępne do użycia (czyli dla autoryzacji, które nie zostały przypisane do sieci wirtualnej). W tym celu informacje o autoryzacji obwodu są zwracane w poleceniu 2 i są przesyłane potokowo do polecenia cmdlet Where-Object . Where-Object następnie wybiera tylko te autoryzacje, w których właściwość AuthorizationUseStatus jest ustawiona na Wartość Dostępna. Aby wyświetlić listę tylko tych autoryzacji, które nie są dostępne, użyj tej składni dla klauzuli Where: {$_.AuthorizationUseStatus -ne "Available"}

Parametry

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

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

-ExpressRouteCircuit

Określa autoryzację obwodu usługi ExpressRoute.

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

-Name

Określa nazwę autoryzacji obwodu usługi ExpressRoute pobieraną przez to polecenie cmdlet. -Name "ContosoCircuitAuthorization"

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

Dane wejściowe

PSExpressRouteCircuit

Dane wyjściowe

PSExpressRouteCircuitAuthorization