다음을 통해 공유

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를 사용하는 대신 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 스크립트를 자동으로 마이그레이션 빠른 시작은 PowerShell 스크립트를 AzureRM에서 Az PowerShell 모듈로 자동 업데이트하는 전체 프로세스를 안내합니다.

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

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

Important

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

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

다음 단계