Partager via


Comment configurer un environnement de création de configuration de machine

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.

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

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

Étape suivante