1
1
---
2
2
title : How to install the machine configuration authoring module
3
3
description : Learn how to install the PowerShell module for creating and testing machine configuration policy definitions and assignments.
4
- ms.date : 02/01/2024
4
+ ms.date : 07/22/2025
5
5
ms.topic : how-to
6
6
---
7
7
# How to set up a machine configuration authoring environment
@@ -24,7 +24,7 @@ Support for applying configurations through machine configuration is introduced
24
24
25
25
Operating systems where the module can be installed:
26
26
27
- - Ubuntu 20
27
+ - Ubuntu 20+
28
28
- Windows
29
29
30
30
The module can be installed on a machine running PowerShell 7.x. Install the versions of PowerShell
@@ -33,46 +33,13 @@ listed in the following table for your operating system.
33
33
| OS | Minimum Required PowerShell Version | Installation |
34
34
| ------------| :-----------------------------------:| ----------------------------------------|
35
35
| Windows | ` 7.1.3 ` | [ Installing PowerShell on Windows] [ 01 ] |
36
- | Ubuntu 20 | ` 7.2.4 ` | [ Installing PowerShell on Ubuntu] [ 02 ] |
37
-
38
- For Linux, the following shell script downloads and installs PowerShell 7.2.4.
39
-
40
- ``` sh
41
- # ##################################
42
- # Prerequisites
43
-
44
- # Update the list of packages
45
- sudo apt-get update
46
-
47
- # Install pre-requisite packages.
48
- sudo apt-get install -y wget
49
-
50
- # Download the PowerShell package file
51
- wget https://github.com/PowerShell/PowerShell/releases/download/v7.2.4/powershell_7.2.4-1.deb_amd64.deb
52
-
53
- # ##################################
54
- # Install the PowerShell package
55
- sudo dpkg -i powershell_7.2.4-1.deb_amd64.deb
56
-
57
- # Resolve missing dependencies and finish the install (if necessary)
58
- sudo apt-get install -f
59
-
60
- # Delete the downloaded package file
61
- rm powershell_7.2.4-1.deb_amd64.deb
62
-
63
- # Switch the user to root before launching PowerShell
64
- sudo su
65
-
66
- # Start PowerShell
67
- pwsh
68
- ```
36
+ | Ubuntu 20+ | ` 7.2.4 ` | [ Installing PowerShell on Ubuntu] [ 02 ] |
69
37
70
38
The ** GuestConfiguration** module requires the following software:
71
39
72
40
- Azure PowerShell 5.9.0 or higher. The required Az PowerShell modules are installed automatically
73
41
with the ** GuestConfiguration** module, or you can follow [ these instructions] [ 03 ] .
74
42
75
-
76
43
### Install the GuestConfiguration module from the PowerShell Gallery
77
44
78
45
To install the ** GuestConfiguration** module on either Windows or Linux, run the following command
0 commit comments