New-AzureRmExpressRouteCircuitAuthorization
建立 ExpressRoute 線路授權。
警告
自 2024 年 2 月 29 日起,AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組,以確保持續支援和更新。
雖然 AzureRM 模組可能仍可運作,但不再維護或支援它,但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引,請參閱我們的 移轉資源 。
語法
New-AzureRmExpressRouteCircuitAuthorization
-Name <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
New-AzureRmExpressRouteCircuitAuthorization Cmdlet 會建立可新增至 ExpressRoute 線路的線路授權。 ExpressRoute 線路會使用連線提供者,而不是公用因特網,將內部部署網路連線到Microsoft雲端。 ExpressRoute 線路的擁有者可以為每個線路建立多達 10 個授權;這些授權會產生一個授權密鑰,可供虛擬網路擁有者用來將網路連線到線路。 每個虛擬網路只能有一個授權。 建立 ExpressRoute 線路之後,您可以使用 Add-AzureRmExpressRouteCircuitAuthorization 將授權新增至該線路。 或者,您可以使用 New-AzureRmExpressRouteCircuitAuthorization 來建立可在建立線路時新增至新線路的授權。
範例
範例 1:建立新的線路授權
$Authorization = New-AzureRmExpressRouteCircuitAuthorization -Name "ContosoCircuitAuthorization"
此命令會建立名為 ContosoCircuitAuthorization 的新線路授權,然後將該物件儲存在名為 $Authorization 的變數中。 將物件儲存至變數很重要:雖然 New-AzureRmExpressRouteCircuitAuthorization 可以建立線路授權,但無法將該授權新增至線路路由。 相反地,$Authorization變數會在建立全新的 ExpressRoute 線路時使用 New-AzureRmExpressRouteCircuit。 如需詳細資訊,請參閱 New-AzureRmExpressRouteCircuit Cmdlet 的檔。
參數
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
類型: | IAzureContextContainer |
別名: | AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Name
指定新 ExpressRoute 線路授權的唯一名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
None
輸出
PSExpressRouteCircuitAuthorization