Skip to content

xoap-io/xoap-powershell-dsc-module-template

Repository files navigation

XOAPModuleTemplateDSC

This repository is a template that can be used as a starting point for creating new DSC modules and resources.

Code of Conduct

This project has adopted this Code of Conduct.

Contributing

Please check out common DSC Community contributing guidelines.

Change log

A full list of changes in each version can be found in the Releases.

Documentation

This script is used to easily create new DSC modules and resources.

Prerequisites

Be sure that the following DSC modules are installed on your system:

  • ModuleName (x.x.x)

DSC Resources and syntax

XOAP_AddServerToCollection

XOAP_DSCResource [String] #ResourceName
    {
        [DependsOn = [String[]]]
        [PsDscRunAsCredential = [PSCredential]]
    }

Configuration examples for each resource

You can review the Examples directory in the XOAPModuleTemplateDSC module for some general usage scenarios for all the resources that are in the module.

To implement the Module Template DSC module, add the following resources to your DSC configuration and adjust the parameters accordingly:

Add server to a collection

configuration 'XOAP_DSCResource'
{
    Import-DscResource -ModuleName 'XOAPModuleTemplateDSC' -Name 'XOAP_DSCResource' -ModuleVersion '0.0.1'
    
    XOAP_DSCResource 'Example'
    {
          DependsOn = @('[String[]]')
          PsDscRunAsCredential = [PSCredential]
    }
}
XOAP_DSCResource 

Create new DSC resource

DSC resources can easily be deployed via the invocation of

.\New-CompositeResource.ps1

with parameters

.\New-CompositeResource.ps1 -Module 'XOAPModuleTemplateDSC' -Version '0.0.1' -Resource 'DSCResource'