public/New-Directory.ps1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
<#
    .Synopsis
        Create a directory if it does not exist.
    .Description
        Create a directory if it does not exist.
    .Example
        PS C:\> New-Directory -Path "C:\Temp\New Folder"
        Creates "New Folder" if it does not exist.
#>

function New-Directory {
    [CmdletBinding(SupportsShouldProcess = $true)]
    param (
        # The location of the directory to create.
        [Parameter(Mandatory = $true)]
        [String]
        $Path
    )

    begin {
        Write-LogMessage -Message "Started execution"
    }

    process {
        if (-not (Test-Path -Path $Path) -and $PSCmdlet.ShouldProcess($Path, "creating directory")) {
            New-Item -Path $Path -ItemType Directory -Force
        }
    }

    end {
        Write-LogMessage -Message "Finished execution"
    }
}