< Back
New-AzureRmExpressRouteCircuitAuthorization
Post
NAME New-AzureRmExpressRouteCircuitAuthorization
SYNOPSIS
Creates an ExpressRoute circuit authorization.
SYNTAX
New-AzureRmExpressRouteCircuitAuthorization [-DefaultProfile <IAzureContextContainer>] -Name <String> [<CommonParameters>]
DESCRIPTION
The New-AzureRmExpressRouteCircuitAuthorization cmdlet creates a circuit authorization that can be added to an ExpressRoute circuit. ExpressRoute
circuits connect your on-premises network to the Microsoft cloud by using a connectivity provider instead of the public Internet. The owner of an
ExpressRoute circuit can create as many as 10 authorizations for each circuit; these authorizations generate an authorization key that can be used
by a virtual network owner to connect a network to the circuit. There can only one authorization per virtual network.
After you create an ExpressRoute circuit you can use Add-AzureRmExpressRouteCircuitAuthorization to add an authorization to that circuit.
Alternatively, you can use New-AzureRmExpressRouteCircuitAuthorization to create an authorization that can be added to a new circuit at the same
time the circuit is created.
PARAMETERS
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Name <String>
Specifies a unique name for the new ExpressRoute circuit authorization.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
This cmdlet does not accept pipelined input.
OUTPUTS
PSExpressRouteCircuitAuthorization
This cmdlet creates instances of the Microsoft.Azure.Commands.Network.Models.PSExpressRouteCircuitAuthorization object.
NOTES
Example 1: Create a new circuit authorization
$Authorization = New-AzureRmExpressRouteCircuitAuthorization -Name "ContosoCircuitAuthorization"
This command creates a new circuit authorization named ContosoCircuitAuthorization and then stores that object in a variable named $Authorization.
Saving the object to a variable is important: although New-AzureRmExpressRouteCircuitAuthorization can create a circuit authorization it cannot
add that authorization to a circuit route. Instead, the variable $Authorization is used New-AzureRmExpressRouteCircuit when creating a brand-new
ExpressRoute circuit.
For more information, see the documentation for the New-AzureRmExpressRouteCircuit cmdlet.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... horization
Add-AzureRmExpressRouteCircuitAuthorization
Get-AzureRmExpressRouteCircuitAuthorization
Remove-AzureRmExpressRouteCircuitAuthorization
SYNOPSIS
Creates an ExpressRoute circuit authorization.
SYNTAX
New-AzureRmExpressRouteCircuitAuthorization [-DefaultProfile <IAzureContextContainer>] -Name <String> [<CommonParameters>]
DESCRIPTION
The New-AzureRmExpressRouteCircuitAuthorization cmdlet creates a circuit authorization that can be added to an ExpressRoute circuit. ExpressRoute
circuits connect your on-premises network to the Microsoft cloud by using a connectivity provider instead of the public Internet. The owner of an
ExpressRoute circuit can create as many as 10 authorizations for each circuit; these authorizations generate an authorization key that can be used
by a virtual network owner to connect a network to the circuit. There can only one authorization per virtual network.
After you create an ExpressRoute circuit you can use Add-AzureRmExpressRouteCircuitAuthorization to add an authorization to that circuit.
Alternatively, you can use New-AzureRmExpressRouteCircuitAuthorization to create an authorization that can be added to a new circuit at the same
time the circuit is created.
PARAMETERS
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Name <String>
Specifies a unique name for the new ExpressRoute circuit authorization.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
This cmdlet does not accept pipelined input.
OUTPUTS
PSExpressRouteCircuitAuthorization
This cmdlet creates instances of the Microsoft.Azure.Commands.Network.Models.PSExpressRouteCircuitAuthorization object.
NOTES
Example 1: Create a new circuit authorization
$Authorization = New-AzureRmExpressRouteCircuitAuthorization -Name "ContosoCircuitAuthorization"
This command creates a new circuit authorization named ContosoCircuitAuthorization and then stores that object in a variable named $Authorization.
Saving the object to a variable is important: although New-AzureRmExpressRouteCircuitAuthorization can create a circuit authorization it cannot
add that authorization to a circuit route. Instead, the variable $Authorization is used New-AzureRmExpressRouteCircuit when creating a brand-new
ExpressRoute circuit.
For more information, see the documentation for the New-AzureRmExpressRouteCircuit cmdlet.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... horization
Add-AzureRmExpressRouteCircuitAuthorization
Get-AzureRmExpressRouteCircuitAuthorization
Remove-AzureRmExpressRouteCircuitAuthorization