Преобразование устаревшего прямого пиринга в ресурс Azure с помощью PowerShell
В этой статье описывается, как преобразовать существующий устаревший прямой пиринг в ресурс Azure с помощью командлетов PowerShell.
По желанию все инструкции из этого руководства можно также выполнить с помощью портала Azure.
Подготовка к работе
Работа в Azure PowerShell
Для запуска командлетов можно использовать бесплатную интерактивную оболочку Azure Cloud Shell. Она включает предварительно установленные общие инструменты Azure и настроена для использования с вашей учетной записью. Выберите Копировать, чтобы скопировать код, и вставьте его в Cloud Shell. Затем выберите ВВОД для выполнения кода. Cloud Shell можно запустить несколькими способами:
Способ запуска | Снимок экрана |
---|---|
Откройте Cloud Shell в браузере. | |
Нажмите кнопку меню Cloud Shell на панели инструментов в правом верхнем углу окна портала Azure. | |
Если вы не хотите использовать Azure Cloud Shell, можно установить PowerShell локально. Чтобы установить и использовать PowerShell локально, обязательно установите последнюю версию командлетов PowerShell для Azure Resource Manager. Командлеты PowerShell часто обновляются. Как правило, необходимо обновить командлеты PowerShell, чтобы получить новые функциональные возможности. В противном случае могут возникнуть проблемы.
Чтобы узнать, какая версия PowerShell выполняется локально, используйте командлет 'Get-Module -ListAvailable Az'. Если необходимо выполнить обновление, см. статью об установке модуля Azure PowerShell. Дополнительные сведения см. в разделе Установка и настройка Azure PowerShell.
Если используется PowerShell для macOS, выполните действия, описанные в разделе Установка PowerShell для macOS.
Преобразование устаревшего прямого пиринга в ресурс Azure
Войдите в учетную запись Azure и выберите подписку.
Перед настройкой установите и импортируйте необходимые модули. Для установки модулей в 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"
Важно!
Если вы еще не установили связь с ASN и подпиской, выполните действия, описанные в разделе Связывание однорангового ASN. Это действие требуется для запроса пиринга.
Примечание.
Расположение группы ресурсов не зависит от расположения, в котором вы решили настроить пиринг.
Получение устаревшего прямого пиринга для преобразования
В этом примере показано, как получить устаревший прямой пиринг из расположения пиринга в Сиэтле.
$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
Преобразование устаревшего прямого пиринга
Важно!
При преобразовании устаревшего пиринга в ресурс 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