Exercício – Instalar o Azure PowerShell

  • 10 minutos

Nesta unidade, você aprenderá a determinar a versão do PowerShell instalada no seu computador local e instalar a versão mais recente. Você também aprenderá a instalar o módulo Az do PowerShell.

Observação

Este exercício fornece instruções para a criação de uma instalação local do módulo Az do PowerShell. No entanto, o restante deste módulo usa o Azure Cloud Shell para aproveitar o ambiente gratuito de área restrita do Microsoft Learn. Se preferir, considere o exercício como uma atividade opcional e apenas leia as instruções.

Instalar o PowerShell no Windows

O Windows PowerShell está incluído no sistema operacional Windows. No entanto, recomenda-se instalar a versão estável mais recente do PowerShell 7 para uso com o Azure PowerShell. Siga estas etapas para determinar qual versão do PowerShell está instalada:

  1. Na caixa de pesquisa da bandeja do sistema, digite PowerShell. Vários atalhos podem ser exibidos:

    • PowerShell 7 (x64): versão de 64 bits do PowerShell 7 (recomendado).
    • Windows PowerShell: versão de 64 bits do Windows PowerShell, incluída no Windows.
    • Windows PowerShell (x86): versão de 32 bits do Windows PowerShell, incluída nas versões de 64 bits do Windows.
    • ISE do Windows PowerShell: ISE (Ambiente de Script Integrado) de 64 bits para escrever scripts do Windows PowerShell.
    • ISE do Windows PowerShell (x86): ISE de 32 bits, incluída nas versões de 64 bits do Windows.

    Se o PowerShell 7 não estiver instalado, abra o Windows PowerShell e use o Gerenciador de Pacotes do Windows (Winget) para instalar a versão estável mais recente do PowerShell 7:

    winget install --id Microsoft.Powershell --source winget

    Para obter instruções de instalação detalhadas, consulte Como instalar o PowerShell no Windows.

  2. Determine a versão do PowerShell:

    Para abrir o PowerShell 7, selecione o atalho PowerShell 7 (x64). Execute o seguinte comando para verificar a versão do PowerShell:

    $PSVersionTable.PSVersion

  3. Defina a política de execução do PowerShell:

    • Verifique a política de execução atual:

      Get-ExecutionPolicy -List

    • Se a política de execução estiver definida como Restricted, altere-a para RemoteSigned ou outra opção menos restritiva:

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    • Confirme a alteração da política de execução:

      Será solicitada a confirmação da alteração:

      The execution policy helps protect you from scripts that you do not trust. Changing the
execution policy might expose you to the security risks described in the
about_Execution_Policies help topic at https:/go.microsoft.com/fwlink/?LinkID=135170. Do you
want to change the execution policy? [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend
[?] Help (default is "N"): Y

      Insira Y ou A e, em seguida, pressione Enter.

Instalar o PowerShell no Linux

A instalação do PowerShell no Linux envolve o uso de um gerenciador de pacotes. As instruções a seguir são destinadas a versões do Ubuntu com suporte. Para outras distribuições, consulte Instalar o PowerShell no Linux.

Instale o PowerShell no Ubuntu Linux usando a APT (Advanced Packaging Tool) e ​​a linha de comando Bash:

  1. Atualizar a lista de pacotes

    sudo apt-get update

  2. Instalar os pacotes de pré-requisitos

    sudo apt-get install -y wget apt-transport-https software-properties-common

  3. Determinar sua versão do Ubuntu

    source /etc/os-release

  4. Baixar as chaves do repositório da Microsoft

    wget -q https://packages.microsoft.com/config/ubuntu/$VERSION_ID/packages-microsoft-prod.deb

  5. Registrar as chaves do repositório da Microsoft

    sudo dpkg -i packages-microsoft-prod.deb

  6. Excluir o arquivo de chaves do repositório da Microsoft

    rm packages-microsoft-prod.deb

  7. Atualizar a lista de pacotes depois de adicionar o repositório da Microsoft

    sudo apt-get update

  8. Instalar o PowerShell

    sudo apt-get install -y powershell

  9. Iniciar o PowerShell

    pwsh

Instalar o PowerShell no macOS

Para instalar o PowerShell no macOS, use o gerenciador de pacotes Homebrew.

Importante

Se o comando brew não for encontrado, você deverá instalar o Homebrew. Para obter detalhes, confira o site da Homebrew.

Instale o Homebrew executando o seguinte comando:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

  1. Depois que o Homebrew estiver instalado, instale a versão estável mais recente do PowerShell 7:

    brew install powershell/tap/powershell

  2. Inicie o PowerShell para verificar se ele foi instalado com êxito:

    pwsh

Para obter instruções detalhadas de instalação, consulte Instalar o PowerShell no macOS.

Instalar o módulo do Az PowerShell

O módulo Az do PowerShell está disponível em um repositório global chamado Galeria do PowerShell. É possível instalar o módulo no computador local usando o cmdlet Install-Module.

Para instalar a versão mais recente do módulo Az do PowerShell, siga estas etapas:

  1. Abra o PowerShell 7

  2. Instale o módulo Az do PowerShell:

    Install-Module -Name Az -Scope CurrentUser -Repository PSGallery

    Este comando instala o módulo Az do PowerShell para seu usuário atual, que é controlado pelo parâmetro Scope.

    • Prompt de instalação do NuGet:

      A instalação utiliza NuGet para recuperar componentes. Pode ser solicitado que você baixe e instale a versão mais recente do NuGet:

      NuGet provider is required to continue PowerShellGet requires NuGet provider version
'2.8.5.201' or newer to interact with NuGet-based repositories. The NuGet provider must be
available in 'C:\Program Files\PackageManagement\ProviderAssemblies' or
'C:\Users\<username>\AppData\Local\PackageManagement\ProviderAssemblies'. You can also install
the NuGet provider by running 'Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201
-Force'. Do you want PowerShellGet to install and import the NuGet provider now? [Y] Yes [N] No
[S] Suspend [?] Help (default is "Y"):

      Insira Y e pressione Enter.

    • Prompt de repositório não confiável:

      Por padrão, a Galeria do PowerShell não é configurada como um repositório confiável. Será solicitado que você confirme se deseja instalar o módulo de um repositório não confiável:

      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"):

      Insira Y ou A e, em seguida, pressione Enter.

    Agora o módulo Az do PowerShell será instalado.

O processo de instalação do módulo Az do PowerShell no Linux e no macOS é simples e usa os mesmos comandos.

  1. Inicie o PowerShell:

    • Abra um terminal e execute o seguinte comando:

      pwsh

  2. Instale o módulo Az do PowerShell:

    • No prompt do PowerShell, digite o seguinte comando:

      Install-Module -Name Az -Scope CurrentUser -Repository PSGallery

    • Prompt de repositório não confiável:

      Por padrão, a Galeria do PowerShell não é configurada como um repositório confiável. Será solicitado que você confirme se deseja instalar o módulo de um repositório não confiável:

      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"):

      Insira Y ou A e, em seguida, pressione Enter.

    Agora o módulo Az do PowerShell será instalado.

Com este processo, é possível usar toda a variedade de cmdlets específicos do Azure disponíveis no módulo Az do PowerShell.