Azure Stack 허브 용 PowerShell Az module 설치Install PowerShell Az module for Azure Stack Hub

이 문서에서는 PowerShellGet을 사용 하 여 Azure PowerShell Az 및 compatible Azure Stack Hub 관리자 모듈을 설치 하는 방법을 설명 합니다.This article explains how to install the Azure PowerShell Az and compatible Azure Stack Hub administrator modules using PowerShellGet. Az 모듈은 Windows, macOS 및 Linux 플랫폼에 설치할 수 있습니다.The Az modules can be installed on Windows, macOS, and Linux platforms.

Docker 컨테이너에서 Azure Stack 허브에 대 한 Az 모듈을 실행할 수도 있습니다.You can also run the Az modules for Azure Stack Hub in a Docker container. 지침은 Docker를 사용 하 여 Azure Stack 허브에 대해 PowerShell 실행을 참조 하세요.For instructions, see Use Docker to run PowerShell for Azure Stack Hub.

Azure Stack Hub에 대 한 AzureRM (PowerShell 리소스 모듈) 모듈을 설치 하려면 Azure Stack 허브 용 Powershell AzureRM 모듈 설치를 참조 하세요.If you would like to install PowerShell Resource Modules (AzureRM) module for Azure Stack Hub, see Install PowerShell AzureRM module for Azure Stack Hub.

중요

새 Azure 리소스 모듈 모듈 릴리스가 없을 수도 있습니다.There will likely not be new Azure Resource Modules module releases. Azure 리소스 모듈 모듈은 중요 한 수정 사항만 지원 합니다.The Azure Resource Modules modules are under support for critical fixes only. 앞으로 Azure Stack 허브에 대 한 Az 릴리스만 있습니다.Going forward there will only be Az releases for Azure Stack Hub.

API 프로필 을 사용 하 여 Azure Stack 허브 리소스 공급자에 대해 호환 되는 끝점을 지정할 수 있습니다.You can use API profiles to specify the compatible endpoints for the Azure Stack Hub resource providers.

API 프로필은 Azure와 Azure Stack Hub 간의 버전 차이를 관리 하는 방법을 제공 합니다.API profiles provide a way to manage version differences between Azure and Azure Stack Hub. API 버전 프로필은 특정 API 버전을 사용 하는 Azure Resource Manager PowerShell 모듈 집합입니다.An API version profile is a set of Azure Resource Manager PowerShell modules with specific API versions. 각 클라우드 플랫폼에는 지원 되는 API 버전 프로필 집합이 있습니다.Each cloud platform has a set of supported API version profiles. 예를 들어 Azure Stack 허브는 2019-03-01-하이브리드 와 같은 특정 프로필 버전을 지원 합니다.For example, Azure Stack Hub supports a specific profile version such as 2019-03-01-hybrid. 프로필을 설치 하면 지정 된 프로필에 해당 하는 Azure Resource Manager PowerShell 모듈이 설치 됩니다.When you install a profile, the Azure Resource Manager PowerShell modules that correspond to the specified profile are installed.

인터넷에 연결 되 고 부분적으로 연결 되거나 연결이 끊어진 시나리오에서 Azure Stack 허브 호환 PowerShell Az modules을 설치할 수 있습니다.You can install Azure Stack Hub compatible PowerShell Az modules in Internet-connected, partially connected, or disconnected scenarios. 이 문서에서는 이러한 시나리오에 대 한 자세한 지침을 안내 합니다.This article walks you through the detailed instructions for these scenarios.

1. 필수 구성 요소 확인1. Verify your prerequisites

Az modules 업데이트 2002 이상 및 현재 설치 되어 있는 Azure Stack 허브에서 지원 됩니다.Az modules are supported on Azure Stack Hub with Update 2002 or later and with the current hotfixes installed. 자세한 내용은 Azure Stack Hub 릴리스 정보를 참조 하세요.Please see the Azure Stack Hub release notes for more information.

Azure PowerShell Az modules은 Windows의 PowerShell 5.1 이상 또는 모든 플랫폼에서 PowerShell Core 6.x 이상에서 작동 합니다.The Azure PowerShell Az modules work with PowerShell 5.1 or higher on Windows, or PowerShell Core 6.x and later on all platforms. 운영 체제에 사용할 수 있는 최신 버전의 PowerShell Core 를 설치 해야 합니다.You should install the latest version of PowerShell Core available for your operating system. PowerShell Core에서 실행 하는 경우 Azure PowerShell는 추가 요구 사항이 없습니다.Azure PowerShell has no additional requirements when run on PowerShell Core.

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

$PSVersionTable.PSVersion

Windows에 대 한 필수 구성 요소Prerequisites for Windows

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 if needed. Windows 10을 사용하는 경우 PowerShell 5.1이 이미 설치되어 있습니다.If you're on Windows 10, 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 PowerShellGet -MinimumVersion 2.2.3 -Force을 실행합니다.Run Install-Module PowerShellGet -MinimumVersion 2.2.3 -Force.

2. Linux 및 Mac에 대 한 필수 구성 요소2. Prerequisites for Linux and Mac

PowerShell Core 6.x 이상 버전이 필요 합니다.PowerShell Core 6.x or later version is needed. 지침을 보려면 링크 를 따르세요.Follow the link for instructions

3. 기존 버전의 Azure Stack Hub PowerShell 모듈을 제거 합니다.3. Uninstall existing versions of the Azure Stack Hub PowerShell modules

필요한 버전을 설치 하기 전에 이전에 설치한 Azure Stack 허브 Azure Resource Manager 또는 Az PowerShell 모듈을 제거 해야 합니다.Before installing the required version, make sure that you uninstall any previously installed Azure Stack Hub Azure Resource Manager or Az PowerShell modules. 다음 두 가지 방법 중 하나를 사용 하 여 모듈을 제거 합니다.Uninstall the modules by using one of the following two methods:

  1. 기존 Azure Resource Manager 및 Az PowerShell 모듈을 제거 하려면 모든 활성 PowerShell 세션을 닫고 다음 cmdlet을 실행 합니다.To uninstall the existing Azure Resource Manager and Az PowerShell modules, close all the active PowerShell sessions, and run the following cmdlets:

    Get-Module -Name Azure* -ListAvailable | Uninstall-Module -Force -Verbose -ErrorAction Continue
    Get-Module -Name Azs.* -ListAvailable | Uninstall-Module -Force -Verbose -ErrorAction Continue
    Get-Module -Name Az.* -ListAvailable | Uninstall-Module -Force -Verbose -ErrorAction Continue
    

    ' 모듈이 이미 사용 중입니다. '와 같은 오류가 발생 하는 경우 모듈을 사용 하는 PowerShell 세션을 닫고 위의 스크립트를 다시 실행 합니다.If you hit an error such as 'The module is already in use', close the PowerShell sessions that are using the modules and rerun the above script.

  2. 로 시작 Azure Az 하거나 및 폴더에서 모든 폴더를 삭제 Azs. C:\Program Files\WindowsPowerShell\Modules C:\Users\{yourusername}\Documents\WindowsPowerShell\Modules 합니다.Delete all the folders that start with Azure, Az or Azs. from the C:\Program Files\WindowsPowerShell\Modules and C:\Users\{yourusername}\Documents\WindowsPowerShell\Modules folders. 이러한 폴더를 삭제 하면 기존 PowerShell 모듈이 제거 됩니다.Deleting these folders removes any existing PowerShell modules.

4. 연결 됨: 인터넷에 연결 된 설치4. Connected: Install with internet connectivity

Azure Stack Az module은 허브 2002 이상 Azure Stack 작동 합니다.The Azure Stack Az module will work Azure Stack Hub 2002 or later. 또한 Azure Stack Az module은 Linux 또는 macOS 플랫폼에서 Windows 컴퓨터 또는 PowerShell 6.x 이상의 PowerShell 5.1 이상에서 작동 합니다.In addition, the Azure Stack Az module will work with PowerShell 5.1 or greater on a Windows machine, or PowerShell 6.x or greater on a Linux or macOS platform. 기본 설치 방법은 PowerShellGet cmdlet을 사용하는 것입니다.Using the PowerShellGet cmdlets is the preferred installation method. 이 메서드는 지원 되는 플랫폼에서 동일 하 게 작동 합니다.This method works the same on the supported platforms.

PowerShell 세션에서 다음 명령을 실행합니다.Run the following command from a PowerShell session:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Install-Module -Name Az.BootStrapper -Force -AllowPrerelease
Install-AzProfile -Profile 2019-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 2.0.2-preview -AllowPrerelease

참고

Azure Stack 허브 모듈 버전 2.0.0은 주요 변경 사항입니다.Azure Stack Hub module version 2.0.0 is a breaking change. 자세한 내용은 Azure Stack Hub의 AzureRM에서 Azure PowerShell로 마이그레이션 을 참조 하세요.Refer to the Migrate from AzureRM to Azure PowerShell Az in Azure Stack Hub for details.

경고

Windows 용 PowerShell 5.1에 Azure Resource Manager (AzureRM) 및 Az 모듈을 동시에 설치할 수 없습니다.You can't have both the Azure Resource Manager (AzureRM) and Az modules installed for PowerShell 5.1 for Windows at the same time. Azure Resource Manager를 시스템에서 사용 가능 하 게 유지 해야 하는 경우 PowerShell Core 6.x 이상용 Az module을 설치 합니다.If you need to keep Azure Resource Manager available on your system, install the Az module for PowerShell Core 6.x or later. 이렇게 하려면 Powershell core 6.x 이상을 설치한 후 powershell core 터미널에서 다음 지침을 따릅니다.To do this, install PowerShell Core 6.x or later and then follow these instructions in a PowerShell Core terminal.

5. 연결 끊김: 인터넷에 연결 하지 않고 설치5. Disconnected: Install without internet connection

연결이 끊어진 시나리오에서는 먼저 인터넷에 연결 된 컴퓨터에 PowerShell 모듈을 다운로드 합니다.In a disconnected scenario, you first download the PowerShell modules to a machine that has internet connectivity. 그런 다음 설치를 위해 ASDK Azure Stack Development Kit으로 전송 합니다.Then, you transfer them to the Azure Stack Development Kit (ASDK) for installation.

인터넷에 연결 된 컴퓨터에 로그인 하 고 다음 스크립트를 사용 하 여 Azure Stack 허브 버전에 따라 Azure Resource Manager 및 Azure Stack 허브 패키지를 다운로드 합니다.Sign in to a computer with internet connectivity and use the following scripts to download the Azure Resource Manager and Azure Stack Hub packages, depending on your version of Azure Stack Hub.

설치에는 5 단계가 있습니다.Installation has five steps:

  1. 연결 된 컴퓨터에 Azure Stack 허브 PowerShell을 설치 합니다.Install Azure Stack Hub PowerShell to a connected machine.
  2. 추가 저장소 기능을 사용 하도록 설정 합니다.Enable additional storage features.
  3. 연결 되지 않은 워크스테이션에 PowerShell 패키지를 전송 합니다.Transport the PowerShell packages to your disconnected workstation.
  4. 연결 되지 않은 워크스테이션에서 NuGet 공급자를 수동으로 부트스트랩 합니다.Manually bootstrap the NuGet provider on your disconnected workstation.
  5. PowerShell 설치를 확인 합니다.Confirm the installation of PowerShell.

Azure Stack 허브 PowerShell 설치Install Azure Stack Hub PowerShell

Azure Stack 허브 2002 이상.Azure Stack Hub 2002 or later.

Azure Resource Manager 또는 Az modules를 사용할 수 있습니다.You could either use Azure Resource Manager or Az modules. Azure Resource Manager PowerShell AzureRM 모듈 설치의 지침을 참조 하세요.For Azure Resource Manager, see the instructions at Install PowerShell AzureRM module. 다음 코드는 신뢰할 수 있는 온라인 리포지토리의 모듈을 저장 https://www.powershellgallery.com/ 합니다.The following code saves modules from trustworthy online repository https://www.powershellgallery.com/.

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Install-module -Name PowerShellGet -MinimumVersion 2.2.3 -Force
Import-Module -Name PackageManagement -ErrorAction Stop

$savedModulesPath = "<Path that is used to save the packages>"
Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name Az -Path $savedModulesPath -Force -RequiredVersion 0.10.0-preview
Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureStack -Path $savedModulesPath -Force -RequiredVersion 2.0.2-preview

참고

인터넷에 연결 되지 않은 컴퓨터에서 원격 분석 데이터 수집을 사용 하지 않도록 설정 하기 위해 다음 cmdlet을 실행 하는 것이 좋습니다.On machines without an internet connection, we recommend executing the following cmdlet for disabling the telemetry data collection. 원격 분석 데이터 컬렉션을 사용 하지 않도록 설정 하지 않고 cmdlet의 성능 저하가 발생할 수 있습니다.You may experience a performance degradation of the cmdlets without disabling the telemetry data collection. 인터넷에 연결 되지 않은 컴퓨터에만 적용 됩니다.This is applicable only for the machines without internet connections

Disable-AzDataCollection

워크스테이션에 패키지 추가Add your packages to your workstation

  1. 다운로드 한 패키지를 USB 장치에 복사 합니다.Copy the downloaded packages to a USB device.

  2. 연결 되지 않은 워크스테이션에 로그인 하 고 USB 장치에서 워크스테이션의 위치로 패키지를 복사 합니다.Sign in to the disconnected workstation and copy the packages from the USB device to a location on the workstation.

  3. 연결 되지 않은 워크스테이션에서 NuGet 공급자를 수동으로 부트스트랩 합니다.Manually bootstrap the NuGet provider on your disconnected workstation. 지침은 인터넷에 연결 되지 않은 컴퓨터에서 NuGet 공급자를 수동으로 부트스트랩을 참조 하세요.For instructions, see Manually bootstrapping the NuGet provider on a machine that isn't connected to the internet.

  4. 이 위치를 기본 리포지토리로 등록 하 고 AzureRM 이 리포지토리에서 및 모듈을 설치 합니다 AzureStack .Register this location as the default repository and install the AzureRM and AzureStack modules from this repository:

    # requires -Version 5
    # requires -RunAsAdministrator
    # requires -Module PowerShellGet
    # requires -Module PackageManagement
    
    $SourceLocation = "<Location on the development kit that contains the PowerShell packages>"
    $RepoName = "MyNuGetSource"
    
    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
    
    Register-PSRepository -Name $RepoName -SourceLocation $SourceLocation -InstallationPolicy Trusted
    
    Install-Module -Name AzureStack -Repository $RepoName -RequiredVersion 2.0.2-preview -AllowPrerelease -Scope AllUsers
    
    Install-Module -Name Az -Repository $RepoName -RequiredVersion 0.10.0-preview -AllowPrerelease -Scope AllUsers
    

PowerShell 설치 확인Confirm the installation of PowerShell

다음 명령을 실행 하 여 설치를 확인 합니다.Confirm the installation by running the following command:

Get-Module -Name "Az*" -ListAvailable
Get-Module -Name "Azs*" -ListAvailable

6. 프록시 서버를 사용 하도록 PowerShell 구성6. Configure PowerShell to use a proxy server

프록시 서버에서 인터넷에 액세스 해야 하는 시나리오에서는 먼저 기존 프록시 서버를 사용 하도록 PowerShell을 구성 합니다.In scenarios that require a proxy server to access the internet, you first configure PowerShell to use an existing proxy server:

  1. 관리자 권한 PowerShell 프롬프트를 엽니다.Open an elevated PowerShell prompt.

  2. 다음 명령을 실행합니다.Run the following commands:

    #To use Windows credentials for proxy authentication
    [System.Net.WebRequest]::DefaultWebProxy.Credentials = [System.Net.CredentialCache]::DefaultCredentials
    
    #Alternatively, to prompt for separate credentials that can be used for #proxy authentication
    [System.Net.WebRequest]::DefaultWebProxy.Credentials = Get-Credential
    

7. Az module 사용7. Use the Az module

Azure Resource Manager을 기반으로 하는 cmdlet 및 코드 샘플을 사용할 수 있습니다.You can use the cmdlets and code samples based on Azure Resource Manager. 그러나 모듈 및 cmdlet의 이름을 변경 해야 합니다.However, you will want to change the name of the modules and cmdlets. AzureRM및 Azure가 Az 이 고 cmdlet에 대해 동일한 경우 모듈 이름이 변경 되었습니다.The module names have been changed so that AzureRM and Azure become Az, and the same for cmdlets. 예를 들어 AzureRM.Compute 모듈의 이름이로 바뀌었습니다 Az.Compute . New-AzureRMVMFor example, the AzureRM.Compute module has been renamed to Az.Compute. New-AzureRMVM New-AzVM이 되고, Get-AzureStorageBlob은 이제 Get-AzStorageBlob이 되었습니다.has become New-AzVM, and Get-AzureStorageBlob is now Get-AzStorageBlob.

Azure Stack 허브의 Az module에서 AzurRM 스크립트를 Az로 이동 하는 방법 및 주요 변경 내용에 대 한 자세한 설명과 지침은 AzureRM에서 Azure PowerShell Az로 마이그레이션을 참조 하세요.For a more thorough discussion and guidance for moving AzurRM script to Az and breaking changes in Azure Stack Hub's Az module, see Migrate from AzureRM to Azure PowerShell Az.

알려진 문제Known issues

Az 모듈을 설치할 때 발생 하는 오류Error thrown when installing the Az modules

  • 적용 가능:이 문제는 2002 이상에 적용 됩니다.Applicable: This issue applies to 2002 and later
  • 원인: 모듈을 설치할 때 오류가 throw 됩니다.Cause: When installing the module, an error is thrown. 오류 메시지가 시작 됩니다. Register-PacakgeSource : A parameter cannot be found that matches parameter name. 'PackageManagementProvider'. 또는 오류 메시지에 다음 텍스트가 포함 될 수 있습니다. PackageManagement\Install-Package : Cannot convert value "2.0.1-preview" to type "System.Version". Error: "Input string was not in a correct format."The error message begins: Register-PacakgeSource : A parameter cannot be found that matches parameter name. 'PackageManagementProvider'. Or the error message may include the following text: PackageManagement\Install-Package : Cannot convert value "2.0.1-preview" to type "System.Version". Error: "Input string was not in a correct format."
  • 수정: 동일한 세션에서 다음 cmdlet을 실행 합니다.Remediation: Run the following cmdlet in the same session:
    Install-Module PowershellGet -MinimumumVersion 2.3.0 -Force
    세션을 닫고 새로운 승격 된 PowerShell 세션을 시작 합니다.Close your session and start a new elevated PowerShell session.
  • 발생 빈도: 공통Occurrence: Common

Az module을 설치 하면 Admin 권한이 필요 함 오류가 throw 됩니다.When installing Az module falsely throws Admin rights required error

  • 적용 가능:이 문제는 2002 이상에 적용 됩니다.Applicable: This issue applies to 2002 and later
  • 원인: 관리자 권한 프롬프트에서 모듈을 설치 하는 경우 오류가 발생 합니다.Cause: When installing the module from an elevated prompt, an error is thrown. 오류가 표시 Administrator rights required 됩니다.The error says, Administrator rights required.
  • 수정: 세션을 닫고 새로운 승격 된 PowerShell 세션을 시작 합니다.Remediation: Close your session and start a new elevated PowerShell session. 기존 Az가 없는지 확인 합니다.Make sure there isn't an existing Az. 계정 모듈이 세션에 로드 되었습니다.Accounts module loaded in the session.
  • 발생 빈도: 공통Occurrence: Common

다음 단계Next steps