Az.Tools.Migration PowerShell 모듈 개요
Az.Tools.Migration PowerShell 모듈은 이전 AzureRM 모듈에서 Azure 관리에 권장되는 최신 Az 모듈로의 전환을 용이하게 합니다.
Important
AzureRM PowerShell 모듈은 2024년 2월 29일부터 더 이상 사용되지 않습니다.
Microsoft는 특히 원래 AzureRM용으로 작성된 스크립트를 업데이트하는 데 필요한 노력과 관련하여 고객 피드백에 대한 응답으로 Az.Tools.Migration을 도입했습니다. 많은 고객이 Azure 환경에 대한 복잡한 스크립트를 만드는 데 투자했음을 인식하여 마이그레이션 프로세스를 간소화하고 자동화하기 위해 Az.Tools.Migration 을 만들었으므로 스크립트 업그레이드 중에 수동 워크로드 및 오류 가능성이 줄어듭니다.
Az.Tools.Migration 모듈을 사용하는 방법
Az.Tools.Migration을 사용하는 프로세스에는 다음과 같은 몇 가지 단계가 포함됩니다.
AzureRM 버전 6.13.1로 업데이트: Az.Tools.Migration을 사용하기 전에 사용자는 스크립트가 Az 모듈로 마이그레이션하기 전 마지막 버전인 AzureRM 버전 6.13.1로 업데이트되었는지 확인해야 합니다.
Az.Tools.Migration 설치: 명령을 사용하여 PowerShell 갤러리 모듈을
Install-Module -Name Az.Tools.Migration설치할 수 있습니다.업그레이드 계획 생성: cmdlet은
New-AzUpgradeModulePlan업그레이드 계획을 생성합니다. 기존 스크립트는 변경하지 않지만 업데이트가 필요한 특정 파일 및 오프셋 지점을 자세히 설명하는 계획을 만들어 업그레이드 경로를 제공합니다. 이 cmdlet은 FilePath 및 DirectoryPath와 같은 매개 변수를 사용하여 특정 스크립트 또는 폴더를 대상으로 합니다.업그레이드 계획 검토: 업그레이드를 실행하기 전에 스플래팅을 사용하는 명령과 같이 자동 업그레이드를 방지할 수 있는 잠재적인 문제에 대한 계획을 검토하고 필요한 경우 수동으로 수정하는 것이 중요합니다.
업그레이드 수행: 문제를 검토하고 해결한 후에는 cmdlet을 사용하여 실제 업그레이드가
Invoke-AzUpgradeModulePlan수행됩니다. 이 cmdlet은 기존 파일을 수정하거나 이름에 추가된 새 파일에_az_upgraded변경 내용을 저장하여 원래 스크립트를 유지할 수 있습니다.
원활한 마이그레이션을 보장하려면 이 옵션과 함께 사용하지 않을 경우 cmdlet이 파괴적일 수 있으므로 Invoke-AzUpgradeModulePlan 업그레이드를 수행하기 전에 스크립트를 -FileEditMode SaveChangesToNewFiles 백업하는 것이 좋습니다.
사용자는 azure-powershell-migration을 위해 GitHub 리포지토리에서 마이그레이션 프로세스에 대한 피드백을 제공하거나 문제를 보고하는 것이 좋습니다.