Compartilhar via


New-AzPeering

Cria um novo emparelhamento ou atualiza um emparelhamento existente com o nome especificado na assinatura e no grupo de recursos especificados.

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

Cria um novo emparelhamento ou atualiza um emparelhamento existente com o nome especificado na assinatura e no grupo de recursos especificados.

Exemplos

Exemplo 1: Criar um novo objeto de emparelhamento direto

$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

Criar um novo objeto de emparelhamento direto

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

O parâmetro DefaultProfile não está funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Tipo:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-DirectConnection

O conjunto de conexões que constituem um emparelhamento direto. Para construir, consulte a seção NOTAS para propriedades DIRECTCONNECTION e crie uma tabela de hash.

Tipo:IDirectConnection[]
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-DirectPeerAsnId

O identificador do recurso referenciado.

Tipo:String
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-DirectPeeringType

O tipo de emparelhamento direto.

Tipo:DirectPeeringType
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-ExchangeConnection

O conjunto de conexões que constituem um emparelhamento de troca. Para construir, consulte a seção NOTAS para propriedades EXCHANGECONNECTION e crie uma tabela de hash.

Tipo:IExchangeConnection[]
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-ExchangePeerAsnId

O identificador do recurso referenciado.

Tipo:String
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-Kind

O tipo de peering.

Tipo:Kind
Position:Named
valor padrão:None
Obrigatório:True
Accept pipeline input:False
Accept wildcard characters:False

-Location

A localização do recurso.

Tipo:String
Position:Named
valor padrão:None
Obrigatório:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

O nome do emparelhamento.

Tipo:String
Aliases:PeeringName
Position:Named
valor padrão:None
Obrigatório:True
Accept pipeline input:False
Accept wildcard characters:False

-PeeringLocation

O local do emparelhamento.

Tipo:String
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

O nome do grupo de recursos.

Tipo:String
Position:Named
valor padrão:None
Obrigatório:True
Accept pipeline input:False
Accept wildcard characters:False

-Sku

O nome da SKU de emparelhamento.

Tipo:String
Aliases:SkuName
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

A ID da assinatura do Azure.

Tipo:String
Position:Named
valor padrão:(Get-AzContext).Subscription.Id
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

As marcas do recurso.

Tipo:Hashtable
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

Saídas

IPeering