Module containing DSC resources for deployment and configuration of Windows Server Failover Cluster.

Minimum PowerShell version


This is a prerelease version of xFailOverCluster.
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 xFailOverCluster -RequiredVersion 1.14.2-preview0005 -AllowPrerelease

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


DSC Community


Copyright the DSC Community contributors. All rights reserved.



DesiredStateConfiguration DSC DSCResourceKit DSCResource


xCluster xClusterDisk xClusterNetwork xClusterPreferredOwner xClusterProperty xClusterQuorum xWaitForCluster


This module has no dependencies.

Release Notes

# Change log for xFailOverCluster

The format is based on and uses the types of changes according to [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

For older change log history see the [historic changelog](HISTORIC_CHANGELOG.md).

## [Unreleased]

### Added

- xFailOverCluster
 - Add the module MarkdownLinkCheck to dependent modules to active the
   markdown link tests.
 - Added the filetypes to the file `.gitattributes` according to the
   Plaster template.
 - Update examples to be ready to be published to the PowerShell Gallery.
 - Added a CONTRIBUTING.md.
 - Replaced module CommonResourceHelper with the PowerShell Gallery module
   DscResource.Common v0.2.0.

### Changed

- xFailOverCluster
 - Updated the CI pipeline files to the latest template.
 - Changed unit tests to handle missing DscResource.Test better.
 - Changed the Code of Conduct to the one adopted by DSC Community.
 - Added `.markdownlint.json` to get the correct settings for the
   MarkdownLint VS Code extension.
 - Changed Visual Studio Code settings to the file `settings.json` according
   to the Plaster template.
 - Set `testRunTitle` for PublishTestResults task so that a helpful name is
   displayed in Azure DevOps for each test run.
 - Set a display name on all the jobs and tasks in the CI pipeline.
 - The deploy step is now only run when merged to branch `master` in the
   DSC Community upstream repository (not to branch `master` in a fork
   which always failed due to missing credentials).

### Fixed

- xFailOverCluster
 - Added CODE_OF_CONDUCT.md file, and a 'Code of Conduct' section in the
 - Improved CI pipeline
   - Renamed the jobs
   - Splitting up the testing in different jobs.
 - URLs in the module manifest pointed in the wrong direction.
 - Changed the encoding that will be used by ModuleBuilder (`UTF-8`).
 - URLs to examples in README.md didn't take account for new folder
 - Release pipeline stopped working in some circumstances, workaround is
   to pin ModuleBuilder to version `1.0.0` for now.
   *There is an issue with ModuleBuilder with preview strings using dash,*
   *e.g. `fix0008-9`. The string is compliant with SemVer 2.0 but there*
   *is a bug in `Publish-Module` that prevents the module to be released.*
 - Added code coverage reporting to Azure DevOps.
 - Update status badges in README.md.
 - Replaced section 'Branches' with section 'Releases' in README.md.
 - Pull request and issue template got minor updates.
 - Update module manifest exporting resources and fixed style.
 - Update GitVersion.yml with the correct regular expression.
 - Fix import statement in all tests, making sure it throws if module
   DscResource.Test cannot be imported.
 - Update the deploy step so that it skips deploy on merge to forks.
- xClusterPreferredOwner
 - Fixed broken links to examples in README.md.
- xClusterQuorum
 - Fixed broken link to examples in README.md ([issue #208](https://github.com/dsccommunity/xFailOverCluster/issues/208)).
- CommonResourceHelper
 - Added `en-US` localization folder to pass PSSA rule.
- xCluster
 - Added script file information to the example `1-CreateFirstNodeOfAFailoverCluster.ps1`.

### Removed

- Removed the file `.codecov.yml` since Codecov is no longer used.
- Removed the file `Deploy.PSDeploy.ps1` since it is not longer used by
 the build pipeline.

## [1.14.1] - 2019-12-18

### Changed

- xFailOverCluster
 - Changed the pipeline to publish test results for both success and failure.

### Fixed

- CommonResourceHelper
 - Fix unit tests to load the helper modules using module manifest.
 - Fix to correctly export the functions in the helper module
   ([issue #214](https://github.com/dsccommunity/xFailOverCluster/issues/214)).
 - Fix typo in module manifest.

## [1.14.0] - 2019-12-17

### Added

- xFailOverCluster
 - Added automatic release with a new CI pipeline.

### Changed

- xFailOverCluster
 - Moved the helper module `CommonResourceHelper` to the `Modules` folder.
- CommonResourceHelper
 - Update `Get-LocalizedData` to handle new location of helper module.

Version History

Version Downloads Last updated
1.16.0 298,872 3/17/2021
1.16.0-previ... 6 3/17/2021
1.15.0 6,654 2/19/2021
1.15.0-previ... 5 2/19/2021
1.15.0-previ... 16 12/29/2020
1.15.0-previ... 98 2/6/2020
1.15.0-previ... 14 2/1/2020
1.14.2-previ... 16 1/13/2020
1.14.2-previ... (current version) 6 1/13/2020
1.14.2-previ... 9 1/6/2020
1.14.2-previ... 6 1/3/2020
1.14.2-previ... 7 12/18/2019
1.14.2-previ... 5 12/18/2019
1.14.1 103,719 12/18/2019
1.14.1-previ... 6 12/18/2019
1.14.1-previ... 5 12/18/2019
1.14.0 256 12/17/2019
1.14.0-previ... 5 12/17/2019 24,151 9/19/2019 49,665 1/10/2019 1,640 10/25/2018 21,012 3/22/2018 7,897 2/8/2018 5,956 8/23/2017 935 7/12/2017 15,161 12/14/2016 1,924 8/10/2016 346 6/29/2016 338 5/18/2016 313 3/31/2016
1.1.1 1,106 5/13/2014
1.1 97 4/8/2014
Show less