Windows에 Azure PowerShell 설치

Az PowerShell 모듈은 롤업 모듈입니다. Az PowerShell 모듈을 설치하면 일반적으로 사용 가능한 모듈이 다운로드되고 해당 cmdlet을 사용할 수 있습니다.

Az PowerShell 모듈에 권장되는 설치 방법 및 PowerShell 버전:

  • PowerShell 갤러리 설치
  • PowerShell 버전 7 이상에서 사용

이 문서에서는 PowerShell 갤러리 Windows에 Az PowerShell 모듈을 설치하는 방법을 설명합니다.

필수 조건

  • PowerShell에서 다음 명령을 실행하여 PowerShell 버전을 확인합니다.

    $PSVersionTable.PSVersion
    
  • AzureRM PowerShell 모듈이 설치되어 있는지 확인합니다.

    Get-Module -Name AzureRM -ListAvailable
    

    Important

    AzureRM PowerShell 모듈이 설치된 경우 계속하기 전에 Az 및 AzureRM 공존을 참조하세요.

  • PowerShell 실행 정책을 원격 서명됨 또는 덜 제한적인 정책으로 설정

    • PowerShell 실행 정책을 확인합니다.

      Get-ExecutionPolicy -List
      
    • PowerShell 실행 정책을 원격 서명됨으로 설정합니다.

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
      

    실행 정책에 대한 자세한 내용은 about_Execution_Policies 참조하세요.

설치

Install-Module cmdlet을 사용하여 Az PowerShell 모듈을 설치합니다.

Install-Module -Name Az -Repository PSGallery -Force

Az PowerShell 모듈 업데이트

Update-Module을 사용하여 최신 버전의 Az PowerShell 모듈로 업데이트합니다.

Update-Module -Name Az -Force

Az PowerShell 모듈을 사용하여 Update-Module 업데이트해도 시스템에서 이전 버전의 Az PowerShell 모듈이 제거되지는 않습니다.

제거

Az PowerShell 모듈을 제거하려면 Azure PowerShell 모듈 제거를 참조 하세요.

이 문서에서는 MSI 설치 관리자를 사용하여 Windows에 Az PowerShell 모듈을 설치하는 방법을 설명합니다. MSI 설치 관리자는 방화벽에 의해 PowerShell 갤러리 차단되거나 오프라인 설치 관리자가 필요한 환경에 대해 제공됩니다.

Important

MSI 설치 옵션은 Windows PowerShell 5.1에서 사용할 Az PowerShell 모듈을 설치하는 데만 사용할 수 있습니다.

필수 조건

  • PowerShell에서 다음 명령을 실행하여 PowerShell 버전을 확인합니다.

    $PSVersionTable.PSVersion
    
  • AzureRM PowerShell 모듈이 설치되어 있는지 확인

    Get-Module -Name AzureRM -ListAvailable
    

    Important

    AzureRM PowerShell 모듈이 설치된 경우 계속하기 전에 Az 및 AzureRM 공존을 참조하세요.

  • Windows PowerShell 5.1로 업데이트

  • .NET Framework 4.7.2 이상 설치

  • PowerShell 스크립트 실행을 원격 서명되거나 덜 제한적인 것으로 설정

    • PowerShell 실행 정책을 확인합니다.

      Get-ExecutionPolicy -List
      
    • PowerShell 실행 정책을 원격 서명됨으로 설정합니다.

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
      

    실행 정책에 대한 자세한 내용은 about_Execution_Policies 참조하세요.

설치 및 업데이트

Azure PowerShell용 MSI 패키지는 GitHub에 있습니다.

  1. github.com/Azure/azure-powershell/releases 방문
  2. 최신 Az PowerShell 모듈을 찾습니다. 이름 없이 시간순으로 나열됩니다. 예를 들어 9.5.0
  3. 패치 노트의 끝까지 아래로 스크롤하고 "자산" 옆의 화살표를 클릭하여 MSI 옵션을 표시합니다.
  4. 원하는 Az-Cmdlets MSI를 클릭하여 다운로드를 시작합니다.

설치 관리자는 MSI를 사용하여 설치된 이전 버전의 Az PowerShell 모듈을 자동으로 제거합니다. MSI 패키지는 에 모듈을 설치합니다. "${env:ProgramFiles}\WindowsPowerShell\Modules"

로그인

Az PowerShell 모듈을 사용하여 Azure 리소스 관리를 시작하려면 PowerShell 세션을 시작하고 실행 Connect-AzAccount 하여 Azure에 로그인합니다.

Connect-AzAccount

Azure 계정 로그인 자격 증명을 사용하여 열리는 브라우저 창에 로그인합니다.

시작하는 모든 새 PowerShell 세션에 대해 이 단계를 반복해야 합니다. PowerShell 세션에서 Azure 로그인을 유지하는 방법을 알아보려면 Azure PowerShell 컨텍스트 개체를 참조 하세요.

문제 해결

Az PowerShell 모듈의 일반적인 설치 문제에 대한 해결 방법은 Az PowerShell 모듈의 설치 문제 해결을 참조 하세요.

피드백 제공

Az PowerShell 모듈에 대한 문제를 제출하려면 다음을 참조 하세요. GitHub에서 문제 파일

PowerShell 세션 내에서 피드백을 제공하려면 Send-Feedback cmdlet을 사용합니다.

다음 단계

Az PowerShell 모듈을 사용하여 Azure 리소스를 관리하는 방법에 대한 자세한 내용은 Azure PowerShell 시작을 참조하세요.