영어로 읽기

다음을 통해 공유


Windows에 Azure CLI 설치

CLI(Azure 명령줄 인터페이스)는 Windows 컴퓨터에 로컬로 설치할 수 있는 플랫폼 간 명령줄 도구입니다. Windows용 Azure CLI를 사용하여 Azure에 연결하고 Azure 리소스에서 관리 명령을 실행할 수 있습니다. 또한 Windows용 Azure CLI는 Azure Cloud Shell을 통해 브라우저에서 사용하거나 Docker 컨테이너 내부에서 실행할 수도 있습니다.

Windows의 경우 Azure CLI는 MSI 또는 ZIP 패키지를 통해 설치되며, 이를 통해 CMD(Windows 명령 프롬프트) 또는 PowerShell을 통해 CLI에 액세스할 수 있습니다. WSL(Linux용 Windows 하위 시스템 설치)을 수행하는 경우 Linux 배포판에 패키지를 사용할 수 있습니다. 지원되는 패키지 관리자 목록 또는 WSL에서 수동으로 설치하는 방법은 주 설치 페이지를 참조하세요.

Windows에서 Azure CLI를 설치하는 네 가지 방법이 있습니다.

Azure CLI의 현재 버전은 2.66.0입니다. 최신 릴리스에 대한 자세한 내용은 릴리스 정보를 참조하세요. 설치된 버전을 찾고 업데이트해야 하는지 확인하려면 az 버전을 실행합니다.

설치 또는 업데이트

MSI 및 ZIP 배포 가능 파일은 Windows에서 Azure CLI를 설치하거나 업데이트하는 데 사용됩니다. MSI는 기존 버전을 업데이트하므로 MSI 설치 관리자를 사용하기 전에 현재 버전을 제거할 필요가 없습니다.

중요

설치가 완료되면 Azure CLI를 사용하려면 활성 터미널 창을 닫고 다시 열어야 합니다.

최신 버전

Azure CLI의 최신 릴리스를 다운로드하여 설치합니다. 설치 관리자가 컴퓨터를 변경할 수 있는지 묻는 메시지가 표시되면 "예" 상자를 선택합니다.

이전에 Azure CLI를 설치한 경우 32비트 또는 64비트 MSI를 실행하면 기존 설치를 덮어씁 수 있습니다.

특정 버전

원하는 경우 URL을 사용하여 특정 버전의 Azure CLI를 다운로드할 수 있습니다.

특정 버전에 대한 MSI 설치 관리자를 다운로드하려면 URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi (32비트) 또는 https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64비트)에서 버전 세그먼트를 변경합니다.

예를 들어 Azure CLI 버전 2.51.0의 32비트 MSI를 설치하려면 URL이 됩니다 https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi. 해당 64비트 설치는 다음과 입니다 https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi.

사용 가능한 Azure CLI 버전은 Azure CLI 릴리스 정보에서 찾을 수 있습니다. 64비트 MSI는 버전 2.51.0에서 사용할 수 있습니다.

Azure CLI 실행

이제 Windows 명령 프롬프트 또는 PowerShell에서 명령을 사용하여 az Azure CLI를 실행할 수 있습니다.

설치 문제 해결

다음은 Windows에 Azure CLI를 설치할 때 발생하는 몇 가지 일반적인 문제입니다. 여기서 다루지 않은 문제가 발생하면 GitHub에서 문제를 제출하세요.

PATH 변수가 설정되지 않음

이 문제의 가장 일반적인 원인은 설치 후 활성 터미널 창이 다시 시작되지 않았기 때문에 발생합니다. 활성 터미널 창을 닫고 다시 엽니다.

프록시 연결 차단

프록시에서 연결을 차단하여 MSI 설치 관리자를 다운로드할 수 없는 경우 프록시를 올바르게 구성했는지 확인합니다. Windows 10의 경우 이러한 설정은 Settings > Network & Internet > Proxy 창에서 관리됩니다. 필요한 설정 또는 머신에서 구성을 관리할 수 있거나 고급 설정이 필요한 경우에 대해 시스템 관리자에게 문의하세요.

중요

이러한 설정은 PowerShell 또는 명령 프롬프트 모두에서 CLI를 사용하여 Azure 서비스에 액세스할 수 있어야 합니다. PowerShell에서 다음 명령을 사용하여 이 작업을 수행합니다.

(New-Object System.Net.WebClient).Proxy.Credentials = `
  [System.Net.CredentialCache]::DefaultNetworkCredentials

MSI를 가져오려면 프록시에서 다음 주소에 대한 HTTPS 연결을 허용해야 합니다.

  • https://aka.ms/
  • https://azcliprod.blob.core.windows.net/

자세한 내용은 Azure CLI 문제 해결 가이드의 프록시 뒤에 있는 작업을 참조하세요.

응답 시간이 느림

64비트 Azure CLI로 마이그레이션 참조

PowerShell에서 탭 완성 사용

"Azure CLI 완료자"라고도 하는 탭 완성은 입력에 대한 완성을 제공하여 힌트를 제공하고 검색을 사용하도록 설정하며 입력 입력 속도를 향상합니다. 명령 이름, 명령 그룹 이름, 매개 변수 및 특정 매개 변수 값은 Tab 키를 눌러 명령줄에 자동으로 삽입될 수 있습니다.

탭 완성은 Azure Cloud Shell 및 대부분의 Linux 배포판에서 기본적으로 사용하도록 설정됩니다. Azure CLI 버전 2.49부터 PowerShell에서 Azure CLI에 대한 탭 완성을 사용하도록 설정할 수 있습니다. 다음 단계를 수행합니다.

  1. 변수 $PROFILE에 저장된 프로필을 만들거나 편집합니다. 가장 간단한 방법은 PowerShell에서 실행하는 notepad $PROFILE 것입니다. 자세한 내용은 프로필을 만드는 방법프로필 및 실행 정책을 참조하세요.

  2. PowerShell 프로필에 다음 코드를 추가합니다.

    Register-ArgumentCompleter -Native -CommandName az -ScriptBlock {
        param($commandName, $wordToComplete, $cursorPosition)
        $completion_file = New-TemporaryFile
        $env:ARGCOMPLETE_USE_TEMPFILES = 1
        $env:_ARGCOMPLETE_STDOUT_FILENAME = $completion_file
        $env:COMP_LINE = $wordToComplete
        $env:COMP_POINT = $cursorPosition
        $env:_ARGCOMPLETE = 1
        $env:_ARGCOMPLETE_SUPPRESS_SPACE = 0
        $env:_ARGCOMPLETE_IFS = "`n"
        $env:_ARGCOMPLETE_SHELL = 'powershell'
        az 2>&1 | Out-Null
        Get-Content $completion_file | Sort-Object | ForEach-Object {
            [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", $_)
        }
        Remove-Item $completion_file, Env:\_ARGCOMPLETE_STDOUT_FILENAME, Env:\ARGCOMPLETE_USE_TEMPFILES, Env:\COMP_LINE, Env:\COMP_POINT, Env:\_ARGCOMPLETE, Env:\_ARGCOMPLETE_SUPPRESS_SPACE, Env:\_ARGCOMPLETE_IFS, Env:\_ARGCOMPLETE_SHELL
    }
    
  3. 메뉴에서 사용 가능한 모든 옵션을 표시하려면 PowerShell 프로필에 추가 Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete 합니다.

Azure CLI 업데이트

버전 2.11.0부터 Azure CLI는 최신 버전으로 업데이트하는 도구 내 명령을 제공합니다.

az upgrade

또한 이 명령은 기본적으로 설치된 모든 확장을 업데이트합니다. 자세한 az upgrade 옵션은 명령 참조 페이지를 참조 하세요. 2.11.0 이전 Azure CLI 버전의 경우 Azure CLI 설치에 설명된 대로 다시 설치하여 업데이트합니다.

ZIP 배포를 사용하는 경우 이전 설치 폴더를 삭제하고 새 버전을 동일한 위치에 추출하세요.

64비트 Azure CLI로 마이그레이션

2.51.0부터 Azure CLI는 성능 향상을 위해 권장되는 64비트 MSI도 제공합니다.

다음 단계에 따라 Azure CLI 64비트로 마이그레이션합니다.

  1. 를 실행 az --version하여 현재 CLI 버전 및 설치된 확장을 확인합니다.
  2. 확장을 다시 설치해야 합니다. 32비트로 되돌리도록 선택하는 경우 이름을 변경하여 현재 확장 폴더 %userprofile%\.azure\cliextensions 의 백업을 수행하는 것이 좋습니다. 이 폴더는 확장을 다시 설치할 때 자동으로 만들어집니다.
  3. 설치 또는 업데이트에 설명된 대로 최신 64비트 설치 관리자를 다운로드하여 설치합니다. 32비트 MSI는 자동으로 제거됩니다.
  4. 를 실행 az extension add --name <extension> --version <version>하여 확장을 설치합니다. 확장을 수동으로 다시 설치하지 않으려면 Azure CLI에서 처음 사용할 때 확장을 설치하라는 메시지를 표시합니다. 확장 설치에 대한 자세한 내용은 확장을 설치하는 방법을 참조 하세요.

마이그레이션 후 문제가 있는 경우 64비트 MSI를 제거하고 32비트 MSI를 다시 설치할 수 있습니다. 32비트 확장 폴더의 백업을 수행한 경우 변경 후 확장 폴더를 복원(이름 바꾸기)합니다.

제거

Azure CLI를 제거하기로 결정한 경우 이동해 주시면 죄송합니다. 제거하기 전에 이 명령을 사용하여 az feedback 개선 또는 수정할 수 있는 사항을 알려주세요. 우리 목표는 Azure CLI를 버그가 없고 사용자에게 친숙하게 만드는 것입니다. 버그를 발견한 경우 GitHub 문제를 제출하면 감사하겠습니다.

Windows "앱 및 기능" 목록에서 Azure CLI를 제거합니다. 제거 방법은 다음과 같습니다.

플랫폼 지침
Windows 11 설정 > 앱 > 설치 앱 시작 >
Windows 10 설정 > 앱 시작 > 앱 > 및 기능
Windows 8 및 Windows 7 시작 > 제어판 > 프로그램 > 프로그램 제거

이 화면에서 프로그램 검색 창에 Azure CLI를 입력합니다. 제거할 프로그램은 Azure용 Microsoft CLI 2.0 으로 나열됩니다. 이 애플리케이션을 선택한 다음, 단추를 선택합니다 Uninstall .

데이터 제거

Azure CLI를 다시 설치할 계획이 없는 경우 C:\Users\<username>\.azure\msal_token_cache.bin 또는 C:\Users\<username>\.azure\msal_token_cache.json에서 해당 데이터를 제거합니다.

다음 단계

이제 Windows에 Azure CLI를 설치했으므로 로그인하는 다양한 방법에 대해 알아봅니다.