PowerShell을 사용하여 Exchange 피어링 만들기 또는 수정
이 문서에서는 PowerShell cmdlet 및 Resource Manager 배포 모델을 사용하여 Microsoft Exchange 피어링을 만드는 방법을 설명합니다. 리소스의 상태를 확인하거나 리소스를 업데이트하거나 리소스를 삭제하고 프로비저닝 해제하는 방법도 나와 있습니다.
원할 경우 Azure Portal을 통해 이 가이드를 완료할 수 있습니다.
시작하기 전에
- 구성을 시작하기 전에 필수 구성 요소 및 Exchange 피어링 연습을 검토합니다.
- Exchange를 Microsoft와 이미 피어링했으며 Azure 리소스로 아직 변환하지 않은 경우 PowerShell을 사용하여 레거시 Exchange 피어링을 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 설치의 단계를 따릅니다.
Exchange 피어링 만들기 및 프로비저닝
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 연결의 단계를 따르세요. 이 작업은 피어링을 요청하는 데 필요합니다.
참고 항목
리소스 그룹의 위치는 피어링을 설정하기 위해 선택한 위치와 무관합니다.
Exchange 피어링이 지원되는 피어링 위치 목록 가져오기
PowerShell cmdlet Get-AzPeeringLocation은 필수 매개 변수를 사용하여 이후 단계에서 사용할 필수 매개 변수 Kind가 있는 피어링 위치 목록을 반환합니다.
Get-AzPeeringLocation -Kind "Exchange"
Exchange 피어링 위치에는 다음 필드가 포함됩니다.
- ExchangeName
- PeeringLocation
- Country
- PeeringDBFacilityId
- PeeringDBFacilityLink
- MicrosoftIPv4Address
- MicrosoftIPv6Address
PeeringDB를 참조하여 원하는 피어링 기능에 있는지 확인합니다.
이 예제에서는 피어링 위치로 시애틀을 사용하여 피어링을 만드는 방법을 보여줍니다.
$exchangeLocations = Get-AzPeeringLocation -Kind Exchange
$exchangeLocation = $exchangeLocations | where {$_.PeeringLocation -eq "Seattle"}
#check the location metadata
$exchangeLocation
ExchangeName : Columbia IX
PeeringLocation : Seattle
Country : US
PeeringDBFacilityId : 99999
PeeringDBFacilityLink : https://www.peeringdb.com/ix/99999
MicrosoftIPv4Address : 10.12.97.129
MicrosoftIPv6Address :
ExchangeName : Equinix Seattle
PeeringLocation : Seattle
Country : US
PeeringDBFacilityId : 11
PeeringDBFacilityLink : https://www.peeringdb.com/ix/11
MicrosoftIPv4Address : 198.32.134.152
MicrosoftIPv6Address : 2001:504:12::15
...
Exchange 피어링 만들기
다음 예제에서는 시애틀의 Equinix Internet Exchange에서 Exchange 연결을 만드는 방법을 보여줍니다. 다른 공급자와 다른 설정을 사용하는 경우, 요청을 수행할 때 해당 정보를 대체합니다.
PowerShell cmdlet New-AzPeeringExchangeConnectionObject를 사용하여 새 피어링 요청을 생성하는 데 사용되는 PowerShell 연결 개체를 만듭니다.
이 예제에서는 Exchange 연결을 만드는 방법을 보여줍니다.
$connection1 = New-AzPeeringExchangeConnectionObject `
-PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
-PeerSessionIPv4Address 198.32.134.22 `
-PeerSessionIPv6Address 2001:504:12::22 `
-MaxPrefixesAdvertisedIPv4 2000 `
-MaxPrefixesAdvertisedIPv6 2000 `
지정된 피어링 위치에서 중복이 필요한 경우 다른 연결을 만듭니다.
$connection2 = New-AzPeeringExchangeConnectionObject `
-PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
-PeerSessionIPv4Address 198.32.134.23 `
-PeerSessionIPv6Address 2001:504:12::23 `
-MaxPrefixesAdvertisedIPv4 2000 `
-MaxPrefixesAdvertisedIPv6 2000 `
PowerShell cmdlet New-AzPeering을 사용하여 새 Exchange 피어링을 만들 수 있습니다.
$asn = Get-AzPeerAsn
New-AzPeering `
-Name "SeattleExchangePeering" `
-ResourceGroupName "PeeringResourceGroup" `
-PeerAsnResourceId $asn.Id `
-PeeringLocation $exchangeLocation[1].PeeringLocation `
-ExchangeConnection $connection1[, $connection2]
이 예제 응답은 하나의 연결을 사용하여 요청이 실행된 시기를 보여줍니다.
Name : SeattleExchangePeering
Sku.Name : Basic_Exchange_Free
Kind : Exchange
Connections : {11}
PeerAsn.Id : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/{peerAsnName}
PeeringLocation : Seattle
ProvisioningState : Succeeded
Location : West US 2
Id : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleExchangePeering
Type : Microsoft.Peering/peerings
Tags : {}
Important
Microsoft에서 요청된 피어링의 프로비저닝을 시작하고 ConnectionState는 진행 상황을 반영합니다.
프로비저닝 관련 단계에 대한 자세한 내용은 Exchange 피어링 연습을 참조하세요.
여기에 표시된 것처럼 연결 상태를 확인할 수 있습니다.
$peering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"
$peering.Connections
PeeringDBFacilityId : 11
PeerSessionIPv4Address : 198.32.134.22
PeerSessionIPv6Address : 2001:504:12::22
SessionStateV4 : PendingAdd
SessionStateV6 : PendingAdd
MaxPrefixesAdvertisedV4 : 2000
MaxPrefixesAdvertisedV6 : 2000
MicrosoftSessionIPv4Address : 198.32.134.152
MicrosoftSessionIPv4Address : 2001:504:12::15
Md5AuthenticationKey :
Exchange 피어링 가져오기
피어링 목록을 가져오려면 Get-AzPeering 명령을 실행합니다.
Get-AzPeering ResourceGroupName "PeeringResourceGroup" -Name "SeattleExchangePeering"
이 예제 응답에서는 엔드투엔드 프로비저닝이 성공적으로 완료된 시기를 보여줍니다.
Name : SeattleExchangePeering
Sku : Basic_Exchange_Free
Kind : Exchange
PeeringLocation : Seattle
ProvisioningState : Succeeded
PeerAsn : 65000
Connection : ------------------------
PeerSessionIPv4Address : 10.21.31.100
MicrosoftIPv4Address : 10.21.31.50
SessionStateV4 : Established
MaxPrefixesAdvertisedV4 : 20000
PeerSessionIPv6Address : fe01::3e:100
MicrosoftIPv6Address : fe01::3e:50
SessionStateV6 : Established
MaxPrefixesAdvertisedV6 : 2000
ConnectionState : Active
Connection : ------------------------
PeerSessionIPv4Address : 10.21.31.101
MicrosoftIPv4Address : 10.21.31.51
SessionStateV4 : Established
MaxPrefixesAdvertisedV4 : 20000
PeerSessionIPv6Address : fe01::3e:101
MicrosoftIPv6Address : fe01::3e:51
SessionStateV6 : Established
MaxPrefixesAdvertisedV6 : 2000
ConnectionState : Active
Exchange 피어링 수정
Exchange 피어링에 대해 지원되는 수정 작업은 다음과 같습니다.
- Exchange 피어링 연결을 추가합니다.
- Exchange 피어링 연결을 제거합니다.
- 활성 연결에서 IPv4 또는 IPv6 세션을 추가합니다.
- 활성 연결에서 IPv4 또는 IPv6 세션을 제거합니다.
Exchange 피어링 연결 추가
이 예제에서는 기존 Exchange 피어링에 연결을 추가하는 방법을 설명합니다.
$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"
$connection = New-AzPeeringExchangeConnectionObject `
-PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
-PeerSessionIPv4Address 198.32.134.22 `
-PeerSessionIPv6Address 2001:504:12::22 `
-MaxPrefixesAdvertisedIPv4 2000 `
-MaxPrefixesAdvertisedIPv6 2000 `
$exchangePeering.Connections.Add($connection)
$exchangePeering | Update-AzPeering
Exchange 피어링 연결 제거
이 예제에서는 기존 Exchange 피어링에 연결을 제거하는 방법을 설명합니다.
$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"
모든 연결을 확인하고 제거할 연결을 선택합니다.
$exchangePeering
Name : SeattleExchangePeering
Sku.Name : Basic_Exchange_Free
Kind : Exchange
Connections : {11}
PeerAsn.Id : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/{peerAsnName}
PeeringLocation : Seattle
ProvisioningState : Succeeded
Location : West US 2
Id : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleExchangePeering
Type : Microsoft.Peering/peerings
Tags : {}
다음 명령에서 0 대신 제거할 연결에 대한 인덱스 번호를 입력합니다.
$connection = $exchangePeering.Connections[0]
$exchangePeering.Connections.Remove($connection)
$exchangePeering | Update-AzPeering
활성 연결에서 IPv4 또는 IPv6 세션 추가
이 예제에서는 기존 Exchange 연결에 IPv6 세션을 추가하는 방법을 설명합니다.
$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"
$exchangePeering.Connections[0].BgpSession.PeerSessionIPv6Address = "2001:504:12::34"
$exchangePeering | Update-AzPeering
활성 연결에서 IPv4 또는 IPv6 세션 제거
기존 연결에서 IPv4 또는 IPv6 세션을 제거하는 것은 현재 PowerShell에서 지원되지 않습니다. 자세한 내용은 Microsoft 피어링에 문의하세요.
Exchange 피어링 프로비저닝 해제
현재 프로비전 해제는 Azure Portal 또는 PowerShell을 사용하여 지원되지 않습니다. 프로비저닝을 해제하려면 Microsoft 피어링에 문의하세요.
추가 리소스
다음 명령을 실행하여 모든 매개 변수에 대한 자세한 설명을 볼 수 있습니다.
Get-Help Get-AzPeering -detailed