Azure PowerShell을 AzureRM에서 Az로 마이그레이션

Warning

AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.

AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 기본 또는 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.

AzureRM PowerShell 모듈을 사용하는지 확인

다음 명령을 사용하여 AzureRM PowerShell 모듈이 설치되어 있는지 확인합니다.

Get-Module -Name AzureRM -ListAvailable

또한 패턴 *-AzureRM* 에 대한 스크립트의 전체 텍스트 검색을 수행하여 AzureRM PowerShell 모듈을 사용하고 있는지 확인할 수 있습니다.

Az PowerShell 모듈로 업그레이드

AzureRM cmdlet용으로 작성된 스크립트는 자동으로 Az에서 작동하지 않습니다. 더 쉽게 전환할 수 있도록 AzureRM에서 Az 마이그레이션 도구 키트 로 개발되었습니다. 새 명령 집합으로의 마이그레이션은 편리하지 않지만 이 문서는 Az PowerShell 모듈로의 전환을 시작하는 데 도움이 됩니다. Az PowerShell 모듈을 만든 이유에 대한 자세한 내용은 Az PowerShell 모듈 소개를 참조하세요.

새로운 cmdlet 이름은 쉽게 익힐 수 있도록 되었습니다. cmdlet 이름을 사용 AzureRm 하거나 Azure cmdlet 이름을 Az사용하는 대신 . 예를 들어 이전 cmdlet New-AzureRMVm 은 다음과 같습니다 New-AzVm. 그러나 마이그레이션은 새 cmdlet 이름에 익숙해지는 것 이상입니다. 이름이 바뀐 모듈, 매개 변수 및 기타 중요한 변경이 있습니다.

AzureRM과 Az 간의 호환성이 손상되는 변경의 전체 목록을 보려면 AzureRM에서 Az으로의 완전한 변경을 참조하세요.

기존 스크립트가 최신 AzureRM 릴리스에서 작동하는지 확인

마이그레이션 단계를 수행하기 전에 시스템에 설치된 AzureRM 버전을 결정합니다. 이렇게 하면 스크립트가 최신 릴리스에서 이미 실행되고 있는지 확인하고 제거해야 하는 AzureRM 버전을 알려줄 수 있습니다.

설치한 AzureRM 버전을 확인하려면 다음 예제를 실행합니다.

Get-Module -Name AzureRM -ListAvailable -All

사용 가능한 최신 AzureRM 릴리스는 6.13.2입니다. 이 버전이 설치되어 있지 않은 경우 기존 스크립트는 이 문서에 설명된 내용 범위와 주요 변경 내용 목록에서 Az 모듈을 사용하려면 추가 수정이 필요할 수 있습니다.

스크립트가 AzureRM 6.13.2에서 작동하지 않으면 AzureRM 5.x에서 6.x로 마이그레이션 가이드에 따라 해당 스크립트를 업데이트합니다. 이전 버전의 AzureRM 모듈을 사용하는 경우 각 주 버전에 사용할 수 있는 마이그레이션 가이드가 있습니다.

이 권장 옵션은 AzureRM 스크립트를 Az로 마이그레이션하는 데 필요한 작업을 최소화합니다.

AzureRM에서 Az로의 마이그레이션 도구 키트를 사용하면 스크립트를 수정하기 전과 Az PowerShell 모듈을 설치하기 전에 스크립트에서 수행될 변경 사항을 결정하는 계획을 생성할 수 있습니다.

AzureRM에서 Az PowerShell 모듈로 PowerShell 스크립트를 자동으로 마이그레이션하는 빠른 시작에서는 AzureRM에서 Az PowerShell 모듈로 PowerShell 스크립트를 자동으로 업데이트하는 전체 프로세스를 안내합니다.

옵션 2: Enable-AzureRmAlias와 함께 호환성 모드 사용

Az 모듈에는 새 구문으로 업데이트하는 동안 기존 스크립트를 사용하는 데 도움이 되는 호환성 모드가 있습니다. Enable-AzureRmAlias cmdlet은 별칭을 통해 호환성 모드를 사용하도록 설정합니다. 이 모드를 사용하면 Az로의 전체 마이그레이션을 진행하는 동안 최소한의 수정으로 기존 스크립트를 사용할 수 있습니다. 기본적으로 Enable-AzureRmAlias 현재 PowerShell 세션에 대한 호환성 별칭만 사용하도록 설정합니다. 해당 Scope 매개 변수를 사용하여 PowerShell 세션 간에 호환성 별칭을 유지합니다. 자세한 내용은 Enable-AzureRmAlias 참조 설명서를 참조 하세요.

Important

cmdlet 이름이 별칭으로 지정되어 있더라도 여전히 Az cmdlet에 대한 새(또는 이름이 바뀐) 매개 변수가 있거나 반환 값이 변경되었을 수 있습니다. 별칭이 마이그레이션을 처리하도록 설정할 수 있는 것은 아닙니다. 스크립트에 업데이트가 필요할 수 있는 위치를 찾으려면 전체 호환성이 손상되는 변경 목록을 참조하세요.

Enable-AzureRmAlias 지원은 AzureRM PowerShell 모듈의 사용 중단으로 더 이상 사용되지 않습니다.

다음 단계