🩹 [Patch]: Support 5.1 (#41)

## Description

This pull request includes several changes to the PowerShell modules and
scripts, focusing on adding a new module for admin role functionalities
and updating existing scripts for better compatibility and
functionality.

- Fixes #40 

### Compatibility and Configuration:

*
[`src/manifest.psd1`](diffhunk://#diff-89820c99acb3b881e314c7e358eea621a8687cb4e0c687f541b9dcc9f30cc5dcR1-R3):
Added a manifest file specifying the required PowerShell version
(`5.1`).

### Script Updates:

*
[`src/variables/private/common.ps1`](diffhunk://#diff-43f49f109813a50f70fe2c6aef4729f89799983af5274aac8824887f527ec693L21-R21):
Updated the `$script:OS` variable assignment to include a check for
`PSEdition` being 'Desktop' to enhance compatibility across different
PowerShell editions.

## Type of change

<!-- Use the check-boxes [x] on the options that are relevant. -->

- [ ] 📖 [Docs]
- [ ] 🪲 [Fix]
- [ ] 🩹 [Patch]
- [ ] ⚠️ [Security fix]
- [ ] 🚀 [Feature]
- [ ] 🌟 [Breaking change]

## Checklist

<!-- Use the check-boxes [x] on the options that are relevant. -->

- [ ] I have performed a self-review of my own code
- [ ] I have commented my code, particularly in hard-to-understand areas

Author: MariusStorhaug

src/classes/private/Scope.ps1

@@ -1,4 +1,4 @@
-#Requires -Modules @{ ModuleName = 'Admin'; RequiredVersion = '1.1.3' }
+#Requires -Modules @{ ModuleName = 'Admin'; RequiredVersion = '1.1.5' }
 
 function Get-Font {
     <#
@@ -85,7 +85,8 @@ function Get-Font {
 
         # Specifies the scope of the font(s) to get.
         [Parameter(ValueFromPipelineByPropertyName)]
-        [Scope[]] $Scope = 'CurrentUser'
+        [ValidateSet('CurrentUser', 'AllUsers')]
+        [string[]] $Scope = 'CurrentUser'
     )
 
     begin {
@@ -96,8 +97,7 @@ function Get-Font {
     process {
         $scopeCount = $Scope.Count
         Write-Verbose "[$functionName] - Processing [$scopeCount] scope(s)"
-        foreach ($ScopeItem in $Scope) {
-            $scopeName = $ScopeItem.ToString()
+        foreach ($scopeName in $Scope) {
 
             Write-Verbose "[$functionName] - [$scopeName] - Getting font(s)"
             $fontFolderPath = $script:FontFolderPathMap[$script:OS][$scopeName]

src/functions/public/Get-Font.ps1

@@ -1,4 +1,4 @@
-#Requires -Modules @{ ModuleName = 'Admin'; RequiredVersion = '1.1.3' }
+#Requires -Modules @{ ModuleName = 'Admin'; RequiredVersion = '1.1.5' }
 
 function Install-Font {
     <#
@@ -119,7 +119,8 @@ function Install-Font {
         # CurrentUser will install the font for the current user only.
         # AllUsers will install the font so it is available for all users on the system.
         [Parameter(ValueFromPipelineByPropertyName)]
-        [string] $Scope = 'CurrentUser',
+        [ValidateSet('CurrentUser', 'AllUsers')]
+        [string[]] $Scope = 'CurrentUser',
 
         # Recurse will install all fonts in the specified folder and subfolders.
         [Parameter()]
@@ -148,8 +149,7 @@ Please run the command again with elevated rights (Run as Administrator) or prov
     process {
         $scopeCount = $Scope.Count
         Write-Verbose "[$functionName] - Processing [$scopeCount] scopes(s)"
-        foreach ($scopeItem in $Scope) {
-            $scopeName = $scopeItem.ToString()
+        foreach ($scopeName in $Scope) {
             $fontDestinationFolderPath = $script:FontFolderPathMap[$script:OS][$scopeName]
             $pathCount = $Path.Count
             Write-Verbose "[$functionName] - [$scopeName] - Processing [$pathCount] path(s)"
@@ -226,7 +226,7 @@ Please run the command again with elevated rights (Run as Administrator) or prov
                     if (-not $fileCopied) {
                         continue
                     }
-                    if ($IsWindows) {
+                    if ($script:OS -eq 'Windows') {
                         $fontType = $script:SupportedFonts | Where-Object { $_.Extension -eq $fontExtension } | Select-Object -ExpandProperty Type
                         $registeredFontName = "$fontName ($fontType)"
                         Write-Verbose "[$functionName] - [$scopeName] - [$fontFilePath] - Registering font as [$registeredFontName]"

src/functions/public/Install-Font.ps1

@@ -59,7 +59,8 @@
         # CurrentUser will uninstall the font for the current user.
         # AllUsers will uninstall the font so it is removed for all users.
         [Parameter(ValueFromPipelineByPropertyName)]
-        [Scope[]] $Scope = 'CurrentUser'
+        [ValidateSet('CurrentUser', 'AllUsers')]
+        [string[]] $Scope = 'CurrentUser'
     )
 
     begin {
@@ -80,9 +81,7 @@ Please run the command again with elevated rights (Run as Administrator) or prov
     process {
         $scopeCount = $Scope.Count
         Write-Verbose "[$functionName] - Processing [$scopeCount] scopes(s)"
-        foreach ($scopeItem in $Scope) {
-            $scopeName = $scopeItem.ToString()
-
+        foreach ($scopeName in $Scope) {
             $nameCount = $Name.Count
             Write-Verbose "[$functionName] - [$scopeName] - Processing [$nameCount] font(s)"
             foreach ($fontName in $Name) {
@@ -124,7 +123,7 @@ Please run the command again with elevated rights (Run as Administrator) or prov
                         }
                     }
 
-                    if ($IsWindows) {
+                    if ($script:OS -eq 'Windows') {
                         Write-Verbose "[$functionName] - [$scopeName] - [$fontName] - Searching for font in registry"
                         $keys = Get-ItemProperty -Path $script:FontRegPathMap[$scopeName]
                         $key = $keys.PSObject.Properties | Where-Object { $_.Value -eq $filePath }

src/functions/public/Uninstall-Font.ps1

@@ -0,0 +1,3 @@
+@{
+    PowerShellVersion = '5.1'
+}

src/manifest.psd1

@@ -18,7 +18,7 @@ $script:FontFolderPathMap = @{
     }
 }
 
-$script:OS = if ($IsWindows) {
+$script:OS = if ($IsWindows -or $PSEdition -eq 'Desktop') {
     'Windows'
 } elseif ($IsLinux) {
     'Linux'