Instalar o módulo AzureRM do PowerShell para o Hub Azure StackInstall PowerShell AzureRM module for Azure Stack Hub

Azure PowerShell Azure Resource Manager (AzureRM) fornece um conjunto de cmdlets que usam o modelo de Azure Resource Manager para gerenciar seus recursos do Hub Azure Stack.Azure PowerShell Azure Resource Manager (AzureRM) provides a set of cmdlets that use the Azure Resource Manager model for managing your Azure Stack Hub resources.

Importante

Você está em uma página da Web de uma versão desatualizada do Azure PowerShell.You've reached a webpage for an outdated version of Azure PowerShell. Todas as versões do módulo do PowerShell Azure Resource Manager (AzureRM) estão desatualizadas, mas não há suporte para ele.All versions of the Azure Resource Manager (AzureRM) PowerShell module are outdated, but not out of support. O módulo AZ PowerShell agora é o módulo recomendado do PowerShell para interagir com o Azure e o Hub de Azure Stack.The Az PowerShell module is now the recommended PowerShell module for interacting with Azure and Azure Stack Hub. Para começar a usar o módulo AZ PowerShell, consulte instalar o módulo de visualização AZ do PowerShell para Azure Stack Hub.To get started with the Az PowerShell module, see Install PowerShell Az preview module for Azure Stack Hub. Para saber como migrar para o módulo AZ PowerShell.To learn how to migrate to the Az PowerShell module. consulte migrar de AzureRM para Azure PowerShell AZ no Hub Azure Stack.see Migrate from AzureRM to Azure PowerShell Az in Azure Stack Hub.

Você também precisa usar perfis de API para especificar os pontos de extremidade compatíveis para os provedores de recursos do Hub de Azure Stack.You also need to 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 do PowerShell compatíveis com o Hub em cenários conectados à Internet, parcialmente conectados ou desconectados.You can install Azure Stack Hub compatible PowerShell 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.

Você também pode executar os módulos Azure Resource Manager para Azure Stack Hub em um contêiner do Docker.You can also run the Azure Resource Manager 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.

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

Antes de começar a usar o Azure Stack Hub e o módulo Azure Resource Manager do PowerShell, você deve ter os seguintes pré-requisitos:Before you get started with Azure Stack Hub and the PowerShell Azure Resource Manager module, you must have the following prerequisites:

  • PowerShell versão 5,1PowerShell Version 5.1
    Para verificar sua versão, execute $psversiontable. psversion e compare a versão principal .To check your version, run $PSVersionTable.PSVersion and compare the Major version. Se você não tiver o PowerShell 5,1, siga a instalação do Windows PowerShell.If you don't have PowerShell 5.1, follow the Installing Windows PowerShell.

    Observação

    O PowerShell 5,1 requer um computador Windows.PowerShell 5.1 requires a Windows machine.

  • Execute o PowerShell em um prompt de comandos com privilégios elevados.Run PowerShell in an elevated command prompt.

  • Acesso Galeria do PowerShellPowerShell Gallery access
    Você precisa ter acesso ao Galeria do PowerShell.You need access to the PowerShell Gallery. A galeria é o repositório central de conteúdo do PowerShell.The gallery is the central repository for PowerShell content. O módulo PowerShellGet contém cmdlets para descoberta, instalação, atualização e publicação de artefatos do PowerShell.The PowerShellGet module contains cmdlets for discovering, installing, updating, and publishing PowerShell artifacts. Exemplos desses artefatos são módulos, recursos de DSC, recursos de função e scripts do Galeria do PowerShell e de outros repositórios privados.Examples of these artifacts are modules, DSC resources, role capabilities, and scripts from the PowerShell Gallery and other private repositories. Se você estiver usando o PowerShell em um cenário desconectado, deverá recuperar recursos de um computador com uma conexão com a Internet e armazená-los em um local acessível ao computador desconectado.If you're using PowerShell in a disconnected scenario, you must retrieve resources from a machine with a connection to the internet and store them in a location accessible to your disconnected machine.

Valide se PSGallery está registrado como um repositório.Validate if PSGallery is registered as a repository.

Observação

Esta etapa requer acesso à Internet.This step requires internet access.

Abra um prompt do PowerShell com privilégios elevados e execute os seguintes cmdlets:Open an elevated PowerShell prompt, and run the following cmdlets:

Install-module -Name PowerShellGet -Force
Import-Module -Name PackageManagement -ErrorAction Stop
Get-PSRepository -Name "PSGallery"

Se o repositório não estiver registrado, abra uma sessão do PowerShell com privilégios elevados e execute o seguinte comando:If the repository isn't registered, open an elevated PowerShell session and run the following command:

Register-PSRepository -Default
Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted

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 qualquer Hub de Azure Stack instalado anteriormente Azure Resource Manager módulos do PowerShell.Before installing the required version, make sure that you uninstall any previously installed Azure Stack Hub Azure Resource Manager 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 de Azure Resource Manager e AZ PowerShell, feche todas as sessões ativas do PowerShell e execute os seguintes cmdlets: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
    

    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 o PowerShell para Azure Stack Hub com conectividade com a Internet4. Connected: Install PowerShell for Azure Stack Hub with internet connectivity

O perfil de versão da API e os módulos do PowerShell do hub de Azure Stack que você precisa dependem da versão do Hub do Azure Stack que você está executando.The API version profile and Azure Stack Hub PowerShell modules you require will depend on the version of Azure Stack Hub you're running.

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

Execute o seguinte script do PowerShell para instalar esses módulos em sua estação de trabalho de desenvolvimento:Run the following PowerShell script to install these modules on your development workstation:

Para Azure Stack Hub 2002 ou posterior:For Azure Stack Hub 2002 or later:

Você pode usar os módulos do usuário AzureRm ou módulos AZ Preview.You can use either user AzureRm modules or Az preview modules. O uso dos módulos AZ requer Azure Stack Hub 2002 e o hotfix mais recente.The use of the Az modules requires Azure Stack Hub 2002 and the latest hotfix.

Para usar os módulos AZ Preview, siga as instruções em instalar o módulo AZ do PowerShell.To use Az preview modules, follow the instructions at Install PowerShell Az module.

# Install the AzureRM.BootStrapper module. Select Yes when prompted to install NuGet
Install-Module -Name AzureRM.BootStrapper

# Install and import the API Version Profile required by Azure Stack Hub into the current PowerShell session.
Use-AzureRmProfile -Profile 2019-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.8.2

Para Azure Stack Hub 1910:For Azure Stack Hub 1910:

# Install the AzureRM.BootStrapper module. Select Yes when prompted to install NuGet
Install-Module -Name AzureRM.BootStrapper

# Install and import the API Version Profile required by Azure Stack Hub into the current PowerShell session.
Use-AzureRmProfile -Profile 2019-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.8.0

Observação

  • Azure Stack módulo de Hub versão 1.8.0 é uma versão de alteração significativa.Azure Stack Hub module version 1.8.0 is a breaking change release. Consulte a Nota de versão para obter detalhes.Refer to the release note for details.

Para Azure Stack Hub 1908 ou anterior:For Azure Stack Hub 1908 or earlier:

# Install the AzureRM.BootStrapper module. Select Yes when prompted to install NuGet
Install-Module -Name AzureRM.BootStrapper

# Install and import the API Version Profile required by Azure Stack Hub into the current PowerShell session.
Use-AzureRmProfile -Profile 2019-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.7.2

Observação

O módulo Hub de Azure Stack versão 1.7.2 é uma versão de alteração significativa.The Azure Stack Hub module version 1.7.2 is a breaking change release. Para migrar do Azure Stack Hub 1.6.0, consulte o Guia de migração.To migrate from Azure Stack Hub 1.6.0, please refer to the migration guide.

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 "Azure*" -ListAvailable
Get-Module -Name "Azs*" -ListAvailable

Se a instalação for bem-sucedida, os AzureRm AzureStack módulos e serão exibidos na saída.If the installation is successful, the AzureRm and AzureStack modules are displayed in the output.

5. desconectado: instalar o PowerShell sem uma conexão com a Internet5. Disconnected: Install PowerShell without an 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 Azure Resource Manager ou AZ Preview.You could either use Azure Resource Manager or Az preview modules. Para módulos AZ, consulte as instruções em instalar o PowerShell AZ Module.For Az modules, see instructions at Install PowerShell Az module.


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

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

Azure Stack Hub 1910.Azure Stack Hub 1910.

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

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

Observação

Azure Stack módulo de Hub versão 1.8.0 é uma versão de alteração significativa.Azure Stack Hub module version 1.8.0 is a breaking change release. Consulte a Nota de versão para obter detalhes.Refer to the release note for details.

Para Azure Stack Hub 1908 ou anterior:For Azure Stack Hub 1908 or earlier:

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

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

Observação

O módulo Hub de Azure Stack versão 1.7.1 é uma alteração significativa.The Azure Stack Hub module version 1.7.1 is a breaking change. Para migrar do Azure Stack Hub 1.6.0, consulte o Guia de migração.To migrate from Azure Stack Hub 1.6.0 please refer to the migration guide.

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-AzureRmDataCollection

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 a Azure Resource Manager e os AzureStack módulos deste repositório:Register this location as the default repository and install the Azure Resource Manager 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"
    
    Register-PSRepository -Name $RepoName -SourceLocation $SourceLocation -InstallationPolicy Trusted
    
    Install-Module -Name AzureRM -Repository $RepoName
    
    Install-Module -Name AzureStack -Repository $RepoName
    

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 "Azure*" -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 comandos a seguir: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
    

Problema conhecidoKnown issue

Erro de get_SerializationSettings do métodoMethod get_SerializationSettings error

  • Causa: o módulo AZ do PowerShell e os módulos Azure Resource Manager do PowerShell não são compatíveis.Cause: The PowerShell Az module and PowerShell Azure Resource Manager modules are not compatible.

    O erro a seguir indica que os módulos de Azure Resource Manager e AZ são carregados na mesma sessão:The following error indicates that the Azure Resource Manager modules and Az modules are loaded in the same session:

    >  Method 'get_SerializationSettings' in type 'Microsoft.Azure.Management.Internal.Resources.ResourceManagementClient' from assembly 'Microsoft.Azure.Commands.ResourceManager.Common, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' does 
    not have an implementation.
    
  • Correção: Desinstale os módulos conflitantes.Remediation: Uninstall the conflicting modules.

    Se você quiser usar os módulos de Azure Resource Manager, desinstale os módulos AZ.If you would like to use the Azure Resource Manager modules, uninstall the Az modules. Ou desinstale o Azure Resource Manager se desejar usar os módulos AZ.Or uninstall the Azure Resource Manager if you would like to use the Az modules. Feche a sessão do PowerShell e desinstale os módulos AZ ou Azure Resource Manager.Close your PowerShell session and uninstall either the Az or Azure Resource Manager modules.

    Você pode encontrar instruções em desinstalar as versões existentes dos módulos do PowerShell do hub de Azure Stack.You can find instructions at Uninstall existing versions of the Azure Stack Hub PowerShell modules.

Próximas etapasNext steps