Public/Set-ModuleFormat.ps1

function Set-ModuleFormat {
    <#
    .SYNOPSIS
        EXPIRIMENTAL: Set FormatsToProcess

        [string]$FormatsPath in a module manifest

    .FUNCTIONALITY
        CI/CD

    .DESCRIPTION
        EXPIRIMENTAL: Set FormatsToProcess

        [string]$FormatsPath in a module manifest

    .PARAMETER Name
        Name or path to module to inspect. Defaults to ProjectPath\ProjectName via Get-BuildVariable

    .PARAMETER FormatsToProcess
        Array of .ps1xml files

    .PARAMETER FormatsRelativePath
        Path to the ps1xml files relatives to the root of the module (example: ".\Format")

    .NOTES
        Major thanks to Joel Bennett for the code behind working with the psd1
            Source: https://github.com/PoshCode/Configuration

    .EXAMPLE
        Set-ModuleFormat -FormatsRelativePath '.\Format'

        Update module manifiest FormatsToProcess parameters with all the .ps1xml present in the .\Format folder.

    .LINK
        https://github.com/RamblingCookieMonster/BuildHelpers

    .LINK
        about_BuildHelpers
    #>

    [CmdLetBinding( SupportsShouldProcess )]
    param(
        [parameter(ValueFromPipeline = $True)]
        [Alias('Path')]
        [string]$Name,

        [string[]]$FormatsToProcess,

        [string]$FormatsRelativePath
    )
    Process
    {
        if(-not $Name)
        {
            $BuildDetails = Get-BuildVariable
            $Name = Join-Path ($BuildDetails.ProjectPath) (Get-ProjectName)
        }

        $params = @{
            Force = $True
            Passthru = $True
            Name = $Name
        }

        # Create a runspace
        $PowerShell = [Powershell]::Create()

        # Add scriptblock to the runspace
        [void]$PowerShell.AddScript({
            Param ($Force, $Passthru, $Name)
            $module = Import-Module -Name $Name -PassThru:$Passthru -Force:$Force
            $module | Where-Object Path -notin $module.Scripts

        }).AddParameters($Params)

        #Invoke the command
        $Module = $PowerShell.Invoke()

        if(-not $Module)
        {
            Throw "Could not find module '$Name'"
        }

        $Parent = $Module.ModuleBase
        $File = "$($Module.Name).psd1"
        $ModulePSD1Path = Join-Path $Parent $File
        if(-not (Test-Path $ModulePSD1Path))
        {
            Throw "Could not find expected module manifest '$ModulePSD1Path'"
        }

        if(-not $FormatsToProcess)
        {
            $FormatPath = Join-Path -Path $Parent -ChildPath $FormatsRelativePath
            $FormatList = Get-ChildItem -Path (Join-Path $FormatPath "*.ps1xml")

            $FormatsToProcess = @()
            Foreach ($Item in $FormatList) {
                $FormatsToProcess += Join-Path -Path $FormatsRelativePath -ChildPath $Item.Name
            }
        }

        If ($PSCmdlet.ShouldProcess("Updating Module's FormatsToProcess")) {
            Update-MetaData -Path $ModulePSD1Path -PropertyName FormatsToProcess -Value $FormatsToProcess
        }

        # Close down the runspace
        $PowerShell.Dispose()
    }
}