PowerShell을 사용하여 레거시 직접 피어링을 Azure 리소스로 변환
이 문서에서는 PowerShell cmdlets을 사용하여 기존 레거시 직접 피어링을 Azure 리소스로 변환하는 방법을 설명합니다.
원할 경우 Azure Portal을 통해 이 가이드를 완료할 수 있습니다.
시작하기 전에
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 설치의 단계를 따릅니다.
레거시 직접 피어링을 Azure 리소스로 변환
Azure 계정에 로그인하고 구독을 선택합니다.
구성을 시작하기 전에 필요한 모듈을 설치하고 가져옵니다. PowerShell에서 모듈을 설치하려면 관리자 권한이 필요합니다.
Az 모듈을 설치하고 가져옵니다.
Install-Module Az -AllowClobber Import-Module AzAz.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 연결의 단계를 따르세요. 이 작업은 피어링을 요청하는 데 필요합니다.
참고 항목
리소스 그룹의 위치는 피어링을 설정하기 위해 선택한 위치와 무관합니다.
변환을 위한 레거시 직접 피어링 가져오기
이 예제에서는 Seattle 피어링 위치에서 레거시 직접 피어링을 가져오는 방법을 설명합니다.
$legacyPeering = Get-AzLegacyPeering `
-Kind Direct -PeeringLocation "Seattle"
$legacyPeering
다음은 응답의 예입니다.
Name :
Sku : Basic_Direct_Free
Kind : Direct
PeeringLocation : Seattle
UseForPeeringService : False
PeerAsn.Id :
Connection : ------------------------
PeeringDBFacilityId : 71
SessionPrefixIPv4 : 4.71.156.72/30
PeerSessionIPv4Address : 4.71.156.73
MicrosoftIPv4Address : 4.71.156.74
SessionStateV4 : Established
MaxPrefixesAdvertisedV4 : 20000
SessionPrefixIPv6 : 2001:1900:2100::1e10/126
MaxPrefixesAdvertisedV6 : 2000
ConnectionState : Active
BandwidthInMbps : 0
ProvisionedBandwidthInMbps : 20000
Connection : ------------------------
PeeringDBFacilityId : 71
SessionPrefixIPv4 : 4.68.70.140/30
PeerSessionIPv4Address : 4.68.70.141
MicrosoftIPv4Address : 4.68.70.142
SessionStateV4 : Established
MaxPrefixesAdvertisedV4 : 20000
SessionPrefixIPv6 : 2001:1900:4:3::cc/126
PeerSessionIPv6Address : 2001:1900:4:3::cd
MicrosoftIPv6Address : 2001:1900:4:3::ce
SessionStateV6 : Established
MaxPrefixesAdvertisedV6 : 2000
ConnectionState : Active
BandwidthInMbps : 0
ProvisionedBandwidthInMbps : 20000
ProvisioningState : Succeeded
레거시 직접 피어링 변환
Important
레거시 피어링을 Azure 리소스로 변환하면 수정이 지원되지 않습니다.
레거시 직접 피어링을 Azure 리소스로 변환하려면 다음 명령을 사용합니다:
$legacyPeering[0] | New-AzPeering `
-Name "SeattleDirectPeering" `
-ResourceGroupName "PeeringResourceGroup" `
다음은 응답의 예입니다.
Name : SeattleDirectPeering
Sku.Name : Basic_Direct_Free
Kind : Direct
Connections : {11, 11}
PeerAsn.Id : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/{asnNumber}
UseForPeeringService : False
PeeringLocation : Seattle
ProvisioningState : Succeeded
Location : centralus
Id : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleDirectPeering
Type : Microsoft.Peering/peerings
Tags : {}
추가 리소스
명령을 실행하여 모든 매개 변수에 대한 자세한 설명을 볼 수 있습니다:
Get-Help Get-AzPeering -detailed