xPSDesiredStateConfiguration

repository·main·Indexed 42 days ago

https://github.com/dsccommunity/xpsdesiredstateconfiguration

A community-driven extension of PowerShell Desired State Configuration (DSC) resources. It provides enhanced features, bugfixes, and new resources beyond the standard Microsoft PSDscResources module, including resources like xService, xRegistry, and xWindowsFeature. It is automatically tested on PowerShell 5.1 with Windows Server 2016 and 2019, with specific support for Nano Server.

Tokens: 5.1K
Snippets: 7
Records: 43
Agent score: 52%

What's inside xPSDesiredStateConfiguration

Overview of the xFileUpload DSC Resource
main
The xFileUpload resource provides a mechanism to configure and manage multiple resources (conceptually grouped as xGroup resources) that share common settings but require different names. It is designed to handle file upload configurations within a Desired State Configuration (DSC) environment.
https://github.com/dsccommunity/xpsdesiredstateconfiguration/blob/main/source/DSCResources/xFileUpload/README.md
Overview of xPSDesiredStateConfiguration
main
The xPSDesiredStateConfiguration module is a community-supported collection of Desired State Configuration (DSC) resources. It contains the same resources as the Microsoft-supported PSDscResources module but includes additional features, bugfixes, and new resources.
Key distinctions:
- Prefix 'x': Some resources use an 'x' prefix (e.g., xService) to avoid conflicts with built-in Windows PowerShell resources. This prefix does not imply the resource is experimental.
- Lifecycle: Unlike PSDscResources, which is maintained by Microsoft as a 1:1 replacement for built-in resources, xPSDesiredStateConfiguration is actively developed by the DSC community with a focus on new features.
- Compatibility: Automatically tested on PowerShell 5.1 with Windows Server 2016 and 2019. While it may work on PowerShell 4 or other operating systems, compatibility is not guaranteed.
https://github.com/dsccommunity/xpsdesiredstateconfiguration/blob/main/README.md
Overview of the xWindowsFeatureSet resource
main
The xWindowsFeatureSet resource provides a mechanism to configure and manage multiple xWindowsFeature resources on a single target node. This allows for batch management of Windows features rather than configuring them individually.
https://github.com/dsccommunity/xpsdesiredstateconfiguration/blob/main/source/DSCResources/xWindowsFeatureSet/README.md
Overview of the xWindowsOptionalFeatureSet resource
main
The xWindowsOptionalFeatureSet resource provides a mechanism to configure and manage multiple xWindowsOptionalFeature resources on a target node. This resource is specifically designed to work on Nano Server environments.
https://github.com/dsccommunity/xpsdesiredstateconfiguration/blob/main/source/DSCResources/xWindowsOptionalFeatureSet/README.md
Use the DSC_xPackageResource to manage host packages
main
The DSC_xPackageResource is a Desired State Configuration (DSC) resource used to manage the installation or uninstallation of software packages on a host machine. It allows you to ensure a specific package is present or absent as part of your configuration state.
https://github.com/dsccommunity/xpsdesiredstateconfiguration/blob/main/source/DSCResources/DSC_xPackageResource/README.md
Manage Windows services with DSC_xServiceResource
main
The DSC_xServiceResource provides a mechanism to configure and manage Windows services via Desired State Configuration (DSC). This resource is compatible with Nano Server.
https://github.com/dsccommunity/xpsdesiredstateconfiguration/blob/main/source/DSCResources/DSC_xServiceResource/README.md
Use the DSC_xWindowsOptionalFeature resource to manage Windows optional features
main
The DSC_xWindowsOptionalFeature resource allows you to enable or disable Windows optional features via Desired State Configuration (DSC). This resource is compatible with Nano Server.
Requirements
To use this resource, ensure the following conditions are met:
- The target machine must be running a Windows client operating system, Windows Server 2012 or later, or Nano Server.
- The target machine must have access to the DISM PowerShell module.
https://github.com/dsccommunity/xpsdesiredstateconfiguration/blob/main/source/DSCResources/DSC_xWindowsOptionalFeature/README.md
Use xProcessSet to manage multiple xWindowsProcess resources
main
The xProcessSet resource provides a mechanism to configure and manage a collection of multiple xWindowsProcess resources on a target node simultaneously. Instead of defining individual process resources for every process you wish to manage, you can use xProcessSet to group them.
https://github.com/dsccommunity/xpsdesiredstateconfiguration/blob/main/source/DSCResources/xProcessSet/README.md
Use the DSC_xWindowsFeature resource to manage Windows roles and features
main
The DSC_xWindowsFeature resource allows you to install, uninstall, and query Windows roles or features on a target node. It leverages the underlying Windows management infrastructure to ensure the desired state of system features.
https://github.com/dsccommunity/xpsdesiredstateconfiguration/blob/main/source/DSCResources/DSC_xWindowsFeature/README.md
Use the xScriptResource to run PowerShell script blocks
main
The xScriptResource provides a mechanism to execute arbitrary PowerShell script blocks on a target node. This resource is compatible with Nano Server.
https://github.com/dsccommunity/xpsdesiredstateconfiguration/blob/main/source/DSCResources/DSC_xScriptResource/README.md
Use the xMsiPackage DSC Resource to manage .msi packages
main
The xMsiPackage resource provides a mechanism to install and uninstall Windows Installer (.msi) packages using Desired State Configuration (DSC).
https://github.com/dsccommunity/xpsdesiredstateconfiguration/blob/main/source/DSCResources/DSC_xMsiPackage/README.md
Manage environment variables with xEnvironment Resource
main
The xEnvironment resource provides a mechanism to configure and manage environment variables for a machine or process using Desired State Configuration (DSC). It allows you to ensure that specific environment variables are present, have the correct value, and are scoped to either the machine or a specific process.
https://github.com/dsccommunity/xpsdesiredstateconfiguration/blob/main/source/DSCResources/DSC_xEnvironmentResource/README.md

xPSDesiredStateConfiguration

What's inside xPSDesiredStateConfiguration

Requirements