다음을 통해 공유

Add-AzureRmExpressRouteCircuitPeeringConfig

  • 참조
모듈:
AzureRM.Network

ExpressRoute 회로에 피어링 구성을 추가합니다.

Warning

AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.

AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 기본 또는 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.

구문

Add-AzureRmExpressRouteCircuitPeeringConfig
   -Name <String>
   -ExpressRouteCircuit <PSExpressRouteCircuit>
   -PeeringType <String>
   -PeerASN <UInt32>
   -PrimaryPeerAddressPrefix <String>
   -SecondaryPeerAddressPrefix <String>
   -VlanId <Int32>
   [-SharedKey <String>]
   [-MicrosoftConfigAdvertisedPublicPrefixes <System.Collections.Generic.List`1[System.String]>]
   [-MicrosoftConfigCustomerAsn <Int32>]
   [-MicrosoftConfigRoutingRegistryName <String>]
   [-PeerAddressType <String>]
   [-LegacyMode <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzureRmExpressRouteCircuitPeeringConfig
   -Name <String>
   -ExpressRouteCircuit <PSExpressRouteCircuit>
   -PeeringType <String>
   -PeerASN <UInt32>
   -PrimaryPeerAddressPrefix <String>
   -SecondaryPeerAddressPrefix <String>
   -VlanId <Int32>
   [-SharedKey <String>]
   [-MicrosoftConfigAdvertisedPublicPrefixes <System.Collections.Generic.List`1[System.String]>]
   [-MicrosoftConfigCustomerAsn <Int32>]
   [-MicrosoftConfigRoutingRegistryName <String>]
   -RouteFilterId <String>
   [-PeerAddressType <String>]
   [-LegacyMode <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzureRmExpressRouteCircuitPeeringConfig
   -Name <String>
   -ExpressRouteCircuit <PSExpressRouteCircuit>
   -PeeringType <String>
   -PeerASN <UInt32>
   -PrimaryPeerAddressPrefix <String>
   -SecondaryPeerAddressPrefix <String>
   -VlanId <Int32>
   [-SharedKey <String>]
   [-MicrosoftConfigAdvertisedPublicPrefixes <System.Collections.Generic.List`1[System.String]>]
   [-MicrosoftConfigCustomerAsn <Int32>]
   [-MicrosoftConfigRoutingRegistryName <String>]
   -RouteFilter <PSRouteFilter>
   [-PeerAddressType <String>]
   [-LegacyMode <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Add-AzureRmExpressRouteCircuitPeeringConfig cmdlet은 ExpressRoute 회로에 피어링 구성을 추가합니다. ExpressRoute 회로는 공용 인터넷 대신 연결 공급자를 사용하여 온-프레미스 네트워크를 Microsoft 클라우드에 연결합니다. Add-AzureRmExpressRouteCircuitPeeringConfig를 실행한 후 Set-AzureRmExpressRouteCircuit cmdlet을 호출하여 구성을 활성화해야 합니다.

예제

예제 1: 기존 ExpressRoute 회로에 피어 추가

$circuit = Get-AzureRmExpressRouteCircuit -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-AzureRmExpressRouteCircuitPeeringConfig @parameters
Set-AzureRmExpressRouteCircuit -ExpressRouteCircuit $circuit

매개 변수

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
별칭:AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ExpressRouteCircuit

수정 중인 ExpressRoute 회로입니다. Get-AzureRmExpressRouteCircuit cmdlet에서 반환된 Azure 개체입니다.

형식:PSExpressRouteCircuit
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-LegacyMode

피어링의 레거시 모드

형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-MicrosoftConfigAdvertisedPublicPrefixes

MicrosoftPeering의 PeeringType의 경우 BGP 세션을 통해 보급하려는 모든 접두사 목록을 제공해야 합니다. 공용 IP 주소 접두사만 수락됩니다. 접두사 집합을 보내려는 경우 쉼표로 구분된 목록을 보낼 수 있습니다. 이러한 접두사는 RIR/IRR(라우팅 레지스트리 이름)에 등록해야 합니다.

형식:List<T>[String]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-MicrosoftConfigCustomerAsn

피어링 AS 숫자에 등록되지 않은 광고 접두사인 경우 등록된 AS 번호를 지정할 수 있습니다.

형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-MicrosoftConfigRoutingRegistryName

AS 번호와 접두사를 등록할 RIR/IRR(라우팅 레지스트리 이름)입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Name

추가할 피어링 관계의 이름입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PeerAddressType

PeerAddressType

형식:String
허용되는 값:IPv4, IPv6
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PeerASN

ExpressRoute 회로의 AS 번호입니다. PeeringType이 AzurePublicPeering인 경우 공용 ASN이어야 합니다.

형식:UInt32
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PeeringType

이 매개 변수에 허용되는 값은 다음과 AzurePrivatePeeringAzurePublicPeering같습니다.MicrosoftPeering

형식:String
허용되는 값:AzurePrivatePeering, AzurePublicPeering, MicrosoftPeering
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PrimaryPeerAddressPrefix

이 피어링 관계의 기본 라우팅 경로에 대한 IP 주소 범위입니다. /30 CIDR 서브넷이어야 합니다. 이 서브넷의 첫 번째 홀수 주소는 라우터 인터페이스에 할당되어야 합니다. Azure는 Azure 라우터 인터페이스에 대한 다음 짝수 번호 주소를 구성합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RouteFilter

기존 RouteFilter 개체입니다.

형식:PSRouteFilter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-RouteFilterId

기존 RouteFilter 개체의 리소스 ID입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-SecondaryPeerAddressPrefix

이 피어링 관계의 보조 라우팅 경로에 대한 IP 주소 범위입니다. /30 CIDR 서브넷이어야 합니다. 이 서브넷의 첫 번째 홀수 주소는 라우터 인터페이스에 할당되어야 합니다. Azure는 Azure 라우터 인터페이스에 대한 다음 짝수 번호 주소를 구성합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SharedKey

피어링 구성에 대한 사전 공유 키로 사용되는 선택적 MD5 해시입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-VlanId

이 피어링에 할당된 VLAN의 ID 번호입니다.

형식:Int32
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

PSExpressRouteCircuit

매개 변수: ExpressRouteCircuit(ByValue)

String

PSRouteFilter

Boolean

출력

PSExpressRouteCircuit