Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Le module PowerShell GuestConfiguration automatise le processus de création de contenu personnalisé, notamment :
- La création d’un artefact de contenu de configuration d’ordinateur (
.zip
) - La validation du package conforme aux exigences
- L’installation locale de l’agent de configuration de machine à des fins de test
- La validation du package pouvant être utilisée pour auditer les paramètres d’une machine
- La validation du package pouvant être utilisée pour configurer les paramètres d’une machine
- La publication du package dans le stockage Azure
- La création d’une définition de stratégie
- La publication de la stratégie
La prise en charge de l’application de configurations au travers de la configuration d’ordinateur est introduite dans la version 3.4.2.
Configuration de base requise
Systèmes d’exploitation sur lesquels le module peut être installé :
- Ubuntu 20
- Fenêtres
Le module peut être installé sur une machine exécutant PowerShell 7.x. Installez les versions de PowerShell répertoriées pour votre système d’exploitation dans le tableau suivant.
Système d’exploitation | Version minimale requise de PowerShell | Installation |
---|---|---|
Fenêtres | 7.1.3 |
Installation de PowerShell sur Windows |
Ubuntu 20 | 7.2.4 |
Installation de PowerShell sur Ubuntu |
Pour Linux, le script shell suivant télécharge et installe PowerShell 7.2.4.
###################################
# Prerequisites
# Update the list of packages
sudo apt-get update
# Install pre-requisite packages.
sudo apt-get install -y wget
# Download the PowerShell package file
wget https://github.com/PowerShell/PowerShell/releases/download/v7.2.4/powershell_7.2.4-1.deb_amd64.deb
###################################
# Install the PowerShell package
sudo dpkg -i powershell_7.2.4-1.deb_amd64.deb
# Resolve missing dependencies and finish the install (if necessary)
sudo apt-get install -f
# Delete the downloaded package file
rm powershell_7.2.4-1.deb_amd64.deb
# Switch the user to root before launching PowerShell
sudo su
# Start PowerShell
pwsh
Le module GuestConfiguration nécessite les logiciels suivants :
- Azure PowerShell 5.9.0 ou ultérieur. Les modules Az PowerShell requis sont installés automatiquement avec le module GuestConfiguration, sinon vous pouvez suivre ces instructions.
Installer le module GuestConfiguration à partir de PowerShell Gallery
Pour installer le module GuestConfiguration sur Windows ou Linux, exécutez la commande suivante dans PowerShell 7.
# Install the machine configuration DSC resource module from PowerShell Gallery
Install-Module -Name GuestConfiguration
Vérifiez que le module a été importé :
# Get a list of commands for the imported GuestConfiguration module
Get-Command -Module GuestConfiguration
Installer le module PSDesiredStateConfiguration à partir de PowerShell Gallery
Sur Windows, pour installer le module PSDesiredStateConfiguration , exécutez la commande suivante dans PowerShell 7.
# Install PSDesiredStateConfiguration version 2.0.7 (the stable release)
Install-Module -Name PSDesiredStateConfiguration -RequiredVersion 2.0.7
Import-Module -Name PSDesiredStateConfiguration
Sur Linux, pour installer le module PSDesiredStateConfiguration , exécutez la commande suivante dans PowerShell 7.
# Install PSDesiredStateConfiguration prerelease version 3.0.0
Install-Module -Name PSDesiredStateConfiguration -RequiredVersion 3.0.0-beta1 -AllowPrerelease
Import-Module -Name PSDesiredStateConfiguration
Vérifiez que le module a été importé :
# Get a list of commands for the imported PSDesiredStateConfiguration module
Get-Command -Module PSDesiredStateConfiguration