共用方式為


Add-AzExpressRouteCircuitAuthorization

新增 ExpressRoute 線路授權。

語法

Default (預設值)

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

Description

Add-AzExpressRouteCircuitAuthorization Cmdlet 會將授權新增至 ExpressRoute 線路。 ExpressRoute 線路會使用連線提供者,而不是公用因特網,將您的內部部署網路連線到 Microsoft 雲端。 ExpressRoute 線路的擁有者可以為每個線路建立多達 10 個授權;這些授權會產生授權金鑰,虛擬網路擁有者可以使用該金鑰將其網路連線到線路 (每個虛擬網路一個授權)。 Add-AzExpressRouteCircuitAuthorization 會將新的授權新增至線路,同時產生對應的授權金鑰。 您可以隨時執行 Get-AzExpressRouteCircuitAuthorization Cmdlet 來檢視這些金鑰,然後視需要複製並轉送給適當的網路擁有者。 請注意,執行 Add-AzExpressRouteCircuitAuthorization 之後,您必須呼叫 Set-AzExpressRouteCircuit Cmdlet 來啟用金鑰。 如果您未呼叫 Set-AzExpressRouteCircuit ,授權將會新增至線路,但不會啟用以供使用。

範例

範例 1:將授權新增至指定的 ExpressRoute 線路

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

此範例中的命令會將新的授權新增至現有的 ExpressRoute 線路。 第一個命令會使用 Get-AzExpressRouteCircuit 來建立名為 ContosoCircuit 之線路的物件參考。 該物件參照會儲存在名為 $Circuit 的變數中。 在第二個命令中, Add-AzExpressRouteCircuitAuthorization Cmdlet 可用來將新的授權 (ContosoCircuitAuthorization) 新增至 ExpressRoute 線路。 此命令新增授權,但不會啟用該授權。 啟用授權需要範例中最後一個命令中顯示的 Set-AzExpressRouteCircuit

參數

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

參數屬性

類型:IAzureContextContainer
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzContext, AzureRmContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ExpressRouteCircuit

指定此 Cmdlet 新增授權的 ExpressRoute 線路。

參數屬性

類型:PSExpressRouteCircuit
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

指定要新增的電路授權名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

PSExpressRouteCircuit

輸出

PSExpressRouteCircuit