Azure PowerShell을 사용하여 클래식에서 Resource Manager로 Azure Virtual Network 마이그레이션

아티클
05/11/2023

이 문서에서는 클래식 배포 모델에서 최신 Resource Manager 배포 모델로 마이그레이션하는 방법에 대해 알아봅니다.

클래식에서 Resource Manager로의 마이그레이션은 한 번에 하나의 가상 네트워크에서 완료됩니다. Azure PowerShell 요구 사항 이외에는 마이그레이션에 대한 도구 또는 필수 조건에 대한 추가 요구 사항이 없습니다. 마이그레이션은 가상 네트워크 리소스의 컨트롤 플레인 마이그레이션입니다. 마이그레이션 중에는 데이터 경로 가동 중지 시간이 없습니다. 마이그레이션 중에 연결이 손실되지 않고 기존 워크로드가 계속 작동합니다. 가상 네트워크에 연결된 모든 공용 IP 주소는 마이그레이션 프로세스 중에 변경되지 않습니다.

마이그레이션이 완료되면 Resource Manager 모델을 사용하여 모든 관리 작업을 수행해야 합니다. 관리 작업은 Resource Manager 배포 모델을 통해서만 액세스할 수 있습니다. 서브넷 또는 가상 네트워크 리소스 변경 내용은 이전 배포 모델을 통해 더 이상 사용할 수 없습니다.

클래식에서 Resource Manager 모델로 가상 네트워크를 마이그레이션하면 가상 네트워크 내의 지원되는 리소스가 새 모델로 자동으로 마이그레이션됩니다.

필수 조건

활성 구독이 있는 Azure 계정. 체험 계정 만들기
이 문서의 단계 및 예제에서는 Azure PowerShell Az 모듈을 사용합니다. 컴퓨터에 Az 모듈을 로컬로 설치하려면 Azure PowerShell 설치를 참조하세요. 새 Az 모듈에 대한 자세한 내용은 새 Azure PowerShell Az 모듈 소개를 참조하세요. PowerShell cmdlet은 자주 업데이트됩니다. 최신 버전을 실행하지 않는 경우 지침에 지정된 값이 실패할 수 있습니다. 시스템에 설치된 PowerShell 버전을 찾으려면 cmdlet Get-Module -ListAvailable Az cmdlet을 사용합니다.
애플리케이션 게이트웨이가 있는 가상 네트워크를 마이그레이션하려면 네트워크 이전을 위한 준비 작업을 실행하기 전에 해당 게이트웨이를 제거합니다. 마이그레이션을 완료한 후 Azure Resource Manager에서 게이트웨이를 다시 연결합니다.
컴퓨터에 클래식 및 Az Azure PowerShell 모듈을 둘 다 로컬로 설치했는지 확인합니다. 자세한 내용은 Azure PowerShell을 설치 및 구성하는 방법을 참조하세요.
다른 구독의 ExpressRoute 회로에 연결하는 Azure ExpressRoute 게이트웨이는 자동으로 마이그레이션할 수 없습니다. 이러한 경우에는 ExpressRoute 게이트웨이를 제거하고 가상 네트워크를 마이그레이션한 다음, 해당 게이트웨이를 다시 만듭니다.

지원되는 시나리오

클래식에서 Resource Manager 마이그레이션에 대해 지원되는 시나리오는 다음과 같습니다.

가상 머신을 포함하는 클래식 Virtual Networks
클라우드 서비스당 하나의 가용성 집합이 있는 클래식 Virtual Networks
Microsoft Entra Domain Services를 포함하는 클래식 Virtual Networks
단일 VPN 게이트웨이 또는 단일 Express Route 회로가 있는 클래식 Virtual Networks

지원되지 않는 시나리오

다음 시나리오에서는 마이그레이션이 지원되지 않습니다.

클래식 배포 모델에서 가상 네트워크의 수명 주기 관리
클래식 배포 모델에 대한 Azure 역할 기반 액세스 제어 지원
ExpressRoute 게이트웨이와 VPN 게이트웨이가 모두 있는 Virtual Network 마이그레이션
단일 클라우드 서비스에 둘 이상의 가용성 집합이 있는 Virtual Networks의 마이그레이션
하나 이상의 가용성 집합이 있고 단일 클라우드 서비스의 가용성 집합에 없는 가상 머신이 있는 Virtual Networks의 마이그레이션
클래식에서 Resource Manager로 애플리케이션 게이트웨이 마이그레이션

리소스 공급자 등록

이 섹션에서는 Resource Manager cmdlet을 사용하여 구독에 로그인하고 마이그레이션 리소스 공급자를 등록합니다.

Azure PowerShell에 로그인합니다.
```
Connect-AzAccount
```
마이그레이션 리소스 공급자를 등록합니다.
```
Register-AzResourceProvider -ProviderNamespace Microsoft.ClassicInfrastructureMigrate
```
등록이 완료될 때까지 5분간 기다리세요. 다음 명령을 사용하여 마이그레이션 상태를 확인합니다.
```
Get-AzResourceProvider -ProviderNamespace Microsoft.ClassicInfrastructureMigrate
```
계속 진행하기 전에 RegistrationState가 Registered인지 확인합니다.

참고 항목

등록은 일회성 단계이지만 마이그레이션 시도 전에 반드시 한 번은 하여야 합니다. 등록하지 않으면 다음과 같은 오류 메시지가 표시됩니다.

BadRequest : 구독이 마이그레이션에 대해 등록되지 않았습니다.

마이그레이션할 가상 네트워크 이름 검색

이 섹션에서는 클래식 배포 모델 PowerShell에 로그인하고 마이그레이션할 가상 네트워크의 이름을 검색합니다.

클래식 배포 PowerShell에 로그인합니다.
```
Add-AzureAccount
```
다음 명령을 실행하여 클래식 가상 네트워크 이름을 검색합니다.
```
Get-AzureVnetSite | Select -Property Name
```

다음 섹션에서 사용할 수 있도록 가상 네트워크의 이름을 메모해 둡니다.

가상 네트워크 마이그레이션

이 섹션에서는 마이그레이션을 진행할 수 있는지 유효성을 검사한 다음, 마이그레이션을 준비합니다.

이전 섹션에서 메모해 둔 가상 네트워크의 이름을 명령에 사용할 변수로 넣습니다. myVNet을 이전 섹션에서 검색한 가상 네트워크의 이름으로 바꿉니다.
```
$vnetname = "myVNet"
```
다음 명령을 사용하여 가상 네트워크를 마이그레이션할 수 있는지 유효성을 검사합니다.
```
Move-AzureVirtualNetwork -Validate -VirtualNetworkName $vnetName
```
명령은 마이그레이션을 차단하는 모든 경고 또는 오류를 표시합니다. 유효성 검사가 성공하면 다음 준비 단계를 진행할 수 있습니다.

참고 항목

가상 네트워크에 웹 또는 작업자 역할이 포함되어 있거나 지원되지 않는 구성을 포함하는 가상 머신이 있으면 유효성 검사 오류 메시지가 표시됩니다.
다음 명령을 실행하여 마이그레이션을 위한 가상 네트워크를 준비합니다.
```
Move-AzureVirtualNetwork -Prepare -VirtualNetworkName $vnetName
```
마이그레이션 준비가 되어 있지 않아 이전 상태로 되돌아가려면 다음 명령을 사용합니다.
```
Move-AzureVirtualNetwork -Abort -VirtualNetworkName $vnetName
```

마이그레이션 커밋

준비된 구성에 문제가 없으면 다음 명령을 실행하여 마이그레이션을 커밋할 수 있습니다.

Move-AzureVirtualNetwork -Commit -VirtualNetworkName $vnetName

다음 단계

Azure에서 클래식에서 Resource Manager로 리소스를 마이그레이션하는 방법에 대한 자세한 내용은 다음을 참조하세요.

다음을 통해 공유