PublishModulesAndMofsToPullServer.psm1

<#
.Synopsis
   Package DSC modules and mof configuration document and publish them on enterprise DSC pull server in the required format
.DESCRIPTION
   Uses Publish-DSCModulesAndMofs cmdlet to package DSC modules into zip files with the version info. If 
   Publishes the zip modules on "$env:ProgramFiles\WindowsPowerShell\DscService\Modules"
   Publishes all mof configuration documents that present in $Source folder on "$env:ProgramFiles\WindowsPowerShell\DscService\Configuration"
   Use $Force to overwrite the version of the module that exists in powershell module path with the version from $source folder
   Use $ModuleNameList to specify the names of the modules to be published if the modules do not exist in $Source folder
   
.EXAMPLE
    $moduleList = @("xWebAdministration", "xPhp")
    Publish-DSCModulesAndMofs -Source C:\LocalDepot -ModuleNameList $moduleList
.EXAMPLE
    Publish-DSCModulesAndMofs -Source C:\LocalDepot -Force

#>

# Tools to use to package DSC modules and mof configuration document and publish them on enterprise DSC pull server in the required format

function Publish-DSCModulesAndMofs
{
param(

[Parameter(Mandatory=$True)]
[string]$Source = $pwd, # The folder that contains the configuration mof documents and modules to be published on pull server. Everything in this folder will be packaged and published.
[switch]$Force, #switch to overwrite the module in PSModulePath with the version provided in $Sources
[string[]]$ModuleNameList # Package and publish the modules listed in $ModuleNameList based on powershell module path content

)

#Create a working directory
$tempFolder = "$pwd\temp"
New-Item -Path $tempFolder -ItemType Directory -Force -ErrorAction SilentlyContinue

#Copy the mof documents from the $Source to working dir
Copy-Item -Path "$Source\*.mof" -Destination $tempFolder -Force -Verbose

#Start Deployment!
Write-Host "Start deployment"
CreateZipFromPSModulePath -listModuleNames $ModuleNameList -destination $tempFolder
CreateZipFromSource -source $Source -destination $tempFolder
# Generate the checkSum file for all the zip and mof files.
New-DSCCheckSum $tempFolder -Force
# Publish mof and modules to pull server repositories
PublishModulesAndChecksum -source $tempFolder
PublishMofDocuments -source $tempFolder
#Deployment is complete!
Remove-Item -Path $tempFolder -Recurse -Force -ErrorAction SilentlyContinue
Write-Host "End deployment"

}

#Package the modules using powershell module path
function CreateZipFromPSModulePath
{
   param($listModuleNames, $destination)
    # Move all required  modules from powershell module path to a temp folder and package them
    if(($listModuleNames -eq $null) -or ($listModuleNames.Count -eq 0))
    {
        Write-Host "No additional modules are specified to be packaged."
    }
    foreach ($module in $listModuleNames)
    {
        $allVersions = Get-Module -Name $module -ListAvailable -Verbose        
        #package all versions of the module
        foreach($moduleVersion in $allVersions)
        {
            $name = $moduleVersion.Name
            $source = "$destination\$name"
            #Create package zip
            $path  = $moduleVersion.ModuleBase
            Compress-Archive -Path "$path\*" -DestinationPath "$source.zip" -Verbose -Force 
            $version = $moduleVersion.Version.ToString()
            $newName = "$destination\$name" + "_" + "$version" + ".zip"
            # Rename the module folder to contain the version info.
            if(Test-Path($newName))
            {
                Remove-Item $newName -Recurse -Force 
            }
            Rename-Item -Path "$source.zip" -NewName $newName -Force
            
          } 
    }   

}
#Function to package modules using a given folder after installing to ps module path.
function CreateZipFromSource
{
   param($source, $destination)
   # for each module under $Source folder create a zip package that has the same name as the folder. 
    $allModulesInSource = Get-ChildItem $source -Directory
    $modules = @()
   
    foreach ($item in $allModulesInSource)
    {
        $name = $item.Name
        $alreadyExists = Get-Module -Name $name -ListAvailable -Verbose
        if(($alreadyExists -eq $null) -or ($Force))
        {
            #install the modules into powershell module path and overwrite the content 
            Copy-Item $item.FullName -Recurse -Force -Destination "$env:ProgramFiles\WindowsPowerShell\Modules" -Verbose            
        }              
        else
        {
            Write-Host "Skipping module overwrite. Module with the name $name already exists. Please specify -Force to overwrite the module with the local version of the module located in $source or list names of the modules in ModuleNameList parameter to be packaged from powershell module pat instead and remove them from $source folder" -Fore Red
        }
        $modules+= @("$name")
    }
    #Package the module in $destination
    CreateZipFromPSModulePath -listModuleNames $modules -destination $destination
}


# Deploy modules to the pullsever repository.
function PublishModulesAndChecksum
{
    param($source)
    # Check if the current machine is a server sku.
    $moduleRepository = "$env:ProgramFiles\WindowsPowerShell\DscService\Modules"
    if( (Get-Module ServerManager -ListAvailable) -and (Test-Path ($moduleRepository)))
    {
        Copy "$source\*.zip*" $moduleRepository -Force -Verbose
    }
    else
    {
        Write-Host "Copying modules to pullserver module repository skipped because the machine is not a server sku or Pull server endpoint is not deployed." -Fore Yellow
    }   
    
}

# function deploy configuratoin and thier checksum.
function PublishMofDocuments
{
   param($source)
    # Check if the current machine is a server sku.
    $mofRepository = "$env:ProgramFiles\WindowsPowerShell\DscService\Configuration"
    if( (Get-Module ServerManager -ListAvailable) -and (Test-Path ($mofRepository)) )    
    {
        Copy-Item "$source\*.mof*" $mofRepository -Force -Verbose
    }
    else
    {
        Write-Host "Copying configuration(s) to pullserver configuration repository skipped because the machine is not a server sku or Pull server endpoint is not deployed." -Fore Yellow
    } 
}