PowerShell을 사용하여 직접 피어링 만들기 또는 수정

아티클
02/23/2024

이 문서에서는 PowerShell cmdlet 및 Azure Resource Manager 배포 모델을 사용하여 Microsoft Direct 피어링을 만드는 방법을 설명합니다. 리소스의 상태를 확인하거나 리소스를 업데이트하거나 리소스를 삭제하고 프로비저닝 해제하는 방법도 나와 있습니다.

원할 경우 Azure Portal을 통해 이 가이드를 완료할 수 있습니다.

시작하기 전에

구성을 시작하기 전에 필수 구성 요소 및 직접 피어링 연습을 검토합니다.
Azure 리소스로 아직 변환하지 않은 Microsoft와의 직접 피어링 연결이 이미 있는 경우 PowerShell을 사용하여 레거시 직접 피어링을 Azure 리소스로 변환을 참조하세요.

Azure PowerShell을 사용하여 작업

cmdlet을 실행하기 위해 무료 대화형 셸인 Azure Cloud Shell을 사용할 수 있습니다. 공용 Azure 도구가 사전 설치되어 계정에서 사용하도록 구성되어 있습니다. 복사를 선택하여 코드를 복사하고 Cloud Shell에 붙여넣습니다. 그런 다음, Enter를 선택하여 실행합니다. Cloud Shell을 시작하는 몇 가지 방법이 있습니다.

시작 방법	스크린샷
브라우저에서 Cloud Shell을 엽니다.
Azure Portal의 오른쪽 위에 있는 도구 모음에서 Cloud Shell 단추를 선택합니다.

Azure Cloud Shell을 사용하지 않으려면, 대신 PowerShell을 로컬에 설치할 수 있습니다. PowerShell을 로컬에 설치하여 사용하는 경우 최신 버전의 Azure Resource Manager PowerShell cmdlet을 설치해야 합니다. PowerShell cmdlet은 자주 업데이트됩니다. 일반적으로 PowerShell cmdlet을 업데이트하여 최신 기능을 가져와야 합니다. 그렇지 않으면 문제가 발생할 수 있습니다.

로컬로 실행 중인 PowerShell 버전을 찾으려면 'Get-Module -ListAvailable Az' cmdlet을 사용합니다. 업데이트하려면 Azure PowerShell 모듈 설치를 참조하세요. 자세한 내용은 Azure PowerShell을 설치 및 구성하는 방법을 참조하세요.

macOS에서 PowerShell을 사용하는 경우 macOS에 PowerShell 설치의 단계를 따릅니다.

직접 피어링 만들기 및 프로비저닝

구성을 시작하기 전에 필요한 모듈을 설치하고 가져옵니다. PowerShell에서 모듈을 설치하려면 관리자 권한이 필요합니다.

Az 모듈을 설치하고 가져옵니다.

Install-Module Az -AllowClobber
Import-Module Az

Az.Peering 모듈을 설치하고 가져옵니다.

Install-Module -Name Az.Peering -AllowClobber
Import-Module Az.Peering

다음 명령을 사용하여 모듈을 제대로 가져왔는지 확인합니다.
```
Get-Module
```
다음 명령을 사용하여 Azure 계정에 로그인합니다.
```
Connect-AzAccount
```
계정에 대한 구독을 확인하고 피어링을 만들 구독을 선택합니다.
```
Get-AzSubscription
Select-AzSubscription -SubscriptionId "subscription-id"
```
아직 리소스 그룹이 없는 경우 피어링을 만들기 전에 먼저 리소스 그룹을 만들어야 합니다. 다음 명령을 실행하여 수행할 수 있습니다.
```
New-AzResourceGroup -Name "PeeringResourceGroup" -Location "Central US"
```

Important

ASN과 구독을 아직 연결하지 않은 경우 피어 ASN 연결의 단계를 따르세요. 이 작업은 피어링을 요청하는 데 필요합니다.

참고 항목

리소스 그룹의 위치는 피어링을 설정하기 위해 선택한 위치와 무관합니다.

직접 피어링이 지원되는 피어링 위치 목록 가져오기

PowerShell cmdlet Get-AzPeeringLocation은 필수 매개 변수를 사용하여 이후 단계에서 사용할 필수 매개 변수 Kind가 있는 피어링 위치 목록을 반환합니다.

Get-AzPeeringLocation -Kind Direct

직접 피어링 위치에는 다음 필드가 포함됩니다.

PeeringLocation
Country
PeeringDBFacilityId
PeeringDBFacilityLink
BandwidthOffers

PeeringDB를 참조하여 원하는 피어링 기능에 있는지 확인합니다.

이 예제에서는 피어링 위치로 시애틀을 사용하여 직접 피어링을 만드는 방법을 보여줍니다.

$peeringLocations = Get-AzPeeringLocation -Kind Direct
$peeringLocation = $peeringLocations | where {$_.PeeringLocation -contains "Seattle"}
$peeringLocation

PeeringLocation       : Seattle
Address               : 2001 Sixth Avenue
Country               : US
PeeringDBFacilityId   : 71
PeeringDBFacilityLink : https://www.peeringdb.com/fac/71
BandwidthOffers       : {10Gbps, 100Gbps}

직접 피어링 만들기

다음 예제에서는 시애틀에서 10Gbps 직접 피어링을 만드는 방법을 보여줍니다.

PowerShell cmdlet New-AzPeeringDirectConnectionObject를 사용하여 새 피어링 요청에 사용할 DirectConnection 개체를 만듭니다.

이 예제에서는 DirectConnection 개체를 만드는 방법을 보여줍니다.

$connection1 = New-AzPeeringDirectConnectionObject `
    -PeeringDBFacilityId $peeringLocation[0].PeeringDBFacilityId `
    -SessionPrefixV4 10.21.31.0/31 `
    -SessionPrefixV6 fe01::3e:0/127 `
    -MaxPrefixesAdvertisedIPv4 1000 `
    -MaxPrefixesAdvertisedIPv6 100 `
    -BandwidthInMbps 10000

참고 항목

이전 예제의 $peeringLocation[]에 대한 값은 선택한 피어링 위치와 일치해야 합니다.

지정된 피어링 위치에서 중복이 필요한 경우 다른 연결을 만듭니다.

$connection2 = New-AzPeeringDirectConnectionObject `
    -PeeringDBFacilityId $peeringLocation[0].PeeringDBFacilityId `
    -SessionPrefixV4 10.21.33.0/31 `
    -SessionPrefixV6 fe01::3f:0/127 `
    -MaxPrefixesAdvertisedIPv4 1000 `
    -MaxPrefixesAdvertisedIPv6 100 `
    -BandwidthInMbps 10000

PowerShell cmdlet New-AzPeering을 사용하여 새 직접 피어링을 만듭니다. 이 명령에는 여기에 표시된 대로 검색할 수 있는 ASN 리소스 ID가 필요합니다.

$asn = Get-AzPeerAsn
New-AzPeering `
    -Name "SeattleDirectPeering" `
    -ResourceGroupName "PeeringResourceGroup" `
    -PeeringLocation  $peeringLocation[0].PeeringLocation `
    -PeerAsnResourceId $asn.Id `
    -DirectConnection $connection1 [, $connection2]

이 예제에서는 요청이 성공적으로 처리되었을 때의 응답을 보여줍니다.


    Name                 : SeattleDirectPeering
    Sku.Name             : Basic_Direct_Free
    Kind                 : Direct
    Connections          : 71
    PeerAsn.Id           : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/SeattleDirectPeering
    UseForPeeringService : False
    PeeringLocation      : Seattle
    ProvisioningState    : Succeeded
    Location             : centralus
    Id                   : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleDirectPeering
    Type                 : Microsoft.Peering/peerings
    Tags                 : {}

이 출력의 {subscriptionId} 대신 실제 구독 ID가 표시됩니다.

직접 피어링 확인

피어링 목록을 가져오려면 Get-AzPeering 명령을 실행합니다.

$directPeering = Get-AzPeering -ResourceGroupName "PeeringResourceGroup" -Name "SeattleDirectPeering"

다음 예제에서는 엔드투엔드 프로비저닝이 성공적으로 완료된 경우의 응답을 보여줍니다.

    Name                 : SeattleDirectPeering
    Sku.Name             : Basic_Direct_Free
    Kind                 : Direct
    Connections          : {71}
    PeerAsn.Id           : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/SeattleDirectPeering
    UseForPeeringService : False
    PeeringLocation      : Seattle
    ProvisioningState    : Succeeded
    Location             : centralus
    Id                   : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleDirectPeering
    Type                 : Microsoft.Peering/peerings
    Tags                 : {}

직접 피어링 수정

이 섹션에서는 직접 피어링에 대해 다음과 같은 수정 작업을 수행하는 방법을 설명합니다.

직접 피어링 연결을 추가합니다.
직접 피어링 연결을 제거합니다.
활성 연결에서 대역폭을 업그레이드하거나 다운그레이드합니다.
활성 연결에서 IPv4 또는 IPv6 세션을 추가합니다.
활성 연결에서 IPv4 또는 IPv6 세션을 제거합니다.

직접 피어링 연결 추가

이 예제에서는 기존 직접 피어링에 연결을 추가하는 방법을 설명합니다.


$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"

$connection = New-AzPeeringDirectConnection `
    -PeeringDBFacilityId $peeringLocation.PeeringDBFacilityId `
    -SessionPrefixV4 "10.22.31.0/31" `
    -SessionPrefixV6 "fe02::3e:0/127" `
    -MaxPrefixesAdvertisedIPv4 1000 `
    -MaxPrefixesAdvertisedIPv6 100 `
    -BandwidthInMbps 10000

$directPeering.Connections.Add($connection)

$directPeering | Update-AzPeering

직접 피어링 연결 제거

연결 제거는 현재 PowerShell에서 지원되지 않습니다. 자세한 내용은 Microsoft 피어링에 문의하세요.

활성 연결에서 대역폭 업그레이드 또는 다운그레이드

이 예제에서는 기존 직접 연결에 10Gbps를 추가하는 방법을 설명합니다.


$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"
$directPeering.Connections[0].BandwidthInMbps  = 20000
$directPeering | Update-AzPeering

활성 연결에서 IPv4 또는 IPv6 세션 추가

이 예제에서는 IPv4 세션만 있는 기존 직접 연결에서 IPv6 세션을 추가하는 방법을 설명합니다.


$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"
$directPeering.Connections[0].BGPSession.SessionPrefixv6 = "fe01::3e:0/127"
$directPeering | Update-AzPeering

활성 연결에서 IPv4 또는 IPv6 세션 제거

기존 연결에서 IPv4 또는 IPv6 세션을 제거하는 것은 현재 PowerShell에서 지원되지 않습니다. 자세한 내용은 Microsoft 피어링에 문의하세요.

직접 피어링 프로비저닝 해제

현재 프로비전 해제는 Azure Portal 또는 PowerShell을 사용하여 지원되지 않습니다. 프로비저닝을 해제하려면 Microsoft 피어링에 문의하세요.

추가 리소스

다음 명령을 실행하여 모든 매개 변수에 대한 자세한 설명을 볼 수 있습니다.

Get-Help Get-AzPeering -detailed

다음을 통해 공유

PowerShell을 사용하여 직접 피어링 만들기 또는 수정

시작하기 전에

Azure PowerShell을 사용하여 작업

직접 피어링 만들기 및 프로비저닝

직접 피어링이 지원되는 피어링 위치 목록 가져오기

직접 피어링 만들기

직접 피어링 확인

직접 피어링 수정

직접 피어링 연결 추가

직접 피어링 연결 제거

활성 연결에서 대역폭 업그레이드 또는 다운그레이드

활성 연결에서 IPv4 또는 IPv6 세션 추가

활성 연결에서 IPv4 또는 IPv6 세션 제거

직접 피어링 프로비저닝 해제

추가 리소스

다음 단계

피드백

추가 리소스

다음을 통해 공유

PowerShell을 사용하여 직접 피어링 만들기 또는 수정

시작하기 전에

Azure PowerShell을 사용하여 작업

직접 피어링 만들기 및 프로비저닝

Azure 계정에 로그인하고 구독을 선택합니다.

직접 피어링이 지원되는 피어링 위치 목록 가져오기

직접 피어링 만들기

직접 피어링 확인

직접 피어링 수정

직접 피어링 연결 추가

직접 피어링 연결 제거

활성 연결에서 대역폭 업그레이드 또는 다운그레이드

활성 연결에서 IPv4 또는 IPv6 세션 추가

활성 연결에서 IPv4 또는 IPv6 세션 제거

직접 피어링 프로비저닝 해제

추가 리소스

다음 단계

피드백

추가 리소스