Exercício: Instalar o Azure PowerShell

Concluído

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

Nota

Este exercício o orienta na criação de uma instalação local do módulo Az PowerShell. No entanto, o restante deste módulo usa o Azure Cloud Shell para aproveitar o ambiente de sandbox gratuito do Microsoft Learn. Se preferir, pode considerar este exercício opcional e simplesmente rever as instruções.

Instalar o PowerShell no Windows

O Windows PowerShell está incluído no sistema operacional Windows. No entanto, recomendamos 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 Pesquisa da bandeja do sistema, digite PowerShell. Poderá ver vários atalhos:

   • 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.
   • Windows PowerShell ISE: ISE (Integrated Scripting Environment) de 64 bits para escrever scripts do Windows PowerShell.
   • Windows PowerShell ISE (x86): ISE de 32 bits, incluído nas versões de 64 bits do Windows.

   Se o PowerShell versão 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 detalhadas de instalação, consulte Instalando o PowerShell no Windows.

2. Determine a versão do PowerShell:

   Para abrir o PowerShell versão 7, selecione o atalho do 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 menos restritiva:

     Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
     

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

     Você será solicitado a confirmar a 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
     

     Introduza Y ou A e, em seguida, prima 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 para versões suportadas do Ubuntu. Para outras distribuições, consulte Instalar o PowerShell no Linux.

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

1. Atualizar a lista de pacotes

   sudo apt-get update
   

2. Instalar pacotes de pré-requisitos

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

3. Determine a sua versão do Ubuntu

   source /etc/os-release
   

4. Baixe 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 não for encontrado, você deverá instalar o brew Homebrew. Para obter detalhes, consulte o site 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 Instalando o PowerShell no macOS.

Instalar o módulo Az PowerShell

O módulo Az PowerShell está disponível em um repositório global chamado Galeria do PowerShell. Você pode instalar o módulo em sua máquina local usando o Install-Module cmdlet.

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

1. Abra o PowerShell versão 7

2. Instale o módulo Az PowerShell:

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

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

   • Prompt de instalação do NuGet:

     A instalação depende para NuGet recuperar componentes. Poderá ser-lhe pedido para transferir e instalar 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"):
     

     Digite Y e pressione Enter.

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

     Por padrão, a Galeria do PowerShell não está configurada como um repositório confiável. Você será solicitado a confirmar que deseja instalar o módulo a partir 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"):
     

     Introduza Y ou A e, em seguida, prima Enter.

   Agora você deve ver a instalação do módulo Az PowerShell.

O processo de instalação do módulo Az PowerShell no Linux e 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 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 está configurada como um repositório confiável. Você será solicitado a confirmar que deseja instalar o módulo a partir 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"):
     

     Introduza Y ou A e, em seguida, prima Enter.

   Você deve ver a instalação do módulo Az PowerShell.

Esse processo permite que você use a gama completa de cmdlets específicos do Azure disponíveis no módulo Az PowerShell.