New-AzPeering

模組:

Az.Peering

建立新的對等互連，或更新具有指定訂用帳戶和資源群組下指定名稱的現有對等互連。

Syntax

New-AzPeering
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Kind <Kind>
   -Location <String>
   [-DirectConnection <IDirectConnection[]>]
   [-DirectPeerAsnId <String>]
   [-DirectPeeringType <DirectPeeringType>]
   [-ExchangeConnection <IExchangeConnection[]>]
   [-ExchangePeerAsnId <String>]
   [-PeeringLocation <String>]
   [-Sku <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

建立新的對等互連，或更新具有指定訂用帳戶和資源群組下指定名稱的現有對等互連。

範例

範例 1：建立新的直接對等互連物件

$peerAsnId = "/subscriptions/{subId}/providers/Microsoft.Peering/peerAsns/ContosoEdgeTest"
$directConnections = New-AzPeeringDirectConnectionObject -BandwidthInMbps 10000 -BgpSessionMaxPrefixesAdvertisedV4 20000

New-AzPeering -Name TestPeeringPs -ResourceGroupName DemoRG -Kind Direct -Location "South Central US" -DirectConnection $directConnections -DirectPeeringType Cdn -DirectPeerAsnId $peerAsnId -PeeringLocation Dallas -Sku Premium_Direct_Unlimited

Name        SkuName                  Kind   PeeringLocation ProvisioningState Location
----        -------                  ----   --------------- ----------------- --------
TestPeering Premium_Direct_Unlimited Direct Dallas          Succeeded         South Central US

建立新的直接對等互連物件

參數

-Confirm

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

類型:	SwitchParameter
Aliases:	cf
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

DefaultProfile 參數無法運作。 如果針對不同的訂用帳戶執行 Cmdlet，請使用 SubscriptionId 參數。

類型:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DirectConnection

構成直接對等互連的連線集。 若要建構，請參閱 DIRECTCONNECTION 屬性的 NOTES 區段並建立哈希表。

類型:	IDirectConnection[]
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DirectPeerAsnId

參考資源的標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DirectPeeringType

直接對等互連的類型。

類型:	DirectPeeringType
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExchangeConnection

構成交換對等互連的連線集。 若要建構，請參閱 EXCHANGECONNECTION 屬性的 NOTES 區段並建立哈希表。

類型:	IExchangeConnection[]
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExchangePeerAsnId

參考資源的標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Kind

對等互連的種類。

類型:	Kind
Position:	Named
預設值:	None
必要:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

資源的位置。

類型:	String
Position:	Named
預設值:	None
必要:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

對等互連的名稱。

類型:	String
Aliases:	PeeringName
Position:	Named
預設值:	None
必要:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PeeringLocation

對等互連的位置。

類型:	String
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

資源群組的名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Sku

對等互連 SKU 的名稱。

類型:	String
Aliases:	SkuName
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

Azure 訂閱識別碼。

類型:	String
Position:	Named
預設值:	(Get-AzContext).Subscription.Id
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

資源標記。

類型:	Hashtable
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

類型:	SwitchParameter
Aliases:	wi
Position:	Named
預設值:	None
必要:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸出

IPeering