Instalar o módulo AZ do PowerShell para Azure Stack HubInstall PowerShell Az module for Azure Stack Hub

Este artigo explica como instalar os Azure PowerShell AZ e os módulos de administrador de Hub Azure Stack compatíveis usando o PowerShellGet.This article explains how to install the Azure PowerShell Az and compatible Azure Stack Hub administrator modules using PowerShellGet. Os módulos AZ podem ser instalados em plataformas Windows, macOS e Linux.The Az modules can be installed on Windows, macOS, and Linux platforms.

Você também pode executar os módulos AZ para Azure Stack Hub em um contêiner do Docker.You can also run the Az modules for Azure Stack Hub in a Docker container. Para obter instruções, consulte usar o Docker para executar o PowerShell para Azure Stack Hub.For instructions, see Use Docker to run PowerShell for Azure Stack Hub.

Se você quiser instalar o módulo AzureRM (módulos de recursos do PowerShell) para o Hub Azure Stack, consulte instalar o módulo AzureRM do PowerShell para o hub Azure Stack.If you would like to install PowerShell Resource Modules (AzureRM) module for Azure Stack Hub, see Install PowerShell AzureRM module for Azure Stack Hub.

Importante

Provavelmente não haverá novas versões de módulo dos módulos de recursos do Azure.There will likely not be new Azure Resource Modules module releases. Os módulos de módulos de recursos do Azure estão em suporte apenas para correções críticas.The Azure Resource Modules modules are under support for critical fixes only. No futuro, só haverá AZ releases para Azure Stack Hub.Going forward there will only be Az releases for Azure Stack Hub.

Você pode usar perfis de API para especificar os pontos de extremidade compatíveis para os provedores de recursos do Hub de Azure Stack.You can use API profiles to specify the compatible endpoints for the Azure Stack Hub resource providers.

Os perfis de API fornecem uma maneira de gerenciar diferenças de versão entre o Azure e o Hub de Azure Stack.API profiles provide a way to manage version differences between Azure and Azure Stack Hub. Um perfil de versão de API é um conjunto de módulos Azure Resource Manager PowerShell com versões de API específicas.An API version profile is a set of Azure Resource Manager PowerShell modules with specific API versions. Cada plataforma de nuvem tem um conjunto de perfis de versão de API com suporte.Each cloud platform has a set of supported API version profiles. Por exemplo, Azure Stack Hub dá suporte a uma versão de perfil específica, como 2019-03-01-híbrido.For example, Azure Stack Hub supports a specific profile version such as 2019-03-01-hybrid. Quando você instala um perfil, o Azure Resource Manager módulos do PowerShell que correspondem ao perfil especificado são instalados.When you install a profile, the Azure Resource Manager PowerShell modules that correspond to the specified profile are installed.

Você pode instalar Azure Stack módulos AZ do PowerShell compatíveis com o Hub em cenários conectados à Internet, parcialmente conectados ou desconectados.You can install Azure Stack Hub compatible PowerShell Az modules in Internet-connected, partially connected, or disconnected scenarios. Este artigo orienta você pelas instruções detalhadas para esses cenários.This article walks you through the detailed instructions for these scenarios.

1. verifique seus pré-requisitos1. Verify your prerequisites

Os módulos AZ têm suporte no Hub Azure Stack com a atualização 2002 ou posterior e com os hotfixes atuais instalados.Az modules are supported on Azure Stack Hub with Update 2002 or later and with the current hotfixes installed. Consulte as notas de versão do Hub Azure Stack para obter mais informações.Please see the Azure Stack Hub release notes for more information.

Os módulos AZ Azure PowerShell funcionam com o PowerShell 5,1 ou superior no Windows, ou PowerShell Core 6. x e posterior em todas as plataformas.The Azure PowerShell Az modules work with PowerShell 5.1 or higher on Windows, or PowerShell Core 6.x and later on all platforms. Você deve instalar a versão mais recente do PowerShell Core disponível para seu sistema operacional.You should install the latest version of PowerShell Core available for your operating system. Azure PowerShell não tem requisitos adicionais quando executado no PowerShell Core.Azure PowerShell has no additional requirements when run on PowerShell Core.

Para verificar sua versão do PowerShell, execute o comando:To check your PowerShell version, run the command:

$PSVersionTable.PSVersion

Pré-requisitos para o WindowsPrerequisites for Windows

Para usar o Azure PowerShell no PowerShell 5.1 no Windows:To use Azure PowerShell in PowerShell 5.1 on Windows:

  1. Atualize para o Windows PowerShell 5.1 se necessário.Update to Windows PowerShell 5.1 if needed. Se você estiver usando o Windows 10, você já tem o PowerShell 5.1 instalado.If you're on Windows 10, you already have PowerShell 5.1 installed.
  2. Instale o .NET Framework 4.7.2 ou posterior.Install .NET Framework 4.7.2 or later.
  3. Verifique se tem a versão mais recente do PowerShellGet.Make sure you have the latest version of PowerShellGet. Execute Install-Module PowerShellGet -MinimumVersion 2.2.3 -Force.Run Install-Module PowerShellGet -MinimumVersion 2.2.3 -Force.

2. pré-requisitos para Linux e Mac2. Prerequisites for Linux and Mac

O PowerShell Core 6. x ou versão posterior é necessário.PowerShell Core 6.x or later version is needed. Siga o link para obter instruçõesFollow the link for instructions

3. desinstale as versões existentes dos módulos do PowerShell do hub de Azure Stack3. Uninstall existing versions of the Azure Stack Hub PowerShell modules

Antes de instalar a versão necessária, certifique-se de desinstalar os módulos de recursos do Azure do hub de Azure Stack ou AZ PowerShell instalados anteriormente.Before installing the required version, make sure that you uninstall any previously installed Azure Stack Hub Azure Resource Modules or Az PowerShell modules. Desinstale os módulos usando um dos dois métodos a seguir:Uninstall the modules by using one of the following two methods:

  1. Para desinstalar os módulos existentes do Azure Resource modules e AZ PowerShell modules, feche todas as sessões ativas do PowerShell e execute os seguintes cmdlets:To uninstall the existing Azure Resource Modules 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
    

    Se você encontrar um erro como ' o módulo já está em uso ', feche as sessões do PowerShell que estão usando os módulos e execute novamente o script acima.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. Exclua todas as pastas que começam com Azure , Az ou Azs. das C:\Program Files\WindowsPowerShell\Modules C:\Users\{yourusername}\Documents\WindowsPowerShell\Modules pastas e.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. Excluir essas pastas remove todos os módulos do PowerShell existentes.Deleting these folders removes any existing PowerShell modules.

4. Connected: instalar com conectividade com a Internet4. Connected: Install with internet connectivity

O módulo AZ Azure Stack funcionará Azure Stack Hub 2002 ou posterior.The Azure Stack Az module will work Azure Stack Hub 2002 or later. Além disso, o módulo Azure Stack AZ funcionará com o PowerShell 5,1 ou superior em um computador Windows ou no PowerShell 6. x ou superior em uma plataforma Linux ou macOS.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. O uso dos cmdlets do PowerShellGet é o método de instalação preferencial.Using the PowerShellGet cmdlets is the preferred installation method. Esse método funciona da mesma forma nas plataformas com suporte.This method works the same on the supported platforms.

Execute o seguinte comando em uma sessão do 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

Observação

Azure Stack módulo Hub versão 2.0.0 é uma alteração significativa.Azure Stack Hub module version 2.0.0 is a breaking change. Consulte migrar de AzureRM para Azure PowerShell AZ no Hub Azure Stack para obter detalhes.Refer to the Migrate from AzureRM to Azure PowerShell Az in Azure Stack Hub for details.

Aviso

Você não pode ter os módulos AzureRM (módulos de recursos do Azure) e AZ instalados para o PowerShell 5,1 para Windows ao mesmo tempo.You can't have both the Azure Resource Modules (AzureRM) and Az modules installed for PowerShell 5.1 for Windows at the same time. Se você precisar manter os módulos de recursos do Azure disponíveis no seu sistema, instale o módulo AZ para o PowerShell Core 6. x ou posterior.If you need to keep Azure Resource Modules available on your system, install the Az module for PowerShell Core 6.x or later. Para fazer isso, instale o PowerShell Core 6.x ou posterior e, depois, siga estas instruções em um terminal do PowerShell Core.To do this, install PowerShell Core 6.x or later and then follow these instructions in a PowerShell Core terminal.

5. desconectado: instalar sem conexão com a Internet5. Disconnected: Install without internet connection

Em um cenário desconectado, primeiro você baixa os módulos do PowerShell para um computador que tenha conectividade com a Internet.In a disconnected scenario, you first download the PowerShell modules to a machine that has internet connectivity. Em seguida, você os transfere para a Kit de Desenvolvimento do Azure Stack (ASDK) para instalação.Then, you transfer them to the Azure Stack Development Kit (ASDK) for installation.

Entre em um computador com conectividade com a Internet e use os scripts a seguir para baixar o Azure Resource Manager e Azure Stack pacotes de Hub, dependendo da sua versão do hub de 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.

A instalação tem cinco etapas:Installation has five steps:

  1. Instale o PowerShell do Hub Azure Stack em um computador conectado.Install Azure Stack Hub PowerShell to a connected machine.
  2. Habilite recursos de armazenamento adicionais.Enable additional storage features.
  3. Transporte os pacotes do PowerShell para sua estação de trabalho desconectada.Transport the PowerShell packages to your disconnected workstation.
  4. Inicialize manualmente o provedor do NuGet em sua estação de trabalho desconectada.Manually bootstrap the NuGet provider on your disconnected workstation.
  5. Confirme a instalação do PowerShell.Confirm the installation of PowerShell.

Instalar o PowerShell do hub de Azure StackInstall Azure Stack Hub PowerShell

Azure Stack Hub 2002 ou posterior.Azure Stack Hub 2002 or later.

Você pode usar os módulos de recurso do Azure ou AZ modules.You could either use Azure Resource Modules or Az modules. Para módulos de recursos do Azure, consulte as instruções em instalar o PowerShell AzureRM Module.For Azure Resource Modules, see the instructions at Install PowerShell AzureRM module. O código a seguir salva módulos do repositório online confiável 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

Observação

Em computadores sem uma conexão com a Internet, é recomendável executar o seguinte cmdlet para desabilitar a coleta de dados de telemetria.On machines without an internet connection, we recommend executing the following cmdlet for disabling the telemetry data collection. Você pode enfrentar uma degradação do desempenho dos cmdlets sem desabilitar a coleta de dados de telemetria.You may experience a performance degradation of the cmdlets without disabling the telemetry data collection. Isso é aplicável somente para computadores sem conexões com a InternetThis is applicable only for the machines without internet connections

Disable-AzDataCollection

Adicionar seus pacotes à sua estação de trabalhoAdd your packages to your workstation

  1. Copie os pacotes baixados para um dispositivo USB.Copy the downloaded packages to a USB device.

  2. Entre na estação de trabalho desconectada e copie os pacotes do dispositivo USB para um local na estação de trabalho.Sign in to the disconnected workstation and copy the packages from the USB device to a location on the workstation.

  3. Inicialize manualmente o provedor do NuGet em sua estação de trabalho desconectada.Manually bootstrap the NuGet provider on your disconnected workstation. Para obter instruções, consulte inicializar manualmente o provedor do NuGet em um computador que não está conectado à Internet.For instructions, see Manually bootstrapping the NuGet provider on a machine that isn't connected to the internet.

  4. Registre esse local como o repositório padrão e instale os AzureRM módulos e deste AzureStack repositório: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
    

Confirmar a instalação do PowerShellConfirm the installation of PowerShell

Confirme a instalação executando o seguinte comando:Confirm the installation by running the following command:

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

6. configurar o PowerShell para usar um servidor proxy6. Configure PowerShell to use a proxy server

Em cenários que exigem um servidor proxy para acessar a Internet, primeiro você configura o PowerShell para usar um servidor proxy existente:In scenarios that require a proxy server to access the internet, you first configure PowerShell to use an existing proxy server:

  1. Abra um prompt do PowerShell elevado.Open an elevated PowerShell prompt.

  2. Execute os seguintes comandos: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. usar o módulo AZ7. Use the Az module

Você pode usar os cmdlets e exemplos de código com base nos módulos de recursos do Azure.You can use the cmdlets and code samples based on Azure Resource Modules. No entanto, você vai querer alterar o nome dos módulos e cmdlets.However, you will want to change the name of the modules and cmdlets. Os nomes de módulo foram alterados para que o AzureRM e o Azure se tornem Az e o mesmo para cmdlets.The module names have been changed so that AzureRM and Azure become Az, and the same for cmdlets. Por exemplo, o AzureRM.Compute módulo foi renomeado para Az.Compute . New-AzureRMVMFor example, the AzureRM.Compute module has been renamed to Az.Compute. New-AzureRMVM se tornou New-AzVM e Get-AzureStorageBlob agora é Get-AzStorageBlob.has become New-AzVM, and Get-AzureStorageBlob is now Get-AzStorageBlob.

Para obter uma discussão mais completa e diretrizes para mover o script AzurRM para AZ e interromper alterações no módulo AZ Azure Stack Hub, consulte migrar de AzureRM para 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.

Próximas etapasNext steps