Dela via


Get-AzureRmExpressRouteCircuitAuthorization

Hämtar information om ExpressRoute-kretsauktoriseringar.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

Syntax

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

Description

Cmdleten Get-AzureRmExpressRouteCircuitAuthorization hämtar information om de auktoriseringar som tilldelats till en ExpressRoute-krets. ExpressRoute-kretsar ansluter ditt lokala nätverk till Microsoft-molnet med hjälp av en anslutningsleverantör i stället för det offentliga Internet. Ägaren till en ExpressRoute-krets kan skapa så många som 10 auktoriseringar för varje krets. dessa auktoriseringar genererar en auktoriseringsnyckel som kan användas av en virtuell nätverksägare för att ansluta sitt nätverk till kretsen (en auktorisering per virtuellt nätverk). Auktoriseringsnycklar och annan information om auktoriseringen kan visas när som helst genom att köra Get-AzureRmExpressRouteCircuitAuthorization.

Exempel

Exempel 1: Hämta alla ExpressRoute-auktoriseringar

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

Dessa kommandon returnerar information om alla ExpressRoute-auktoriseringar som är associerade med en ExpressRoute-krets. Det första kommandot använder cmdleten Get-AzureRmExpressRouteCircuit för att skapa en objektreferens till en krets med namnet ContosoCircuit. Objektreferensen lagras i variabeln $Circuit. Det andra kommandot använder sedan objektreferensen och cmdleten Get-AzureRmExpressRouteCircuitAuthorization för att returnera information om de auktoriseringar som är associerade med ContosoCircuit.

Exempel 2: Hämta alla ExpressRoute-auktoriseringar med hjälp av cmdleten Where-Object

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

Dessa kommandon representerar en variant av kommandona som används i exempel 1. I det här fallet returneras dock endast information för de auktoriseringar som är tillgängliga för användning (d.v.s. för auktoriseringar som inte har tilldelats till ett virtuellt nätverk). För att göra detta returneras informationen om kretsauktorisering i kommando 2 och skickas till cmdleten Where-Object . Where-Object väljer sedan endast ut de auktoriseringar där egenskapen AuthorizationUseStatus är inställd på Tillgänglig. Om du bara vill visa de auktoriseringar som inte är tillgängliga använder du den här syntaxen för Where-satsen: {$_.AuthorizationUseStatus -ne "Available"}

Parametrar

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpressRouteCircuit

Anger ExpressRoute-kretsauktorisering.

Typ:PSExpressRouteCircuit
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Anger namnet på den ExpressRoute-kretsauktorisering som den här cmdleten hämtar. -Namn "ContosoCircuitAuthorization"

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

PSExpressRouteCircuit

Parametrar: ExpressRouteCircuit (ByValue)

Utdata

PSExpressRouteCircuitAuthorization