Add Support for Creating Temp Folder

Fixes #30

Axium/1.5.0/Functions/New-AxiumSubfolder.ps1

@@ -0,0 +1,60 @@
+function New-AxiumSubfolder {
+    <#
+        .SYNOPSIS
+            Creates a subfolder under a folder containing a copy of axiUm.
+
+        .DESCRIPTION
+            Creates a subfolder under a folder containing a copy of axiUm. This is useful to create a folder to
+            hold temporary files, such as the ones needed for printing letters.
+
+            Aliases: nas
+
+        .INPUTS
+            System.String
+
+        .OUTPUTS
+            System.IO.DirectoryInfo
+
+        .NOTES
+            Author    : Dan Thompson
+            Copyright : 2020 Case Western Reserve University
+    #>
+
+    [CmdletBinding(SupportsShouldProcess)]
+    [OutputType([System.IO.DirectoryInfo])]
+
+    param(
+        # The path to a folder that may contain a copy of axiUm.
+        #
+        # Aliases: p
+        [Parameter(
+            Position = 0,
+            ValueFromPipeline = $True,
+            ValueFromPipelineByPropertyName = $True,
+            Mandatory = $True
+        )]
+        [ValidateNotNullOrEmpty()]
+        [string]$Path,
+
+        # The name of the folder to create if it doesn't already exist.
+        #
+        # Aliases: n
+        [ValidateNotNullOrEmpty()]
+        [string]$Name = 'Temp'
+    )
+
+    process {
+        $Output = $Null
+
+        if ($Path | Test-AxiumCopy -Verbose:$VerbosePreference) {
+            Write-Verbose -Message """$Path"" contains a copy of axiUm."
+            $Output = New-Item -Path $Path -Name $Name -Verbose:$VerbosePreference -WhatIf:$WhatIfPreference
+        } else {
+            Write-Verbose -Message """$Path doesn't contain a copy of axiUm. Nothing to do."
+        }
+
+        $Output
+    }
+}
+
+New-Alias -Name 'nas' -Value 'New-AxiumSubfolder'

CHANGELOG.md

@@ -38,4 +38,4 @@
 * Added missing documentation for `Test-AxiumCopy` to `README.MD`. Fixes issue #29.
 
 # Version 1.5.0
-
+* Added `New-AxiumSubfolder`. Fixes issue #30.

README.md

@@ -61,6 +61,7 @@ You will probably want to call the following functions directly:
 * `Install-AxiumWorkstation`
 * `Write-AxiumFix`
 * `Test-AxiumCopy`
+* `New-AxiumSubfolder`
 
 The following are used mainly by other functions, and usually don't need to be called directly:
 * `Get-IPAddresses`