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。