你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Add-AzExpressRouteCircuitAuthorization
添加 ExpressRoute 线路授权。
语法
Add-AzExpressRouteCircuitAuthorization
-Name <String>
-ExpressRouteCircuit <PSExpressRouteCircuit>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
说明
Add-AzExpressRouteCircuitAuthorization cmdlet 向 ExpressRoute 线路添加授权。 ExpressRoute 线路使用连接提供商而不是公共 Internet 将本地网络连接到 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 |
别名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ExpressRouteCircuit
指定此 cmdlet 将授权添加到的 ExpressRoute 线路。
类型: | PSExpressRouteCircuit |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-Name
指定要添加的线路授权的名称。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |