Condividi tramite

Add-AzExpressRouteCircuitPeeringConfig

  • Riferimento
Modulo:
Az.Network

Aggiunge una configurazione di peering a un circuito ExpressRoute.

Sintassi

Add-AzExpressRouteCircuitPeeringConfig
   -Name <String>
   -ExpressRouteCircuit <PSExpressRouteCircuit>
   -PeeringType <String>
   -PeerASN <UInt32>
   -PrimaryPeerAddressPrefix <String>
   -SecondaryPeerAddressPrefix <String>
   -VlanId <Int32>
   [-SharedKey <String>]
   [-MicrosoftConfigAdvertisedPublicPrefixes <String[]>]
   [-MicrosoftConfigCustomerAsn <Int32>]
   [-MicrosoftConfigRoutingRegistryName <String>]
   [-PeerAddressType <String>]
   [-LegacyMode <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzExpressRouteCircuitPeeringConfig
   -Name <String>
   -ExpressRouteCircuit <PSExpressRouteCircuit>
   -PeeringType <String>
   -PeerASN <UInt32>
   -PrimaryPeerAddressPrefix <String>
   -SecondaryPeerAddressPrefix <String>
   -VlanId <Int32>
   [-SharedKey <String>]
   [-MicrosoftConfigAdvertisedPublicPrefixes <String[]>]
   [-MicrosoftConfigCustomerAsn <Int32>]
   [-MicrosoftConfigRoutingRegistryName <String>]
   -RouteFilterId <String>
   [-PeerAddressType <String>]
   [-LegacyMode <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzExpressRouteCircuitPeeringConfig
   -Name <String>
   -ExpressRouteCircuit <PSExpressRouteCircuit>
   -PeeringType <String>
   -PeerASN <UInt32>
   -PrimaryPeerAddressPrefix <String>
   -SecondaryPeerAddressPrefix <String>
   -VlanId <Int32>
   [-SharedKey <String>]
   [-MicrosoftConfigAdvertisedPublicPrefixes <String[]>]
   [-MicrosoftConfigCustomerAsn <Int32>]
   [-MicrosoftConfigRoutingRegistryName <String>]
   -RouteFilter <PSRouteFilter>
   [-PeerAddressType <String>]
   [-LegacyMode <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Descrizione

Il cmdlet Add-AzExpressRouteCircuitPeeringConfig aggiunge una configurazione di peering a un circuito ExpressRoute. I circuiti ExpressRoute connettono la rete locale al cloud Microsoft usando un provider di connettività anziché la rete Internet pubblica. Si noti che, dopo aver eseguito Add-AzExpressRouteCircuitPeeringConfig, è necessario chiamare il cmdlet Set-AzExpressRouteCircuit per attivare la configurazione.

Esempio

Esempio 1: Aggiungere un peer a un circuito ExpressRoute esistente

$circuit = Get-AzExpressRouteCircuit -Name $CircuitName -ResourceGroupName $rg
$parameters = @{
    Name = 'AzurePrivatePeering'
    Circuit = $circuit
    PeeringType = 'AzurePrivatePeering'
    PeerASN = 100
    PrimaryPeerAddressPrefix = '10.6.1.0/30'
    SecondaryPeerAddressPrefix = '10.6.2.0/30'
    VlanId  = 200
}
Add-AzExpressRouteCircuitPeeringConfig @parameters
Set-AzExpressRouteCircuit -ExpressRouteCircuit $circuit

Esempio 2

Aggiunge una configurazione di peering a un circuito ExpressRoute. (generato automaticamente)

Add-AzExpressRouteCircuitPeeringConfig -ExpressRouteCircuit <PSExpressRouteCircuit> -MicrosoftConfigAdvertisedPublicPrefixes <String[]> -MicrosoftConfigCustomerAsn <Int32> -MicrosoftConfigRoutingRegistryName <String> -Name 'AzurePrivatePeering' -PeerASN 100 -PeerAddressType IPv4 -PeeringType AzurePrivatePeering -PrimaryPeerAddressPrefix '123.0.0.0/30' -SecondaryPeerAddressPrefix '123.0.0.4/30' -VlanId 300

Parametri

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ExpressRouteCircuit

Circuito ExpressRoute da modificare. Questo è l'oggetto di Azure restituito dal cmdlet Get-AzExpressRouteCircuit .

Tipo:PSExpressRouteCircuit
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-LegacyMode

Modalità legacy del peering

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-MicrosoftConfigAdvertisedPublicPrefixes

Per un peeringType di MicrosoftPeering, è necessario fornire un elenco di tutti i prefissi che si prevede di annunciare tramite la sessione BGP. Sono accettati solo prefissi di indirizzi IP pubblici. Per inviare un set di prefissi, è possibile creare un elenco con valori delimitati da virgole. Questi prefissi devono essere registrati in un nome del Registro di sistema di routing (RIR/IRR).

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MicrosoftConfigCustomerAsn

se si annunciano prefissi non registrati nel numero AS del peering, è possibile specificare il numero AS in cui sono registrati.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MicrosoftConfigRoutingRegistryName

Nome del Registro di sistema di routing (RIR/IRR) in cui vengono registrati il numero AS e i prefissi.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Nome della relazione di peering da aggiungere.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PeerAddressType

PeerAddressType

Tipo:String
Valori accettati:IPv4, IPv6
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PeerASN

Numero AS del circuito ExpressRoute. Deve essere un ASN pubblico quando peeringType è AzurePublicPeering.

Tipo:UInt32
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PeeringType

I valori accettabili per questo parametro sono: AzurePrivatePeering, AzurePublicPeeringe MicrosoftPeering

Tipo:String
Valori accettati:AzurePrivatePeering, AzurePublicPeering, MicrosoftPeering
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PrimaryPeerAddressPrefix

Questo è l'intervallo di indirizzi IP per il percorso di routing primario di questa relazione di peering. Deve essere una subnet CIDR /30. Il primo indirizzo numerato dispari in questa subnet deve essere assegnato all'interfaccia del router. Azure configurerà l'indirizzo pari successivo all'interfaccia del router di Azure.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RouteFilter

Si tratta di un oggetto RouteFilter esistente.

Tipo:PSRouteFilter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-RouteFilterId

Id risorsa di un oggetto RouteFilter esistente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SecondaryPeerAddressPrefix

Questo è l'intervallo di indirizzi IP per il percorso di routing secondario di questa relazione di peering. Deve essere una subnet CIDR /30. Il primo indirizzo numerato dispari in questa subnet deve essere assegnato all'interfaccia del router. Azure configurerà l'indirizzo pari successivo all'interfaccia del router di Azure.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SharedKey

Si tratta di un hash MD5 facoltativo usato come chiave precondi shared per la configurazione del peering.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VlanId

Questo è il numero ID della VLAN assegnata per questo peering.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

PSExpressRouteCircuit

String

PSRouteFilter

Boolean

Output

PSExpressRouteCircuit