The xDSCResourceDesigner module is a part of the Windows PowerShell Desired State Configuration (DSC) Resource Kit, which is a tool to author PowerShell DSC Resources and produced by the PowerShell Team.This tool makes writing resources a breeze and ensure that all the rules which a DSC resource must conform to are met.
All of the functions/cmdlets in the Resource Designer Tool are provided AS IS, and are not supported through any Microsoft standard support program or service. The "x" in xDSCResourceDesigner stands for experimental, which means that this tool will be fix forward and monitored by the module owner(s).
Please leave comments, feature requests, and bug reports in the Issues tab for this module.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.
This is the branch containing the latest release - no contributions should be made directly to this branch.
This is the development branch to which contributions should be proposed by contributors as pull requests. This development branch will periodically be merged to the master branch, and be released to PowerShell Gallery.
If you would like to modify xDSCResourceDesigner module, feel free. When modifying, please update the module name and the function names (instructions below). As specified in the license, you may copy or modify this tool as long as they are used on the Windows Platform.
For more information about Windows PowerShell Desired State Configuration, check out the blog posts on the PowerShell Blog (this is a good starting point). There are also great community resources, such as PowerShell.org, or PowerShell Magazine. For more information on the DSC Resource Kit, check out this blog post.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.
Please check out common DSC Resources contributing guidelines.
To install xDSCResourceDesigner module
- Unzip the content under $env:ProgramFiles\WindowsPowerShell\Modules folder
To confirm installation:
- Run Get-Module -ListAvailable to see that xDSCResourceDesigner is among the modules listed
This module requires the latest version of PowerShell (v4.0, which ships in Windows 8.1 or Windows Server 2012R2). To easily use PowerShell 4.0 on older operating systems, install WMF 4.0. Please read the installation instructions that are present on both the download page and the release notes for WMF 4.0.
The xDSCResourceDesigner module exposes 6 functions: New-xDscResourceProperty, New-xDscResource, Update-xDscResource, Test-xDscResource, Test-xDscSchema and Import-xDscSchema. These uses of these functions are given below.
xDSCResourceDesigner module exposes the following functions:
- New-xDscResourceProperty: For creating a property for the resource
- New-xDscResource: for creating the actual resource containing the schema and module skeleton
- Update-xDscResource: for updating an existing resource with new properties
- Test-xDscResource: for testing whether an existing resource conforms to the rules required by DSC
- Test-xDscSchema: for testing whether an existing schema (schema.mof) conforms to the rules required by DSC
- Import-xDscSchema: for getting the properties in a schema returned as a hashtable
- Fix Parameter Blocks to conform to Dsc Style Guidlelines issue #79.
- Fix README.md MarkDownLint Errors and Formatting Issues
- Fixed
Test-MockSchemato return True if class name matches resource name when there are multiple embeded classes in the schema mof. issue #123.
- Added support for Codecov.
- Fix Test-xDscSchema failing to call
Remove-WmiObjecton PowerShell Core. The cmdletRemove-WmiObjectwas removed from the code, instead the temporary CIM class is now removed by using mofcomp.exe and the preprocessor command pragma deleteclass (issue #67).
- Converted appveyor.yml to install Pester from PSGallery instead of from Chocolatey.
- Helper function Test-xDscSchemaEncoding now supports PowerShell Core (issue #64).
- Changed README.md encoding to UTF8.
- Fixed issue where using ValidateSet with type string[] would throw an error
- Fixed issue where ValueMap on an Array was incorrectly flagged as an error
- Error message improvements
- Fixed issue with not being able to import the module twice
- Fixed issue with adding type twice through Add-Type
- Added support and tests for -FriendlyName on Update-xDscResource
- Added tests for creating and updating resources
- Minor fixes for Update-xDscResource
- Minor fixes after PowerShell.org fork merge.
Merged changes from PowerShell.org fork
- Removed #Requires -RunAsAdministrator. The commands that require Administrator rights already check for it anyway, and this allows the rest of the module to be used from a normal PowerShell session.
- Added support for Enum types (with associated ValueMap)
- Added support for EmbeddedInstances other than MSFT_Credential and MSFT_KeyValuePair
- Fixed parameter name in Test-xDscResource comment-based help to match actual command definition
- Updated Test-xDscResource to use a process block, since it accepts pipeline input.
- Fixed invalid use of try/catch/finally in Test-MockSchema and Test-DscResourceModule
- Updated code related to Common parameters; now handles all common parameters properly based on command metadata.
- Added very basic tests for Test-xDscResource; these need to be fleshed out quite a bit later.
- Ignore -WhatIf and -Confirm internal parameters to suppress false errors when Set-TargetResource declares [CmdletBinding(SupportsShouldProcess=$true)]
- Metadata updates.
- Initial release for xDSCResourceDesigner
This example creates an ADUser DSC resource.
<#
Create a ADUser DSC Resource with following properties
UserName: Name of the ADUser.
This is a key property for the resource that uniquely identify an instance.
Password: Password of the user.
Can be used to update an existing user password.
DomainAdminstratorCredential: Credential of the Domain Administrator in which user account will be created.
Ensure: Whether an user account should be created or deleted.
This can only take two values: ‘Present’ and ‘Absent’.
#>
$UserName = New-xDscResourceProperty -Name UserName -Type String -Attribute Key
$Password = New-xDscResourceProperty -Name Password -Type PSCredential -Attribute Write
$DomainCredential = New-xDscResourceProperty -Name DomainAdministratorCredential -Type PSCredential -Attribute Write
$Ensure = New-xDscResourceProperty -Name Ensure -Type String -Attribute Write -ValidateSet "Present", "Absent"
#Now create the resource
New-xDscResource -Name Contoso_cADUser -Property $UserName, $Password, $DomainCredential, $Ensure -Path 'C:\Program Files\WindowsPowerShell\Modules\xActiveDirectory'This example will use Test-xDscSchema function to check if the resource definition is correct or not
<#
Suppose you have the following schema (named buggy.schema.mof):
[ClassVersion("1.0.0.0"), FriendlyName("")]
class Contoso_cADUser : OMI_BaseResource
{
[Key] String UserName;
[Write, ValueMap{"Present","Absent"}, Values{"Present","Absent"}] String Ensure;
};
#>
# This reports that the schema is buggy.
Test-xDscSchema -Path .\buggy.schema.mof
<#
Suppose you have the following schema (named buggy.schema.mof):
[ClassVersion("1.0.0.0"), FriendlyName("")]
class Contoso_cADUser : OMI_BaseResource
{
[Key] String UserName;
[Write, ValueMap{"Present","Absent"}, Values{"Present","Absent"}] String Ensure;
};
#>
# This reports that the schema is buggy.
Test-xDscSchema -Path .\buggy.schema.mofThis example will use Update-xDscResource function to update an already existing resource properties
#Assume, you want to add an additional property called LastLogOn on existing Constoso_cADUser resource
$lastLogOn = New-xDscResourceProperty -Name LastLogOn -Type Hashtable -Attribute Read -Description "Returns the user last log on time"
#Update the existing resource
Update-xDscResource -Name 'Contoso_cADUser' -Property $UserName, $Password, $DomainCredential, $Ensure, $lastLogOn -Force
#Assume, you want to add an additional property called LastLogOn on existing Constoso_cADUser resource
$lastLogOn = New-xDscResourceProperty -Name LastLogOn -Type Hashtable -Attribute Read -Description "Returns the user last log on time"
#Update the existing resource
Update-xDscResource -Name 'Contoso_cADUser' -Property $UserName, $Password, $DomainCredential, $Ensure, $lastLogOn -Force