feat: initial commit

Author: ssokolic

New-CompositeRessource.ps1

@@ -0,0 +1,75 @@
+#Requires -Modules @{ ModuleName="Plaster"; ModuleVersion="1.1.3" }
+
+[CmdletBinding()]
+param (
+    [Parameter(Mandatory=$true)]
+    [ValidateNotNullOrEmpty()]
+    [string]
+    $Module,
+    [Parameter(Mandatory=$true)]
+    [ValidateNotNullOrEmpty()]
+    [string]
+    $Version,
+    [Parameter(Mandatory=$true)]
+    [ValidateNotNullOrEmpty()]
+    [string]
+    $Ressource,
+    [Parameter()]
+    [ValidateNotNullOrEmpty()]
+    [string]
+    $Company = "XOSS"
+)
+
+$globalPrefix = "XOSS"
+$curDirectory = Resolve-Path .\
+$templatePath = Join-Path $curDirectory "templates"
+$rootModulePath = Resolve-Path ..\..\
+$Module = "${globalPrefix}${Module}DSC"
+$modulePath = Join-Path $rootModulePath "$Module"
+$moduleVersionPath = Join-Path $modulePath $Version
+$moduleRessources = Join-Path $moduleVersionPath "DSCResources"
+$ressourcePath = Join-Path $moduleRessources $Ressource
+
+
+Write-Output "Checking if module $Module already exists under $moduleVersionPath"
+
+if(Test-Path "$moduleVersionPath")
+{
+    Write-Output  "Module $Module with version $Version already exists. Continuing."
+}
+else
+{
+    Write-Warning  "Module $Module with version $Version does not exist. Creating new module. Please provide missing data."
+    $template = Join-Path $templatePath "shared_module"
+    $moduleData = @{
+        project_name = $Module
+        version = $Version
+        company = $Company
+        TemplatePath = "$template"
+        DestinationPath = "$moduleVersionPath"
+    }
+
+    Invoke-Plaster @moduleData
+}
+
+
+Write-Output "Going to check if ressource $Ressource exists under $ressourcePath"
+
+if(Test-Path "$ressourcePath")
+{
+    Write-Error "Ressource $Ressource already exists. Aborting"
+}
+else
+{
+    Write-Output "Creating new ressource $Ressource for module $Module"
+    $template = Join-Path $templatePath "composite_resource"
+    $moduleData = @{
+        project_name = "${Ressource}"
+        version = "1.0.0"
+        company = $Company
+        TemplatePath = "$template"
+        DestinationPath = "$ressourcePath"
+    }
+
+    Invoke-Plaster @moduleData
+}

Readme.md

@@ -0,0 +1,37 @@
+# Getting started
+
+This scripts are used to easly create new dsc composite ressources.
+
+## Prerequisites
+
+Please install Plaster at first and make sure it's present.
+
+´´PowerShell
+Install-Module Plaster
+Import-Module Plaster
+``
+
+## Creating new modules
+
+Modules will be automatically created once you are creating a new composite ressource.
+
+## Creating new composite ressources
+
+Composite ressources can easily be deployed via the invocation of
+
+´´PowerShell
+ .\New-CompositeRessource.ps1
+ ``
+
+with parameters
+
+´´PowerShell
+ .\New-CompositeRessource.ps1 -Module W2K19DC1903Baseline -Version 1.0.0 -Ressource ScheduledTasks
+ ``
+The parameter list is as followed:
+
+|Parameter      |Description                                |Note
+| ------------- | ----------------------------------------- | ------------- |
+|Module         |Name of the outer module part              | -
+|Version        |Target version of the module               | -
+|Ressource      |The name of the ressource /config part     | -

modules/XOSSBaselineW2k19DSC/0.1.0/.gitignore

@@ -0,0 +1 @@
+.DS_Store

modules/XOSSBaselineW2k19DSC/0.1.0/DSCResources/ScheduledTasks/ScheduledTasks.psd1

@@ -0,0 +1,122 @@
+#
+# Module manifest for module 'ScheduledTasks'
+#
+# Generated by: XOAP
+#
+# Generated on: 12.05.2022
+#
+
+@{
+
+# Script module or binary module file associated with this manifest.
+RootModule = 'ScheduledTasks.schema.psm1'
+
+# Version number of this module.
+ModuleVersion = '1.0.0'
+
+# Supported PSEditions
+# CompatiblePSEditions = @()
+
+# ID used to uniquely identify this module
+GUID = 'e4833b1b-2639-4be2-9e65-7e3d5f4a8ef0'
+
+# Author of this module
+Author = 'XOAP'
+
+# Company or vendor of this module
+CompanyName = 'XOAP'
+
+# Copyright statement for this module
+Copyright = '(c) XOAP.io. All rights reserved.'
+
+# Description of the functionality provided by this module
+Description = 'ScheduledTasks'
+
+# Minimum version of the PowerShell engine required by this module
+# PowerShellVersion = ''
+
+# Name of the PowerShell host required by this module
+# PowerShellHostName = ''
+
+# Minimum version of the PowerShell host required by this module
+# PowerShellHostVersion = ''
+
+# Minimum version of Microsoft .NET Framework required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
+# DotNetFrameworkVersion = ''
+
+# Minimum version of the common language runtime (CLR) required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
+# CLRVersion = ''
+
+# Processor architecture (None, X86, Amd64) required by this module
+# ProcessorArchitecture = ''
+
+# Modules that must be imported into the global environment prior to importing this module
+# RequiredModules = @()
+
+# Assemblies that must be loaded prior to importing this module
+# RequiredAssemblies = @()
+
+# Script files (.ps1) that are run in the caller's environment prior to importing this module.
+# ScriptsToProcess = @()
+
+# Type files (.ps1xml) to be loaded when importing this module
+# TypesToProcess = @()
+
+# Format files (.ps1xml) to be loaded when importing this module
+# FormatsToProcess = @()
+
+# Modules to import as nested modules of the module specified in RootModule/ModuleToProcess
+# NestedModules = @()
+
+# Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export.
+FunctionsToExport = '*'
+
+# Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.
+CmdletsToExport = '*'
+
+# Variables to export from this module
+VariablesToExport = '*'
+
+# Aliases to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no aliases to export.
+AliasesToExport = '*'
+
+# DSC resources to export from this module
+# DscResourcesToExport = @()
+
+# List of all modules packaged with this module
+# ModuleList = @()
+
+# List of all files packaged with this module
+# FileList = @()
+
+# Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell.
+PrivateData = @{
+
+    PSData = @{
+
+        # Tags applied to this module. These help with module discovery in online galleries.
+        # Tags = @()
+
+        # A URL to the license for this module.
+        # LicenseUri = ''
+
+        # A URL to the main website for this project.
+        # ProjectUri = ''
+
+        # A URL to an icon representing this module.
+        # IconUri = ''
+
+        # ReleaseNotes of this module
+        # ReleaseNotes = ''
+
+    } # End of PSData hashtable
+
+} # End of PrivateData hashtable
+
+# HelpInfo URI of this module
+# HelpInfoURI = ''
+
+# Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
+# DefaultCommandPrefix = ''
+
+}

modules/XOSSBaselineW2k19DSC/0.1.0/DSCResources/ScheduledTasks/ScheduledTasks.schema.psm1

@@ -0,0 +1,22 @@
+configuration ScheduledTasks
+{
+    [CmdletBinding()]
+    param (
+        [Parameter()]
+        [TypeName]
+        $ParameterName
+    )
+
+    #Import-DSCResource -ModuleName xPSDesiredStateConfiguration
+    #
+    #xRegistry disableInsecureCipher_a
+    #{
+    #    Key       = 'HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Ciphers\DES 56/56'
+    #    ValueName = 'Enabled'
+    #    ValueData = '0'
+    #    ValueType = 'Dword'
+    #    Ensure    = 'Present'
+    #    Force     = $true
+    #}
+
+}

modules/XOSSBaselineW2k19DSC/0.1.0/Examples/dsc_configuration.ps1

@@ -0,0 +1,26 @@
+configuration default
+{
+    param
+    (
+        # Target nodes to apply the configuration
+        [string[]]$NodeName = 'localhost'
+    )
+
+    Import-Module XOAPBaselineW2k19DSC
+    Import-DSCResource -ModuleName XOAPBaselineW2k19DSC
+
+    Node $NodeName
+    {
+
+        $moduleRoot = [io.path]::GetDirectoryName((Get-Module XOAPBaselineW2k19DSC).Path)
+        $examples = "$moduleRoot\Examples"
+
+        # Install the IIS role
+        WindowsFeature IIS
+        {
+            Ensure          = "Present"
+            Name            = "Web-Server"
+        }
+
+    }
+}

modules/XOSSBaselineW2k19DSC/0.1.0/README.md

@@ -0,0 +1,39 @@
+# XOSSBaselineW2k19DSC
+
+The XOSSBaselineW2k19DSC PowerShell module provides
+DSC resources that can be used to ... (explain what functionality the resources are meant to provide)
+
+## Installation
+
+To manually install the module, download the source code and unzip the contents
+of the \Modules\XOSSBaselineW2k19DSC 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 XOSSBaselineW2k19DSC -Repository PSGallery | Install-Module
+
+To confirm installation, run the below command and ensure you see the
+XOSSBaselineW2k19DSC DSC resoures available:
+
+    Get-DscResource -Module XOSSBaselineW2k19DSC
+
+## Usage
+
+Include the following in your DSC configuration
+
+    Import-DSCResource -ModuleName XOSSBaselineW2k19DSC
+
+### MyResource
+
+    MyResource resourceName {
+        Ensure  =   "Present"
+    }
+
+## Requirements
+
+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.
+