New-AzExpressRouteCircuit

  • 參考
模組:
Az.Network

建立 Azure Express Route 線路。

Syntax

New-AzExpressRouteCircuit
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   [-SkuTier <String>]
   [-SkuFamily <String>]
   -ServiceProviderName <String>
   -PeeringLocation <String>
   -BandwidthInMbps <Int32>
   [-Peering <PSPeering[]>]
   [-Authorization <PSExpressRouteCircuitAuthorization[]>]
   [-AllowClassicOperations <Boolean>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzExpressRouteCircuit
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   [-SkuTier <String>]
   [-SkuFamily <String>]
   -ExpressRoutePort <PSExpressRoutePort>
   -BandwidthInGbps <Double>
   [-AuthorizationKey <String>]
   [-Peering <PSPeering[]>]
   [-Authorization <PSExpressRouteCircuitAuthorization[]>]
   [-AllowClassicOperations <Boolean>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzExpressRouteCircuit Cmdlet 會建立 Azure Express Route 線路。

範例

範例 1：建立新的 ExpressRoute 線路

$parameters = @{
    Name='ExpressRouteCircuit'
    ResourceGroupName='ExpressRouteResourceGroup'
    Location='West US'
    SkuTier='Standard'
    SkuFamily='MeteredData'
    ServiceProviderName='Equinix'
    PeeringLocation='Silicon Valley'
    BandwidthInMbps=200
}
New-AzExpressRouteCircuit @parameters

範例 2：在 ExpressRoutePort 上建立新的 ExpressRoute 線路

$parameters = @{
    Name='ExpressRouteCircuit'
    ResourceGroupName='ExpressRouteResourceGroup'
    Location='West US'
    SkuTier='Standard'
    SkuFamily='MeteredData'
    ExpressRoutePort=$PSExpressRoutePort
    BandwidthInGbps=10.0
}
New-AzExpressRouteCircuit @parameters

參數

-AllowClassicOperations

使用此參數可讓您使用傳統 Azure PowerShell Cmdlet 來管理線路。

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AsJob

在背景執行 Cmdlet

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Authorization

線路授權清單。

Type:PSExpressRouteCircuitAuthorization[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AuthorizationKey

在不同訂用帳戶中的 ExpressRoutePort 資源上佈建線路時所使用的授權密鑰。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-BandwidthInGbps

在 ExpressRoutePort 資源上布建線路時線路的頻寬。

Type:Double
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-BandwidthInMbps

線路的頻寬。 這必須是服務提供者所支援的值。

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

執行 Cmdlet 之前先提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpressRoutePort

在 ExpressRoutePort 資源上布建線路時，ExpressRoutePort 資源的參考。

Type:PSExpressRoutePort
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Force

強制命令執行，而不要求使用者確認。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

線路的位置。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

要建立的 ExpressRoute 線路名稱。

Type:String
Aliases:ResourceName
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Peering

清單對等設定。

Type:PSPeering[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PeeringLocation

服務提供者支援的對等互連位置名稱。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

將包含線路的資源群組。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ServiceProviderName

線路服務提供者的名稱。 這必須符合 Get-AzExpressRouteServiceProvider Cmdlet 所列出的名稱。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SkuFamily

SKU 系列決定計費類型。 此參數的可能值為： MeteredData 或 UnlimitedData。 請注意，您可以將計費類型從 MeteredData 變更為 UnlimitedData，但無法將類型從 UnlimitedData 變更為 MeteredData。

Type:String
Accepted values:MeteredData, UnlimitedData
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SkuTier

線路的服務層級。 此參數的可能值為： Standard、 Premium 或 Local。

Type:String
Accepted values:Standard, Premium, Basic, Local
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Tag

哈希表形式的索引鍵/值組。 例如：@{key0=“value0”;key1=$null;key2=“value2”}

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

String

Int32

PSExpressRoutePort

Double

PSPeering[]

PSExpressRouteCircuitAuthorization[]

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Hashtable

輸出

PSExpressRouteCircuit