다음을 통해 공유

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

  • 아티클

경고

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 사용하는 대신 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 참조 설명서를 참조하세요.

중요하다

cmdlet 이름에 별칭이 지정되어 있더라도 Az cmdlet에는 새롭게 추가된(또는 이름이 변경된) 매개 변수나 변경된 반환 값이 있을 가능성이 여전히 있습니다. 별칭이 마이그레이션을 자동으로 처리해줄 것이라고 기대하지 마세요. 스크립트에 업데이트가 필요할 수 있는 위치를 찾으려면 전체 주요 변경 내용 목록 참조하세요.

Enable-AzureRmAlias 지원은 AzureRM PowerShell 모듈이 사용 중단되어도 중단되지 않습니다.

다음 단계