Instale o módulo PowerShell Az para O Azure Stack HubInstall PowerShell Az module for Azure Stack Hub

Este artigo explica como instalar o Azure PowerShell Az e compatível com módulos de administrador do Azure Stack Hub utilizando 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 nas plataformas Windows, macOS e Linux.The Az modules can be installed on Windows, macOS, and Linux platforms.

Também pode executar os módulos Az para Azure Stack Hub num recipiente Docker.You can also run the Az modules for Azure Stack Hub in a Docker container. Para obter instruções, consulte Use Docker para executar PowerShell para Azure Stack Hub.For instructions, see Use Docker to run PowerShell for Azure Stack Hub.

Se pretender instalar módulos de recursos PowerShell (AzureRM) para O Azure Stack Hub, consulte o módulo PowerShell AzureRM 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 libertações de módulos de recursos Azure.There will likely not be new Azure Resource Modules module releases. Os módulos Azure Resource Modules estão sob suporte apenas para correções críticas.The Azure Resource Modules modules are under support for critical fixes only. Daqui para a frente haverá apenas lançamentos Az para Azure Stack Hub.Going forward there will only be Az releases for Azure Stack Hub.

Pode utilizar perfis API para especificar os pontos finais compatíveis para os fornecedores de recursos Azure Stack Hub.You can use API profiles to specify the compatible endpoints for the Azure Stack Hub resource providers.

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

Pode instalar módulos compatívels com PowerShell Az em cenários ligados à Internet, parcialmente ligados ou desligados.You can install Azure Stack Hub compatible PowerShell Az modules in Internet-connected, partially connected, or disconnected scenarios. Este artigo explica-lhe as instruções detalhadas para estes cenários.This article walks you through the detailed instructions for these scenarios.

1. Verifique os seus pré-requisitos1. Verify your prerequisites

Os módulos Az são suportados no Azure Stack Hub com Update 2002 ou mais tarde e com os atuais hotfixes instalados.Az modules are supported on Azure Stack Hub with Update 2002 or later and with the current hotfixes installed. Consulte as notas de lançamento do Azure Stack Hub para obter mais informações.Please see the Azure Stack Hub release notes for more information.

Os módulos Azure PowerShell Az funcionam com o PowerShell 5.1 ou superior no Windows, ou PowerShell Core 6.x e mais tarde 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. Deverá instalar a versão mais recente do PowerShell Core disponível para o seu sistema operativo.You should install the latest version of PowerShell Core available for your operating system. A Azure PowerShell não tem requisitos adicionais quando funciona no PowerShell Core.Azure PowerShell has no additional requirements when run on PowerShell Core.

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

$PSVersionTable.PSVersion

Pré-requisitos para windowsPrerequisites for Windows

Para utilizar 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 for necessário.Update to Windows PowerShell 5.1 if needed. Se estiver no Windows 10, 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

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

3. Desinstalar as versões existentes dos módulos Azure Stack Hub PowerShell3. Uninstall existing versions of the Azure Stack Hub PowerShell modules

Antes de instalar a versão necessária, certifique-se de que desinstala quaisquer módulos de recursos Azure Stack Hub Azure ou Az PowerShell previamente instalados.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 utilizando um dos dois métodos seguintes:Uninstall the modules by using one of the following two methods:

  1. Para desinstalar os módulos de recursos Azure existentes e os módulos Az PowerShell, 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 atingir um erro como "O módulo já está em uso", feche as sessões PowerShell que estão a utilizar os módulos e reexecute 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. Elimine todas as pastas que começam com Azure , ou a partir das Az Azs. C:\Program Files\WindowsPowerShell\Modules pastas e C:\Users\{yourusername}\Documents\WindowsPowerShell\Modules pastas.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. A eliminação destas pastas remove os módulos PowerShell existentes.Deleting these folders removes any existing PowerShell modules.

4. Conectado: Instalar com conectividade internet4. Connected: Install with internet connectivity

O módulo Azure Stack Az trabalhará no Azure Stack Hub 2002 ou mais tarde.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 numa máquina Windows, ou PowerShell 6.x ou superior numa 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. A utilização dos cmdlets do PowerShellGet é o método de instalação preferido.Using the PowerShellGet cmdlets is the preferred installation method. Este método funciona da mesma forma nas plataformas suportadas.This method works the same on the supported platforms.

Execute o seguinte comando a partir de 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

Nota

A versão 2.0.0 do módulo Azure Stack Hub é uma mudança de rutura.Azure Stack Hub module version 2.0.0 is a breaking change. Consulte a Migração de AzureRM para Azure PowerShell Az em Azure Stack Hub para obter mais detalhes.Refer to the Migrate from AzureRM to Azure PowerShell Az in Azure Stack Hub for details.

Aviso

Não é possível instalar os módulos Azure Resource (AzureRM) e Az para o 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 necessitar de manter os Módulos de Recursos Azure disponíveis no seu sistema, instale o módulo Az para PowerShell Core 6.x ou mais tarde.If you need to keep Azure Resource Modules available on your system, install the Az module for PowerShell Core 6.x or later. Para tal, instale o PowerShell Core 6.x ou posterior e, em seguida, siga estas instruções num 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. Desligado: Instalar sem ligação à Internet5. Disconnected: Install without internet connection

Num cenário desligado, primeiro descarregue os módulos PowerShell para uma máquina 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, transfira-os para o Kit de Desenvolvimento da Pilha de Azure Stack (ASDK) para instalação.Then, you transfer them to the Azure Stack Development Kit (ASDK) for installation.

Inscreva-se num computador com conectividade na Internet e use os seguintes scripts para descarregar os pacotes Azure Resource Manager e Azure Stack Hub, dependendo da sua versão do Azure Stack Hub.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 Azure Stack Hub PowerShell numa máquina conectada.Install Azure Stack Hub PowerShell to a connected machine.
  2. Ativar funcionalidades adicionais de armazenamento.Enable additional storage features.
  3. Transporte os pacotes PowerShell para a sua estação de trabalho desligada.Transport the PowerShell packages to your disconnected workstation.
  4. Atrapa manualmente o fornecedor NuGet na sua estação de trabalho desligada.Manually bootstrap the NuGet provider on your disconnected workstation.
  5. Confirme a instalação da PowerShell.Confirm the installation of PowerShell.

Instalar Azure Stack Hub PowerShellInstall Azure Stack Hub PowerShell

Azure Stack Hub 2002 ou mais tarde.Azure Stack Hub 2002 or later.

Pode utilizar módulos de recursos Azure ou módulos Az.You could either use Azure Resource Modules or Az modules. Para módulos de recursos Azure, consulte as instruções no módulo Install PowerShell AzureRM.For Azure Resource Modules, see the instructions at Install PowerShell AzureRM module. O seguinte código guarda módulos de repositório online de https://www.powershellgallery.com/ confiança.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

Nota

Em máquinas sem ligação à Internet, recomendamos a execução do seguinte cmdlet para desativar a recolha de dados de telemetria.On machines without an internet connection, we recommend executing the following cmdlet for disabling the telemetry data collection. Pode experimentar uma degradação de desempenho dos cmdlets sem desativar a recolha de dados de telemetria.You may experience a performance degradation of the cmdlets without disabling the telemetry data collection. Isto é aplicável apenas para as máquinas sem conexões de internetThis is applicable only for the machines without internet connections

Disable-AzDataCollection

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

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

  2. Inscreva-se na estação de trabalho desligada e copie as embalagens do dispositivo USB para uma localização 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. Atrapa manualmente o fornecedor NuGet na sua estação de trabalho desligada.Manually bootstrap the NuGet provider on your disconnected workstation. Para obter instruções, consulte a máquina manualmente de acesso ao fornecedor NuGet numa máquina que não esteja ligada à internet.For instructions, see Manually bootstrapping the NuGet provider on a machine that isn't connected to the internet.

  4. Registe esta localização como o repositório predefinido e instale os AzureRM módulos e AzureStack módulos deste 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 utilizar um servidor proxy6. Configure PowerShell to use a proxy server

Em cenários que requerem um servidor proxy para aceder à internet, primeiro configura o PowerShell para usar um servidor de procuração 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 pedido de 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. Utilize o módulo Az7. Use the Az module

Pode utilizar os cmdlets e as amostras de código com base em Módulos de Recursos Azure.You can use the cmdlets and code samples based on Azure Resource Modules. No entanto, irá querer alterar o nome dos módulos e cmdlets.However, you will want to change the name of the modules and cmdlets. Os nomes dos módulos foram alterados de modo que AzureRM e Azure se tornar 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 tornou-se New-AzVM e Get-AzureStorageBlob é agora Get-AzStorageBlob.has become New-AzVM, and Get-AzureStorageBlob is now Get-AzStorageBlob.

Para uma discussão e orientação mais aprofundadas para mover o script AzurRM para Az e quebrar as alterações no módulo 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.

Passos seguintesNext steps