New-StatusFile.ps1

<#
    .SYNOPSIS
 
    This function tests for and creates the log file / log file path for the script.
 
    .DESCRIPTION
 
    This function tests for and creates the log file / log file path for the script.
 
    .PARAMETER logFolderPath
 
    The path of the log file.
 
    .OUTPUTS
 
    Ensure the directory exists.
    Establishes the logfile path/name for subsequent function calls.
 
    .EXAMPLE
 
    new-statusFile -logFolderPath LOGFOLDERPATH
 
    #>

    Function new-statusFile
     {
        [cmdletbinding()]

        Param
        (
            [Parameter(Mandatory = $true)]
            [string]$logFolderPath
        )

        #Output all parameters bound or unbound and their associated values.

        write-functionParameters -keyArray $MyInvocation.MyCommand.Parameters.Keys -parameterArray $PSBoundParameters -variableArray (Get-Variable -Scope Local -ErrorAction Ignore)
   
        # Get our log file path

        $logFolderPath = $logFolderPath+$global:statusPath

        #Set the global status path.

        $global:fullStatusPath = $logFolderPath

        #Test the path to see if this exists if not create.

        [boolean]$pathExists = Test-Path -Path $logFolderPath

        if ($pathExists -eq $false)
        {
            try 
            {
                #Path did not exist - Creating

                New-Item -Path $logFolderPath -Type Directory
            }
            catch 
            {
                throw $_
            } 
        }
    }