Udostępnij za pośrednictwem

Get-AzureRmExpressRouteCircuitAuthorization

  • Odwołanie
Moduł:
AzureRM.Network

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

Ostrzeżenie

Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

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

Opis

Polecenie cmdlet Get-AzureRmExpressRouteCircuitAuthorization 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-AzureRmExpressRouteCircuitAuthorization.

Przykłady

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

$Circuit = Get-AzureRmExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
Get-AzureRmExpressRouteCircuitAuthorization -Circuit $Circuit

Te polecenia zwracają informacje o wszystkich autoryzacjach usługi ExpressRoute skojarzonych z obwodem usługi ExpressRoute. Pierwsze polecenie używa polecenia cmdlet Get-AzureRmExpressRouteCircuit 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-AzureRmExpressRouteCircuitAuthorization 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-AzureRmExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
 Get-AzureRmExpressRouteCircuitAuthorization -Circuit $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.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ExpressRouteCircuit

Określa autoryzację obwodu usługi ExpressRoute.

Typ:PSExpressRouteCircuit
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PSExpressRouteCircuit

Parametry: ExpressRouteCircuit (ByValue)

Dane wyjściowe

PSExpressRouteCircuitAuthorization