Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
182 lines (141 sloc) 7.43 KB
.GUID 8e576300-141f-4381-96ea-a59d1f2837d2
.AUTHOR Nik Charlebois
.TAGS Technolgy,ReverseDSC
* Initial Release;
#Requires -Modules @{ModuleName="ReverseDSC";ModuleVersion=""},@{ModuleName="[**TechDSCModule]";ModuleVersion="[**TechDSCModuleVersion]"}
Extracts the DSC Configuration of an existing [**TechName] environment, allowing you to analyze it or to replicate it.
<## Script Settings #>
$VerbosePreference = "SilentlyContinue"
<## Scripts Variables #>
$Script:dscConfigContent = "" # Core Variable that will contain the content of your DSC output script. Leave empty;
$DSCSource = "[**TechDSCModulePath]" # Path to the root folder of your technology's DSC Module (e.g. C:\Program Files\WindowsPowerShell\SharePointDSC);
$DSCVersion = "" # Version of the DSC module for the technology (e.g.;
$Script:DSCPath = $DSCSource + $DSCVersion # Dynamic path to include the version number as a folder;
$Script:configName = "[**ConfigName]" # Name of the output configuration. This will be the name that follows the Configuration keyword in the output script;
<# Retrieves Information about the current script from the PSScriptInfo section above #>
try {
$currentScript = Test-ScriptFileInfo $SCRIPT:MyInvocation.MyCommand.Path
$Script:version = $currentScript.Version.ToString()
catch {
$Script:version = "N/A"
<## This is the main function for this script. It acts as a call dispatcher, calling the various functions required in the proper order to
get the full picture of the environment; #>
function Orchestrator
<# Import the ReverseDSC Core Engine #>
$ReverseDSCModule = "ReverseDSC.Core.psm1"
$module = (Join-Path -Path $PSScriptRoot -ChildPath $ReverseDSCModule -Resolve -ErrorAction SilentlyContinue)
if($module -eq $null)
$module = "ReverseDSC"
Import-Module -Name $module -Force
$Script:dscConfigContent += "<# Generated with [**TechName].Reverse " + $script:version + " #>`r`n"
$Script:dscConfigContent += "Configuration $Script:configName`r`n"
$Script:dscConfigContent += "{`r`n"
Write-Host "Configuring Dependencies..." -BackgroundColor DarkGreen -ForegroundColor White
$Script:dscConfigContent += " Node $env:COMPUTERNAME`r`n"
$Script:dscConfigContent += " {`r`n"
Write-Host "Scanning [**Resource Description]..." -BackgroundColor DarkGreen -ForegroundColor White
Write-Host "Configuring Local Configuration Manager (LCM)..." -BackgroundColor DarkGreen -ForegroundColor White
$Script:dscConfigContent += "`r`n }`r`n"
$Script:dscConfigContent += "}`r`n"
Write-Host "Setting Configuration Data..." -BackgroundColor DarkGreen -ForegroundColor White
$Script:dscConfigContent += "$Script:configName -ConfigurationData `$ConfigData"
#region Reverse Functions
function Read-[**ResourceName]()
$module = Resolve-Path ($Script:DSCPath + "\DSCResources\[**ResourceName]\[**ResourceName].psm1")
Import-Module $module
$params = Get-DSCFakeParameters -ModulePath $module
<# Setting Primary Keys #>
# $params.Name = "1234"
$results = Get-TargetResource @params
$Script:dscConfigContent += " [**ResourceName] " + [System.Guid]::NewGuid().toString() + "`r`n"
$Script:dscConfigContent += " {`r`n"
$Script:dscConfigContent += Get-DSCBlock -Params $results -ModulePath $module
$Script:dscConfigContent += " }`r`n"
# Sets the DSC Configuration Data for the current server;
function Set-ConfigurationData
$Script:dscConfigContent += "`$ConfigData = @{`r`n"
$Script:dscConfigContent += " AllNodes = @(`r`n"
$tempConfigDataContent += " @{`r`n"
$tempConfigDataContent += " NodeName = `"$env:COMPUTERNAME`";`r`n"
$tempConfigDataContent += " PSDscAllowPlainTextPassword = `$true;`r`n"
$tempConfigDataContent += " PSDscAllowDomainUser = `$true;`r`n"
$tempConfigDataContent += " }`r`n"
$Script:dscConfigContent += $tempConfigDataContent
$Script:dscConfigContent += ")}`r`n"
<## This function ensures all required DSC Modules are properly loaded into the current PowerShell session. #>
function Set-Imports
$Script:dscConfigContent += " Import-DscResource -ModuleName PSDesiredStateConfiguration`r`n"
$Script:dscConfigContent += " Import-DscResource -ModuleName [**DSCModuleName] -ModuleVersion `"" + $DSCVersion + "`"`r`n"
<## This function sets the settings for the Local Configuration Manager (LCM) component on the server we will be configuring using our resulting DSC Configuration script. The LCM component is the one responsible for orchestrating all DSC configuration related activities and processes on a server. This method specifies settings telling the LCM to not hesitate rebooting the server we are configurating automatically if it requires a reboot (i.e. During the SharePoint Prerequisites installation). Setting this value helps reduce the amount of manual interaction that is required to automate the configuration of our SharePoint farm using our resulting DSC Configuration script. #>
function Set-LCM
$Script:dscConfigContent += " LocalConfigurationManager" + "`r`n"
$Script:dscConfigContent += " {`r`n"
$Script:dscConfigContent += " RebootNodeIfNeeded = `$True`r`n"
$Script:dscConfigContent += " }`r`n"
<# This function is responsible for saving the output file onto disk. #>
function Get-ReverseDSC()
<## Call into our main function that is responsible for extracting all the information about our environment; #>
<## Prompts the user to specify the FOLDER path where the resulting PowerShell DSC Configuration Script will be saved. #>
$fileName = "[**TechName].DSC.ps1"
$OutputDSCPath = Read-Host "Please enter the full path of the output folder for DSC Configuration (will be created as necessary)"
<## Ensures the specified output folder path actually exists; if not, tries to create it and throws an exception if we can't. ##>
while (!(Test-Path -Path $OutputDSCPath -PathType Container -ErrorAction SilentlyContinue))
Write-Output "Directory `"$OutputDSCPath`" doesn't exist; creating..."
New-Item -Path $OutputDSCPath -ItemType Directory | Out-Null
if ($?) {break}
Write-Warning "$($_.Exception.Message)"
Write-Warning "Could not create folder $OutputDSCPath!"
$OutputDSCPath = Read-Host "Please Enter Output Folder for DSC Configuration (Will be Created as Necessary)"
<## Ensures the path we specify ends with a Slash, in order to make sure the resulting file path is properly structured. #>
if(!$OutputDSCPath.EndsWith("\") -and !$OutputDSCPath.EndsWith("/"))
$OutputDSCPath += "\"
<## Save the content of the resulting DSC Configuration file into a file at the specified path. #>
$outputDSCFile = $OutputDSCPath + $fileName
$Script:dscConfigContent | Out-File $outputDSCFile
Write-Output "Done."
<## Wait a couple of seconds, then open our $outputDSCPath in Windows Explorer so we can review the glorious output. ##>
Start-Sleep 2
Invoke-Item -Path $OutputDSCPath