Otimizar a instalação do Azure PowerShell

2025-07-01

Este artigo explora como otimizar o processo de instalação do Azure PowerShell instalando seletivamente apenas os módulos necessários usando o módulo do PowerShell Microsoft.PowerShell.PSResourceGet (PSResourceGet), uma solução de gerenciamento de pacotes aprimorada introduzida com o PowerShell versão 7.4.

Pré-requisitos

Em sistemas Windows, você deve definir a política de execução do PowerShell como remota assinada ou menos restritiva
- Verifique a política de execução do PowerShell:
```
Get-ExecutionPolicy -List
```
- Defina a política de execução do PowerShell como assinada remotamente:
```
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```
Para saber mais sobre as políticas de execução, confira about_Execution_Policies.
Determine se o módulo PSResourceGet PowerShell está instalado e instale-o, se necessário. O módulo PSResourceGet fornece recursos aprimorados para instalar recursos do PowerShell, incluindo módulos do Azure PowerShell. PSResourceGet é pré-instalado com o PowerShell versão 7.4 ou superior e também tem suporte no Windows PowerShell 5.1.
- Determine se o módulo PSResourceGet PowerShell está instalado.
```
Get-Module -Name Microsoft.PowerShell.PSResourceGet -ListAvailable
```
- Instale o módulo PSResourceGet PowerShell.
```
Install-Module -Name Microsoft.PowerShell.PSResourceGet -Repository PSGallery
```

Módulo Az PowerShell

O Azure PowerShell é o nome do produto da coleção de módulos oficiais do Microsoft PowerShell para gerenciar recursos do Azure. O módulo Az PowerShell é a iteração atual do Azure PowerShell.

O módulo do PowerShell Az é um módulo wrapper para módulos do PowerShell relacionados ao serviço do Azure, geralmente um módulo por serviço do Azure, como Az.Compute, Az.Networke Az.Storage. Ao instalar o módulo Az PowerShell, você instala todos os módulos específicos de serviço do Azure PowerShell em disponibilidade geral (GA).

Cada submodule do módulo Az PowerShell depende do módulo Az.Accounts, que fornece os principais recursos de autenticação e gerenciamento de conta para o Azure PowerShell. Quando você usa Install-Module (parte do PowerShellGet) para instalar o módulo Az PowerShell, o módulo Az.Accounts é baixado e instalado para cada submodule. Esse processo de download redundante aumenta o tempo de instalação.

PSResourceGet instala Az.Accounts apenas uma vez, independentemente do número de submódulos instalados. Isso resulta em um processo de instalação mais rápido e eficiente.

Install-PSResource -Name Az

Instalar módulos específicos para serviços individuais

Instalar todo o módulo Az PowerShell com todos os módulos específicos do serviço agrupados é conveniente, mas demorado e ineficiente se você usar apenas um subconjunto de seus comandos. A instalação de todo o módulo do Az PowerShell resulta em:

tempos de instalação mais longos.
requisitos de armazenamento aumentados.
atualizações desnecessárias para módulos que você não usa.

Você pode simplificar o processo instalando apenas os módulos específicos do serviço necessários. A combinação de usar PSResourceGet e instalar apenas os módulos necessários reduz drasticamente a sobrecarga de instalação.

O exemplo a seguir usa o cmdlet Install-PSResource para instalar os módulos Az.Compute, Az.Network, Az.Resourcese Az.Storage PowerShell.

Install-PSResource -Name Az.Compute, Az.Network, Az.Resources, Az.Storage

O módulo do Az.Accounts também é instalado automaticamente, mas apenas uma vez.

Instalar todos os módulos GA e de pré-visualização

Se você precisar de todas as versões de disponibilidade geral (GA) e versões prévias dos módulos Az PowerShell, instale o módulo AzPreview . O módulo AzPreview PowerShell espelha a estrutura do módulo Az, mas inclui todos os módulos GA e de versão de pré-visualização. Para consistência, seu número de versão é o mesmo que o módulo Az.

O exemplo a seguir instala o módulo AzPreview usando PSResourceGet.

Install-PSResource -Name AzPreview

Instalar por meio do Registro de Artefatos da Microsoft

A instalação do módulo Az PowerShell do Registro de Artefatos da Microsoft (MAR) oferece instalações mais rápidas e confiáveis. O MAR garante velocidades de download rápidas e um processo de instalação suave, minimizando possíveis problemas durante a instalação.

Se você estiver usando uma versão do PowerShell anterior à 7.5.0, deverá instalar o Microsoft.PowerShell.PSResourceGet versão 1.1.0 ou superior
```
Install-Module -Name Microsoft.PowerShell.PSResourceGet -Repository PSGallery
```

Registrar MAR como um repositório em PSResourceGet em seu sistema

Register-PSResourceRepository -Name MAR -Uri https://mcr.microsoft.com -ApiVersion ContainerRegistry

Instalar o módulo do Az PowerShell do MAR usando PSResourceGet
```
Install-PSResource -Name Az -Repository MAR
```

Benefícios de otimizar o processo de instalação

Ao adotar um processo de instalação mais seletivo e eficiente, você:

Reduzir o consumo de recursos: instale apenas o que você precisa, economizando espaço em disco.
Melhorar ode desempenho: evite downloads redundantes e simplifique o processo de instalação.
Permanecer ágil: atualize e mantenha apenas os módulos que você usa ativamente.

Consulte também

Próximas etapas

Para saber mais sobre como gerenciar seus recursos do Azure com o módulo Az PowerShell, consulte Introdução ao Azure PowerShell.

Compartilhar via