Azure Powershell 설치Install Azure PowerShell

이 문서에서는 PowerShellGet을 사용하여 Azure PowerShell 모듈을 설치하는 방법에 대해 설명합니다.This article explains how to install the Azure PowerShell modules using PowerShellGet. 이러한 지침은 Windows, macOS 및 Linux 플랫폼에서 작동합니다.These instructions work on Windows, macOS, and Linux platforms.

Azure PowerShell은 Azure Cloud Shell에서도 사용할 수 있으며, 이제 Docker 이미지에도 미리 설치되어 있습니다.Azure PowerShell is also available in Azure Cloud Shell and is now preinstalled in Docker images.

요구 사항Requirements

참고

모든 플랫폼에서 Azure PowerShell과 함께 사용할 것을 권장하는 PowerShell 버전은 PowerShell 7.x 이상입니다.PowerShell 7.x and later is the recommended version of PowerShell for use with Azure PowerShell on all platforms.

Azure PowerShell은 모든 플랫폼에서 PowerShell 6.2.4 이상과 함께 작동합니다.Azure PowerShell works with PowerShell 6.2.4 and later on all platforms. Windows에서는 PowerShell 5.1에서도 지원됩니다.It is also supported with PowerShell 5.1 on Windows. 사용하는 운영 체제에 제공되는 최신 버전의 PowerShell을 설치합니다.Install the latest version of PowerShell available for your operating system. PowerShell 6.2.4 이상에서 실행하는 경우 Azure PowerShell과 관련된 추가 요구 사항이 없습니다.Azure PowerShell has no additional requirements when run on PowerShell 6.2.4 and later.

PowerShell 버전을 확인하려면 다음 명령을 실행합니다.To check your PowerShell version, run the command:

$PSVersionTable.PSVersion

Windows의 PowerShell 5.1에서 Azure PowerShell을 사용하려면 다음을 수행합니다.To use Azure PowerShell in PowerShell 5.1 on Windows:

  1. Windows PowerShell 5.1로 업데이트합니다.Update to Windows PowerShell 5.1. Windows 10 버전 1607 이상을 사용하는 경우 PowerShell 5.1이 이미 설치되어 있습니다.If you're on Windows 10 version 1607 or higher, you already have PowerShell 5.1 installed.
  2. .NET Framework 4.7.2 이상을 설치합니다.Install .NET Framework 4.7.2 or later.
  3. 최신 버전의 PowerShellGet이 있는지 확인합니다.Make sure you have the latest version of PowerShellGet. Install-Module -Name PowerShellGet -Force을 실행합니다.Run Install-Module -Name PowerShellGet -Force.

Azure PowerShell 모듈 설치Install the Azure PowerShell module

경고

Windows에서 PowerShell 5.1용 AzureRM과 Az 모듈을 동시에 설치할 수 없습니다.We do not support having both the AzureRM and Az modules installed for PowerShell 5.1 on Windows at the same time. 시스템에서 AzureRM을 사용할 수 있도록 유지해야 하는 경우 PowerShell 6.2.4 이상용 Az 모듈을 설치합니다.If you need to keep AzureRM available on your system, install the Az module for PowerShell 6.2.4 or later.

기본 설치 방법은 PowerShellGet cmdlet을 사용하는 것입니다.Using the PowerShellGet cmdlets is the preferred installation method. 현재 사용자에 대해서만 Az 모듈을 설치합니다.Install the Az module for the current user only. 이는 추천되는 설치 방법입니다.This is the recommended installation scope. 이 방법은 Windows, macOS 및 Linux 플랫폼에서 동일하게 작동합니다.This method works the same on Windows, macOS, and Linux platforms. PowerShell 세션에서 다음 명령을 실행합니다.Run the following command from a PowerShell session:

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (Get-Module -Name AzureRM -ListAvailable)) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Scope CurrentUser
}

기본적으로 PowerShell 갤러리는 PowerShellGet에 대한 신뢰할 수 있는 리포지토리로 구성되지 않습니다.By default, the PowerShell gallery isn't configured as a trusted repository for PowerShellGet. PSGallery를 처음 사용할 때는 다음과 같은 메시지가 표시됩니다.The first time you use the PSGallery you see the following prompt:

Untrusted repository

You are installing the modules from an untrusted repository. If you trust this repository, change
its InstallationPolicy value by running the `Set-PSRepository` cmdlet.

Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):

설치를 계속하려면 Yes 또는 Yes to All로 답변합니다.Answer Yes or Yes to All to continue with the installation.

시스템의 모든 사용자에 대해 모듈을 설치하려면 관리자 권한이 필요합니다.Installing the module for all users on a system requires elevated privileges. Windows에서 관리자 권한으로 실행을 사용하여 PowerShell 세션을 시작하거나 macOS 또는 Linux에서 sudo 명령을 사용합니다.Start the PowerShell session using Run as administrator in Windows or use the sudo command on macOS or Linux:

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (Get-Module -Name AzureRM -ListAvailable)) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Scope AllUsers
}

Az 모듈은 Azure PowerShell cmdlet의 롤업 모듈입니다.The Az module is a rollup module for the Azure PowerShell cmdlets. 이 모듈을 설치하면 갤러리의 모든 사용 가능한 Az PowerShell 모듈이 다운로드되고, cmdlet을 사용할 수 있게 됩니다.Installing it downloads all of the generally available Az PowerShell modules, and makes their cmdlets available for use.

오프라인 설치Install offline

일부 환경에서는 PowerShell 갤러리에 연결할 수 없습니다.In some environments, it's not possible to connect to the PowerShell Gallery. 이러한 경우에도 다음 방법 중 하나를 사용하여 오프라인으로 설치할 수 있습니다.In those situations, you can still install offline using one of these methods:

  • 모듈을 네트워크의 다른 위치에 다운로드하여 이 모듈을 네트워크의 설치 원본으로 사용합니다.Download the modules to another location in your network and use that as an installation source. 이 방법을 사용하면 단일 서버 또는 파일 공유에서 PowerShell 모듈을 캐시하여 PowerShellGet을 사용하여 연결이 끊긴 시스템에 배포할 수 있습니다.This method allows you to cache PowerShell modules on a single server or file share to be deployed with PowerShellGet to any disconnected systems. 로컬 PowerShellGet 리포지토리로 작업을 통해 로컬 리포지토리를 설정하고 연결이 끊어진 시스템에 설치하는 방법을 알아봅니다.Learn how to set up a local repository and install on disconnected systems with Working with local PowerShellGet repositories.

  • 네트워크에 연결된 컴퓨터에 Azure PowerShell MSI를 다운로드한 다음, PowerShell 갤러리에 액세스하지 않고 설치 관리자를 시스템에 복사합니다.Download the Azure PowerShell MSI to a machine connected to the network, and then copy the installer to systems without access to PowerShell Gallery. MSI 설치 관리자는 Windows의 PowerShell 5.1에서만 작동합니다.Keep in mind that the MSI installer only works for PowerShell 5.1 on Windows.

  • Save-Module을 사용하여 모듈을 파일 공유에 저장하거나 다른 소스에 저장하고 다른 컴퓨터에 수동으로 복사합니다.Save the module with Save-Module to a file share, or save it to another source and manually copy it to other machines:

    Save-Module -Name Az -Path '\\server\share\PowerShell\modules' -Force
    

문제 해결Troubleshooting

Azure PowerShell 모듈을 설치할 때 나타나는 몇 가지 일반적인 문제는 다음과 같습니다.Here are some common problems seen when installing the Azure PowerShell module. 여기에 나열되지 않은 문제가 발생하면 GitHub에서 문제를 제출하세요.If you experience a problem not listed here, file an issue on GitHub.

프록시 연결 차단Proxy blocks connection

Install-Module에서 PowerShell 갤러리에 연결할 수 없다는 오류가 발생하면 프록시를 지원하고 있을 수 있습니다.If you get errors from Install-Module that indicate the PowerShell Gallery is unreachable, you may be behind a proxy. 운영 체제와 네트워크 환경에 따라 시스템 수준 프록시 구성에 대한 요구 사항이 다릅니다.Different operating systems and network environment have different requirements for configuring a system-wide proxy. 프록시 설정 및 환경에 맞게 구성하는 방법에 대해서는 시스템 관리자에게 문의하세요.Contact your system administrator for your proxy settings and how to configure them for your environment.

PowerShell 자체는 이 프록시를 자동으로 사용하도록 구성되지 않을 수 있습니다.PowerShell itself may not be configured to use this proxy automatically. PowerShell 5.1 이상에서는 다음 명령을 사용하여 프록시를 사용하도록 PowerShell 세션을 구성합니다.With PowerShell 5.1 and later, configure the PowerShell session to use a proxy using the following commands:

$webClient = New-Object System.Net.WebClient
$webClient.Proxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials

운영 체제 자격 증명이 올바르게 구성되면 이 구성에서 프록시를 통해 PowerShell 요청을 라우팅합니다.If your operating system credentials are configured correctly, this configuration routes PowerShell requests through the proxy. 이 설정이 세션 간에 유지되도록 하려면 명령을 PowerShell 프로필에 추가합니다.To have this setting persist between sessions, add the commands to your PowerShell profile.

패키지를 설치하려면 프록시에서 다음 주소에 대한 HTTPS 연결을 허용해야 합니다.To install the package, your proxy needs to allow HTTPS connections to the following address:

  • https://www.powershellgallery.com

로그인Sign in

Azure PowerShell을 사용하여 작업을 시작하려면 Azure 자격 증명으로 로그인합니다.To start working with Azure PowerShell, sign in with your Azure credentials.

# Connect to Azure with a browser sign in token
Connect-AzAccount

참고

모듈 자동 로딩을 비활성화한 경우 Import-Module -Name Az을 사용하여 모듈을 수동으로 가져옵니다.If you've disabled module autoloading, manually import the module with Import-Module -Name Az. 모듈 구조화 방식으로 인해 몇 초 정도 걸릴 수 있습니다.Because of the way the module is structured, this can take a few seconds.

모든 새 PowerShell 세션에 대해 이러한 단계를 반복해야 합니다.You'll need to repeat these steps for every new PowerShell session you start. PowerShell 세션 간에 Azure 로그인을 유지하는 방법을 보려면 PowerShell 세션 간에 사용자 자격 증명 유지를 참조하세요.To learn how to persist your Azure sign in across PowerShell sessions, see Persist user credentials across PowerShell sessions.

Azure PowerShell 모듈 업데이트Update the Azure PowerShell module

PowerShell 모듈을 업데이트하려면 모듈을 설치하는 데 사용한 것과 동일한 방법을 사용해야 합니다.To update any PowerShell module, you should use the same method used to install the module. 예를 들어 처음에 Install-Module을 사용한 경우 Update-Module을 사용하여 최신 버전을 가져와야 합니다.For example, if you originally used Install-Module, then you should use Update-Module to get the latest version. 처음에 MSI 패키지를 사용한 경우 새 MSI 패키지를 다운로드하여 설치해야 합니다.If you originally used the MSI package then you should download and install the new MSI package.

PowerShellGet cmdlet은 MSI 패키지에서 설치된 모듈을 업데이트할 수 없습니다.The PowerShellGet cmdlets cannot update modules that were installed from an MSI package. MSI 패키지는 PowerShellGet을 사용하여 설치한 모듈을 업데이트하지 않습니다.MSI packages do not update modules that were installed using PowerShellGet. PowershellGet을 사용하여 업데이트하는 데 문제가 있는 경우 업데이트하는 대신 다시 설치해야 합니다.If you have any issues updating using PowershellGet, then you should reinstall, rather than update. 다시 설치는 설치와 동일한 방식으로 수행되지만 -Force 매개 변수를 추가해야 합니다.Reinstalling is done the same way as installing, but you need to add the -Force parameter:

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (Get-Module -Name AzureRM -ListAvailable)) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Force
}

MSI 기반 설치와 달리 PowerShellGet을 사용하여 설치하거나 업데이트해도 시스템에 있을 수 있는 이전 버전은 제거되지 않습니다.Unlike MSI-based installations, installing or updating using PowerShellGet does not remove older versions that may exist on your system. 시스템에서 이전 버전의 Azure PowerShell을 제거하려면 Azure PowerShell 모듈 제거를 참조하세요.To remove old versions of Azure PowerShell from your system, see Uninstall the Azure PowerShell module. MSI 기반 설치에 대한 자세한 내용은 MSI를 사용하여 Azure PowerShell 설치를 참조하세요.For more information about MSI-based installations, see Install Azure PowerShell with an MSI.

여러 버전의 Azure PowerShell 사용Use multiple versions of Azure PowerShell

Azure PowerShell은 버전을 2개 이상 설치할 수 없습니다.It's possible to install more than one version of Azure PowerShell. 여러 버전의 Azure PowerShell이 설치되어 있는지 확인하려면 다음 명령을 사용합니다.To check if you have multiple versions of Azure PowerShell installed, use the following command:

Get-InstalledModule -Name Az -AllVersions | Select-Object -Property Name, Version

Azure PowerShell의 버전을 제거하려면 Azure PowerShell 모듈 제거를 참조합니다.To remove a version of Azure PowerShell, see Uninstall the Azure PowerShell module.

모듈 버전이 두 개 이상인 경우 모듈 자동 로드 및 Import-Module이 기본적으로 최신 버전을 로드합니다.If you have more than one version of the module installed, module autoload and Import-Module load the latest version by default.

-RequiredVersion 매개 변수를 사용하여 특정 버전의 Az 모듈을 설치하거나 로드할 수 있습니다.You can install or load a specific version of the Az module using the -RequiredVersion parameter:

# Install Az version 3.6.1
Install-Module -Name Az -RequiredVersion 3.6.1
# Load Az version 3.6.1
Import-Module -Name Az -RequiredVersion 3.6.1

PowerShellGet에서 여러 리포지토리 사용Use multiple repositories with PowerShellGet

시스템의 PowerShellGet에 리포지토리를 추가하고 그 중 2개 이상에서 Az 모듈을 찾을 수 있는 경우 Repository 매개 변수가 필요합니다.The Repository parameter is required if you have added additional repositories to PowerShellGet on your system and the Az module can be found in more than one of them.

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (Get-Module -Name AzureRM -ListAvailable)) {
    Write-Warning -Message 'Az module not installed. Having both the AzureRM and Az modules installed at the same time is not supported.'
} else {
    Install-Module -Name Az -Repository PSGallery -AllowClobber -Force
}

피드백 제공Provide feedback

버그가 Azure PowerShell에 있으면 GitHub에서 문제를 제기하세요.If you find a bug in Azure PowerShell, file an issue on GitHub. 명령줄에서 피드백을 제공하려면 Send-Feedback cmdlet을 사용해 보세요.To provide feedback from the command line, use the Send-Feedback cmdlet.

다음 단계Next Steps

Azure PowerShell 모듈 및 모듈의 기능에 대해 자세히 알아보려면, Azure PowerShell 시작을 참조하세요.To learn more about the Azure PowerShell modules and their features, see Get Started with Azure PowerShell. Azure PowerShell에 익숙하고 AzureRM에서 마이그레이션해야 하는 경우 AzureRM에서 Az로 마이그레이션을 참조하세요.If you're familiar with Azure PowerShell and need to migrate from AzureRM, see Migrate from AzureRM to Az.