Share 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>
   -Kind <Kind>
   -Location <String>
   [-SubscriptionId <String>]
   [-DirectConnection <IDirectConnection[]>]
   [-DirectPeerAsnId <String>]
   [-DirectPeeringType <DirectPeeringType>]
   [-ExchangeConnection <IExchangeConnection[]>]
   [-ExchangePeerAsnId <String>]
   [-PeeringLocation <String>]
   [-Sku <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-Confirm]
   [-WhatIf]
   [<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.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required: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.

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

-DirectPeerAsnId

O identificador do recurso referenciado.

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

-DirectPeeringType

O tipo de emparelhamento direto.

Type:DirectPeeringType
Position:Named
Default value:None
Required: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.

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

-ExchangePeerAsnId

O identificador do recurso referenciado.

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

-Kind

O tipo de peering.

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

-Location

A localização do recurso.

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

-Name

O nome do emparelhamento.

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

-PeeringLocation

O local do emparelhamento.

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

-ResourceGroupName

O nome do grupo de recursos.

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

-Sku

O nome da SKU de emparelhamento.

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

-SubscriptionId

A ID da assinatura do Azure.

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

As marcas do recurso.

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

-WhatIf

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

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

Saídas

IPeering

Observações

ALIASES

PROPRIEDADES DE PARÂMETROS COMPLEXOS

Para criar os parâmetros descritos abaixo, construa uma tabela de hash contendo as propriedades apropriadas. Para obter informações sobre tabelas de hash, execute Get-Help about_Hash_Tables.

DIRECTCONNECTION <IDirectConnection[]>: O conjunto de conexões que constituem um emparelhamento direto.

  • [BandwidthInMbps <Int32?>]: A largura de banda da conexão.
  • [BgpSessionMaxPrefixesAdvertisedV4 <Int32?>]: O número máximo de prefixos anunciados na sessão IPv4.
  • [BgpSessionMaxPrefixesAdvertisedV6 <Int32?>]: O número máximo de prefixos anunciados na sessão IPv6.
  • [BgpSessionMd5AuthenticationKey <String>]: A chave de autenticação MD5 da sessão.
  • [BgpSessionMicrosoftSessionIPv4Address <String>]: O endereço da sessão IPv4 no final da Microsoft.
  • [BgpSessionMicrosoftSessionIPv6Address <String>]: O endereço da sessão IPv6 no final da Microsoft.
  • [BgpSessionPeerSessionIPv4Address <String>]: O endereço da sessão IPv4 na extremidade do peer.
  • [BgpSessionPeerSessionIPv6Address <String>]: O endereço da sessão IPv6 na extremidade do peer.
  • [BgpSessionPrefixV4 <String>]: O prefixo IPv4 que contém os endereços IPv4 de ambas as extremidades.
  • [BgpSessionPrefixV6 <String>]: O prefixo IPv6 que contém os endereços IPv6 de ambas as extremidades.
  • [ConnectionIdentifier <String>]: O identificador exclusivo (GUID) para a conexão.
  • [PeeringDbFacilityId <Int32?>]: O ID de PeeringDB.com do recurso no qual a conexão deve ser configurada.
  • [SessionAddressProvider <SessionAddressProvider?>]: O campo que indica se a Microsoft fornece endereços IP de sessão.
  • [UseForPeeringService <Boolean?>]: O sinalizador que indica se a conexão é ou não usada para o serviço de emparelhamento.

EXCHANGECONNECTION <IExchangeConnection[]>: O conjunto de conexões que constituem um emparelhamento de troca.

  • [BgpSessionMaxPrefixesAdvertisedV4 <Int32?>]: O número máximo de prefixos anunciados na sessão IPv4.
  • [BgpSessionMaxPrefixesAdvertisedV6 <Int32?>]: O número máximo de prefixos anunciados na sessão IPv6.
  • [BgpSessionMd5AuthenticationKey <String>]: A chave de autenticação MD5 da sessão.
  • [BgpSessionMicrosoftSessionIPv4Address <String>]: O endereço da sessão IPv4 no final da Microsoft.
  • [BgpSessionMicrosoftSessionIPv6Address <String>]: O endereço da sessão IPv6 no final da Microsoft.
  • [BgpSessionPeerSessionIPv4Address <String>]: O endereço da sessão IPv4 na extremidade do peer.
  • [BgpSessionPeerSessionIPv6Address <String>]: O endereço da sessão IPv6 na extremidade do peer.
  • [BgpSessionPrefixV4 <String>]: O prefixo IPv4 que contém os endereços IPv4 de ambas as extremidades.
  • [BgpSessionPrefixV6 <String>]: O prefixo IPv6 que contém os endereços IPv6 de ambas as extremidades.
  • [ConnectionIdentifier <String>]: O identificador exclusivo (GUID) para a conexão.
  • [PeeringDbFacilityId <Int32?>]: O ID de PeeringDB.com do recurso no qual a conexão deve ser configurada.