GuestConfiguration

3.4.2

[PREVIEW] The Guest Configuration module is an experimental tool to assist content authoring for Azure Guest Configuration. The cmdlets will help build and publish a content package, wich can then be used in cross-platform configuration management solutions.

Minimum PowerShell version

6.2.0

There is a newer prerelease version of this module available.
See the version list below for details.

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name GuestConfiguration -RequiredVersion 3.4.2

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Author(s)

Azure Guest Configuration

Copyright

(c) 2021 Microsoft Corporation. All rights reserved.

Owners

Tags

GuestConfiguration Azure DSC

Functions

Get-GuestConfigurationPackageComplianceStatus Install-GuestConfigurationAgent Install-GuestConfigurationPackage New-GuestConfigurationFile New-GuestConfigurationPackage New-GuestConfigurationPolicy Protect-GuestConfigurationPackage Publish-GuestConfigurationPackage Publish-GuestConfigurationPolicy Start-GuestConfigurationPackageRemediation Test-GuestConfigurationPackage

DSCResources

ChefInSpecResource PesterResource

Dependencies

Release Notes

## [3.4.2] - 2021-08-09

### Added

- Added `Install-GuestConfigurationPackage`.
- Updated `New-GuestConfigurationPackage` to support PackageType.
- Updated `New-GuestConfigurationPolicy` to support AssignmentType (Audit, ApplyAndMonitor, ApplyAndCorrect) and creation of DeployIfNotExists.json
- Added `Get-GuestConfigurationPackageName`
- Added `Get-GuestConfigurationPackageNameFromZip`
- Updated `New-GuestConfigurationPolicy` to include guestconfig object in metadata for DINE policies. The included configurationParameter matches the pattern of AINEs.
- Added more tests to `New-GuestConfigurationPolicy.Tests` to cover metadata scenario.
- Added dependency on PSDesiredStateConfiguration.

### Changed

- Pipeline and project structure updated to match DSC Community Projects.
- Fixed casing of default parameter in generated policy, which caused issues on manual import
- Changed how meta config are written to different files, and read from both
- Install PSDesiredStateConfiguration V3 onto Ubuntu machine
- Remove testing inspec on Linux machines, as we will no longer be supporting that scenario
- Fixed `New-GuestConfigurationPolicy` to create arrays for configurationParameter when no parameters are passed in
- No longer using -Package as a valid parameter for any commands
- Require policyId parameter for `New-GuestConfigurationPolicy`
- Removed ability to pass in package name for `Install-GuestConfigurationPackage`

Version History

Version Downloads Last updated
3.5.0-pr0242 39 8/18/2021
3.4.2 (current version) 666 8/9/2021
3.4.0 215 7/31/2021
3.3.1 10 7/30/2021
3.3.0-previe... 22 7/29/2021
3.3.0-previe... 2 7/29/2021
3.3.0-previe... 2 7/28/2021
3.3.0-previe... 3 7/28/2021
3.3.0-previe... 11 7/26/2021
3.3.0-previe... 36 7/16/2021
3.3.0-previe... 3 7/14/2021
3.3.0-previe... 635 6/16/2021
3.3.0-previe... 12 6/9/2021
3.3.0-previe... 37 5/25/2021
3.3.0-prerel... 42 5/14/2021
3.2.0-prerel... 37 2/22/2021
3.1.3 2,263 2/3/2021
3.1.3-prerel... 25 1/27/2021
3.1.2-prerel... 9 1/26/2021
3.1.1-prerel... 56 12/23/2020
3.1.0-prerel... 6 12/23/2020
3.0.0 639 12/9/2020
3.0.0-prerel... 5 12/8/2020
2.2.0-prerel... 12 11/20/2020
2.1.0 335 10/26/2020
2.1.0-prerel... 3 10/16/2020
2.0.0-prerel... 2 10/5/2020
1.20.3-prere... 69 6/2/2020
1.20.2-prere... 6 5/29/2020
1.20.1-prere... 55 5/4/2020
1.20.0-prere... 4 4/30/2020
1.19.4 1,869 4/23/2020
1.19.3-prere... 25 3/30/2020
1.19.2-prere... 10 3/27/2020
1.19.1-prere... 256 3/4/2020
1.19.0.0 1,174 1/17/2020
1.18.0.0 734 10/15/2019
1.17.0.0 484 8/6/2019
1.16.0.0 119 7/29/2019
1.15.0.0 57 7/19/2019
1.14.0.0 22 7/17/2019
1.12.0.0 105 6/24/2019
1.11.0.0 268 5/7/2019
1.10.0.0 57 4/25/2019
1.9.0.0 13 4/25/2019
1.8.0.0 17 4/22/2019
1.7.0.0 85 4/18/2019
1.6.0.0 58 3/26/2019
1.5.0.0 23 3/14/2019
1.4.0.0 20 3/14/2019
1.3.0.0 26 3/13/2019
1.2.0.0 21 3/8/2019
1.1.0.0 30 3/1/2019
1.0.0.0 40 2/11/2019