Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O módulo GuestConfiguration do PowerShell automatiza o processo de criação de conteúdo personalizado, incluindo:
- Criando um artefato de conteúdo de configuração da máquina (
.zip) - Verificando se o pacote atende aos requisitos
- Instalar o agente de configuração de computador localmente para teste
- Validar o pacote pode ser usado para auditar configurações em um computador
- Validar o pacote pode ser usado para definir configurações em um computador
- Publicar o pacote no armazenamento do Azure
- A criação de uma definição de política
- A publicação da política
O suporte para aplicar configurações por meio da configuração de computador foi introduzido na versão 3.4.2.
Requisitos base
Sistemas operacionais em que é possível instalar o módulo:
- Ubuntu 20+
- Windows
O módulo pode ser instalado em um computador que executa o PowerShell 7.x. Instale as versões do PowerShell listadas na tabela a seguir para o seu sistema operacional.
| OS | Versão mínima necessária do PowerShell | Installation |
|---|---|---|
| Windows | 7.1.3 |
instalando o PowerShell no Windows |
| Ubuntu 20+ | 7.2.4 |
Instalando o PowerShell no Ubuntu |
O módulo GuestConfiguration requer o seguinte software:
- Azure PowerShell 5.9.0 ou superior. Os módulos necessários do Az PowerShell são instalados automaticamente com o módulo GuestConfiguration ou você pode seguir estas instruções.
Instalar o módulo GuestConfiguration da Galeria do PowerShell
Para instalar o módulo GuestConfiguration em Windows ou Linux, execute o seguinte comando no PowerShell 7.
# Install the machine configuration DSC resource module from PowerShell Gallery
Install-Module -Name GuestConfiguration
Confirme que o módulo foi importado:
# Get a list of commands for the imported GuestConfiguration module
Get-Command -Module GuestConfiguration
Instalar o módulo PSDesiredStateConfiguration da Galeria do PowerShell
No Windows, para instalar o módulo PSDesiredStateConfiguration, execute o seguinte comando no PowerShell 7.
# Install PSDesiredStateConfiguration version 2.0.7 (the stable release)
Install-Module -Name PSDesiredStateConfiguration -RequiredVersion 2.0.7
Import-Module -Name PSDesiredStateConfiguration
No Linux, para instalar o módulo PSDesiredStateConfiguration , execute o seguinte comando no PowerShell 7.
# Install PSDesiredStateConfiguration prerelease version 3.0.0
Install-Module -Name PSDesiredStateConfiguration -RequiredVersion 3.0.0-beta1 -AllowPrerelease
Import-Module -Name PSDesiredStateConfiguration
Confirme que o módulo foi importado:
# Get a list of commands for the imported PSDesiredStateConfiguration module
Get-Command -Module PSDesiredStateConfiguration