The SharePointDsc PowerShell module (formerly known as xSharePoint) provides DSC resources that can be used to deploy and manage a SharePoint farm.
Please leave comments, feature requests, and bug reports in the issues tab for this module.
Information about this module, new releases and tips/tricks will be shared on the SharePointDsc blog.
This project has adopted this Code of Conduct.
For each merge to the branch master a preview release will be
deployed to PowerShell Gallery.
Periodically a release version tag will be pushed which will deploy a
full release to PowerShell Gallery.
If you would like to modify SharePointDsc module, please feel free. Please refer to the Contribution Guidelines for information about style guides, testing and patterns for contributing to DSC resources.
Also check out common DSC Community contributing guidelines.
To manually install the module, download the source code and unzip the contents of the \Modules\SharePointDsc directory to the $env:ProgramFiles\WindowsPowerShell\Modules folder
To install from the PowerShell gallery using PowerShellGet (in PowerShell 5.0) run the following command:
Find-Module -Name SharePointDsc -Repository PSGallery | Install-Module
To confirm installation, run the below command and ensure you see the SharePoint DSC resoures available:
Get-DscResource -Module SharePointDsc
The minimum PowerShell version required is 4.0, which ships in Windows 8.1 or Windows Server 2012R2 (or higher versions). The preferred version is PowerShell 5.0 or higher, which ships with Windows 10 or Windows Server 2016. This is discussed on the SharePointDsc wiki, but generally PowerShell 5 will run the SharePoint DSC resources faster and with improved verbose level logging.
For a full list of resources in SharePointDsc and examples on their use, check out the SharePointDsc wiki. You can also review the "examples" directory in the SharePointDSC module for some general use scenarios for all of the resources that are in the module.
A full list of changes in each version can be found in the change log