Utilities.psm1
|
[Cmdletbinding()] param() $scriptName = $MyInvocation.MyCommand.Name Write-Verbose "[$scriptName] Importing subcomponents" #region - Data import Write-Verbose "[$scriptName] - [data] - Processing folder" $dataFolder = (Join-Path $PSScriptRoot 'data') Write-Verbose "[$scriptName] - [data] - [$dataFolder]" Get-ChildItem -Path "$dataFolder" -Recurse -Force -Include '*.psd1' -ErrorAction SilentlyContinue | ForEach-Object { Write-Verbose "[$scriptName] - [data] - [$($_.Name)] - Importing" New-Variable -Name $_.BaseName -Value (Import-PowerShellDataFile -Path $_.FullName) -Force Write-Verbose "[$scriptName] - [data] - [$($_.Name)] - Done" } Write-Verbose "[$scriptName] - [data] - Done" #endregion - Data import #region - From /public Write-Verbose "[$scriptName] - [/public] - Processing folder" #region - From /public/Base64 Write-Verbose "[$scriptName] - [/public/Base64] - Processing folder" #region - From /public/Base64/ConvertFrom-Base64String.ps1 Write-Verbose "[$scriptName] - [/public/Base64/ConvertFrom-Base64String.ps1] - Importing" filter ConvertFrom-Base64String { [CmdletBinding()] param ( # The string to convert from Base64 [Parameter( Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName )] [string] $Text ) $ConvertedString = [System.Convert]::FromBase64String($Text) $DecodedText = [System.Text.Encoding]::Unicode.GetString($ConvertedString) $DecodedText } Write-Verbose "[$scriptName] - [/public/Base64/ConvertFrom-Base64String.ps1] - Done" #endregion - From /public/Base64/ConvertFrom-Base64String.ps1 #region - From /public/Base64/ConvertTo-Base64String.ps1 Write-Verbose "[$scriptName] - [/public/Base64/ConvertTo-Base64String.ps1] - Importing" filter ConvertTo-Base64String { <# .SYNOPSIS Convert a string to Base64 .DESCRIPTION Convert a string to Base64 .EXAMPLE 'Hello World' | ConvertTo-Base64String SABlAGwAbABvACAAVwBvAHIAbABkAA== Converts the string 'Hello World' to Base64. #> [OutputType([string])] [CmdletBinding()] param( # The string to convert to Base64 [Parameter( Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName )] [string] $Text ) $bytes = [System.Text.Encoding]::Unicode.GetBytes($Text) $encodedText = [System.Convert]::ToBase64String($bytes) #$ADOToken = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$($PAT)")) $encodedText } Write-Verbose "[$scriptName] - [/public/Base64/ConvertTo-Base64String.ps1] - Done" #endregion - From /public/Base64/ConvertTo-Base64String.ps1 Write-Verbose "[$scriptName] - [/public/Base64] - Done" #endregion - From /public/Base64 #region - From /public/Boolean Write-Verbose "[$scriptName] - [/public/Boolean] - Processing folder" #region - From /public/Boolean/ConvertTo-Boolean.ps1 Write-Verbose "[$scriptName] - [/public/Boolean/ConvertTo-Boolean.ps1] - Importing" function ConvertTo-Boolean { [OutputType([bool])] [CmdletBinding()] param( [Parameter( Position = 0, ValueFromPipeline = $true)] [string] $String ) switch -regex ($String.Trim()) { '^(1|true|yes|on|enabled)$' { $true } default { $false } } } Write-Verbose "[$scriptName] - [/public/Boolean/ConvertTo-Boolean.ps1] - Done" #endregion - From /public/Boolean/ConvertTo-Boolean.ps1 Write-Verbose "[$scriptName] - [/public/Boolean] - Done" #endregion - From /public/Boolean #region - From /public/Files Write-Verbose "[$scriptName] - [/public/Files] - Processing folder" #region - From /public/Files/Get-FileInfo.ps1 Write-Verbose "[$scriptName] - [/public/Files/Get-FileInfo.ps1] - Importing" function Get-FileInfo { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [string] $Path ) if (-not (Test-Path -Path $Path)) { Write-Error 'Path does not exist' -ErrorAction Stop } $Item = Get-Item -Path $Path #If item is directory, fail if ($Item.PSIsContainer) { Write-Error 'Path is a directory' -ErrorAction Stop } $shell = New-Object -ComObject Shell.Application $shellFolder = $shell.Namespace($Item.Directory.FullName) $shellFile = $shellFolder.ParseName($Item.name) $fileDetails = New-Object pscustomobject foreach ($i in 0..1000) { $propertyName = $shellfolder.GetDetailsOf($null, $i) $propertyValue = $shellfolder.GetDetailsOf($shellfile, $i) if (-not [string]::IsNullOrEmpty($propertyValue)) { Write-Verbose "[$propertyName] - [$propertyValue]" $fileDetails | Add-Member -MemberType NoteProperty -Name $propertyName -Value $propertyValue } } return $fileDetails } Write-Verbose "[$scriptName] - [/public/Files/Get-FileInfo.ps1] - Done" #endregion - From /public/Files/Get-FileInfo.ps1 #region - From /public/Files/Remove-EmptyFolder.ps1 Write-Verbose "[$scriptName] - [/public/Files/Remove-EmptyFolder.ps1] - Importing" Function Remove-EmptyFolder { <# .SYNOPSIS Removes empty folders under the folder specified .DESCRIPTION Long description .PARAMETER Path The path to the folder to be cleaned .EXAMPLE Remove-EmptyFolder -Path . -Verbose Removes empty folders under the current path and outputs the results to the console. #> [CmdletBinding(SupportsShouldProcess)] param( [Parameter(Mandatory = $true)] [string] $Path ) Get-ChildItem -Path $Path -Recurse -Directory | ForEach-Object { if ($null -eq (Get-ChildItem $_.FullName -Force -Recurse)) { Write-Verbose "Removing empty folder: [$($_.FullName)]" if ($PSCmdlet.ShouldProcess("folder [$($_.FullName)]", 'Remove')) { Remove-Item $_.FullName -Force } } } } Write-Verbose "[$scriptName] - [/public/Files/Remove-EmptyFolder.ps1] - Done" #endregion - From /public/Files/Remove-EmptyFolder.ps1 Write-Verbose "[$scriptName] - [/public/Files] - Done" #endregion - From /public/Files #region - From /public/Git Write-Verbose "[$scriptName] - [/public/Git] - Processing folder" #region - From /public/Git/Clear-GitRepo.ps1 Write-Verbose "[$scriptName] - [/public/Git/Clear-GitRepo.ps1] - Importing" function Clear-GitRepo { <# .SYNOPSIS Clear a Git repository of all branches except main .DESCRIPTION Clear a Git repository of all branches except main .EXAMPLE Clear-GitRepo Clear a Git repository of all branches except main #> [OutputType([void])] [CmdletBinding()] param () git fetch --all --prune (git branch).Trim() | Where-Object { $_ -notmatch 'main|\*' } | ForEach-Object { git branch $_ --delete --force } } Write-Verbose "[$scriptName] - [/public/Git/Clear-GitRepo.ps1] - Done" #endregion - From /public/Git/Clear-GitRepo.ps1 #region - From /public/Git/Invoke-GitSquash.ps1 Write-Verbose "[$scriptName] - [/public/Git/Invoke-GitSquash.ps1] - Importing" function Invoke-GitSquash { <# .SYNOPSIS Squash all commits on a branch into a single commit .DESCRIPTION Squash all commits on a branch into a single commit .EXAMPLE Invoke-GitSquash Squash all commits on a branch into a single commit #> [OutputType([void])] [CmdletBinding()] [Alias('Squash-Main')] param( # The commit message to use for the squashed commit [Parameter()] [string] $CommitMessage = 'Squash', # The branch to squash [Parameter()] [string] $BranchName = 'main' ) git fetch --all --prune $gitHightFrom2ndCommit = [int](git rev-list --count --first-parent $BranchName) - 1 git reset HEAD~$gitHightFrom2ndCommit git commit -am "$CommitMessage" git push --force } Write-Verbose "[$scriptName] - [/public/Git/Invoke-GitSquash.ps1] - Done" #endregion - From /public/Git/Invoke-GitSquash.ps1 #region - From /public/Git/Reset-GitRepo.ps1 Write-Verbose "[$scriptName] - [/public/Git/Reset-GitRepo.ps1] - Importing" function Reset-GitRepo { <# .SYNOPSIS Reset a Git repository to the upstream branch .DESCRIPTION Reset a Git repository to the upstream branch .EXAMPLE Reset-GitRepo Reset a Git repository to the upstream branch #> [OutputType([void])] [CmdletBinding()] param( # The upstream repository to reset to [Parameter()] [string] $Upstream = 'upstream', # The branch to reset [Parameter()] [string] $Branch = 'main', # Whether to push the reset [Parameter()] [switch] $Push ) git fetch $Upstream git checkout $Branch git reset --hard $Upstream/$Branch if ($Push) { git push origin $Branch --force } } Set-Alias -Name Reset -Value Reset-Repo Write-Verbose "[$scriptName] - [/public/Git/Reset-GitRepo.ps1] - Done" #endregion - From /public/Git/Reset-GitRepo.ps1 #region - From /public/Git/Restore-GitRepo.ps1 Write-Verbose "[$scriptName] - [/public/Git/Restore-GitRepo.ps1] - Importing" function Restore-GitRepo { git remote add upstream https://github.com/Azure/ResourceModules.git git fetch upstream git restore --source upstream/main * ':!*global.variables.*' ':!settings.json*' } Write-Verbose "[$scriptName] - [/public/Git/Restore-GitRepo.ps1] - Done" #endregion - From /public/Git/Restore-GitRepo.ps1 #region - From /public/Git/Squash-Branch.ps1 Write-Verbose "[$scriptName] - [/public/Git/Squash-Branch.ps1] - Importing" function Squash-Branch { git reset $(git merge-base master $(git branch --show-current)) } Set-Alias -Name squash -Value Squash-Branch Write-Verbose "[$scriptName] - [/public/Git/Squash-Branch.ps1] - Done" #endregion - From /public/Git/Squash-Branch.ps1 #region - From /public/Git/Sync-GitRepo.ps1 Write-Verbose "[$scriptName] - [/public/Git/Sync-GitRepo.ps1] - Importing" function Sync-GitRepo { git fetch upstream --prune git pull git push } Set-Alias -Name sync -Value Sync-Git Write-Verbose "[$scriptName] - [/public/Git/Sync-GitRepo.ps1] - Done" #endregion - From /public/Git/Sync-GitRepo.ps1 #region - From /public/Git/Sync-Repo.ps1 Write-Verbose "[$scriptName] - [/public/Git/Sync-Repo.ps1] - Importing" function Sync-Repo { git checkout main git pull git remote update origin --prune git branch -vv | Select-String -Pattern ': gone]' | ForEach-Object { $_.toString().Trim().Split(' ')[0] } | ForEach-Object { git branch -D $_ } } Write-Verbose "[$scriptName] - [/public/Git/Sync-Repo.ps1] - Done" #endregion - From /public/Git/Sync-Repo.ps1 Write-Verbose "[$scriptName] - [/public/Git] - Done" #endregion - From /public/Git #region - From /public/GitHub Write-Verbose "[$scriptName] - [/public/GitHub] - Processing folder" #region - From /public/GitHub/Import-Variables.ps1 Write-Verbose "[$scriptName] - [/public/GitHub/Import-Variables.ps1] - Importing" function Import-Variables { [CmdletBinding()] param ( [Parameter( Mandatory, Position = 0, ValueFromPipeline = $true)] [string] $Path ) Write-Output "$($MyInvocation.MyCommand) - $Path - Processing" if (-not (Test-Path -Path $Path)) { throw "$($MyInvocation.MyCommand) - $Path - File not found" } $Variables = Get-Content -Path $Path -Raw -Force | ConvertFrom-Json $NestedVariablesFilePaths = ($Variables.PSObject.Properties | Where-Object Name -EQ 'VariablesFilePaths').Value foreach ($NestedVariablesFilePath in $NestedVariablesFilePaths) { Write-Output "$($MyInvocation.MyCommand) - $Path - Nested variable files - $NestedVariablesFilePath" $NestedVariablesFilePath | Import-Variables } Write-Output "$($MyInvocation.MyCommand) - $Path - Loading variables" foreach ($Property in $Variables.PSObject.Properties) { if ($Property -match 'VariablesFilePaths') { continue } Set-GitHubEnv -Name $Property.Name -Value $Property.Value -Verbose } Write-Output "$($MyInvocation.MyCommand) - $Path - Done" } Write-Verbose "[$scriptName] - [/public/GitHub/Import-Variables.ps1] - Done" #endregion - From /public/GitHub/Import-Variables.ps1 #region - From /public/GitHub/New-GitHubLogGroup.ps1 Write-Verbose "[$scriptName] - [/public/GitHub/New-GitHubLogGroup.ps1] - Importing" function New-GitHubLogGroup { [CmdletBinding()] param ( [Parameter()] [string] $Title ) Write-Output "::group::$Title" } Write-Verbose "[$scriptName] - [/public/GitHub/New-GitHubLogGroup.ps1] - Done" #endregion - From /public/GitHub/New-GitHubLogGroup.ps1 #region - From /public/GitHub/Set-GitHubEnv.ps1 Write-Verbose "[$scriptName] - [/public/GitHub/Set-GitHubEnv.ps1] - Importing" function Set-GitHubEnv { [CmdletBinding()] param ( [Parameter(Mandatory)] [string] $Name, [Parameter(Mandatory)] [string] $Value ) if ($PSBoundParameters.ContainsKey('Verbose')) { @{ "$Name" = $Value } | Format-Table -HideTableHeaders -Wrap } Write-Output "$Name=$Value" | Out-File -FilePath $Env:GITHUB_ENV -Encoding utf8 -Append } Write-Verbose "[$scriptName] - [/public/GitHub/Set-GitHubEnv.ps1] - Done" #endregion - From /public/GitHub/Set-GitHubEnv.ps1 Write-Verbose "[$scriptName] - [/public/GitHub] - Done" #endregion - From /public/GitHub #region - From /public/Hashtable Write-Verbose "[$scriptName] - [/public/Hashtable] - Processing folder" #region - From /public/Hashtable/Merge-Hashtables.ps1 Write-Verbose "[$scriptName] - [/public/Hashtable/Merge-Hashtables.ps1] - Importing" function Merge-Hashtables { [CmdletBinding()] param ( $Main, $Overrides ) $Main = [Hashtable]$Main $Overrides = [Hashtable]$Overrides $Output = $Main.Clone() ForEach ($Key in $Overrides.Keys) { if (($Output.Keys) -notcontains $Key) { $Output.$Key = $Overrides.$Key } if ($Overrides.item($Key) | IsNotNullOrEmpty) { $Output.$Key = $Overrides.$Key } } return $Output <# $env = [ordered]@{ Action = '' ResourceGroupName = 'env' Subscription = 'env' ManagementGroupID = '' Location = 'env' ModuleName = '' ModuleVersion = '' } Write-Output '`r`nEnvironment variables:' $env $inputs = [ordered]@{ Action = 'inputs' ResourceGroupName = '' Subscription = '' ManagementGroupID = '' Location = '' ModuleName = 'inputs' ModuleVersion = 'inputs' ParameterFilePath = '' ParameterFolderPath = '' ParameterOverrides = 'inputs' } Write-Output "`r`nEnvironment overrides:" $inputs $Params = Merge-Hashtables -Main $env -Overrides $inputs Write-Output "`r`nFinal parameters:" $Params #> } Write-Verbose "[$scriptName] - [/public/Hashtable/Merge-Hashtables.ps1] - Done" #endregion - From /public/Hashtable/Merge-Hashtables.ps1 Write-Verbose "[$scriptName] - [/public/Hashtable] - Done" #endregion - From /public/Hashtable #region - From /public/PowerShell Write-Verbose "[$scriptName] - [/public/PowerShell] - Processing folder" #region - From /public/PowerShell/Module Write-Verbose "[$scriptName] - [/public/PowerShell/Module] - Processing folder" #region - From /public/PowerShell/Module/Invoke-PruneModule.ps1 Write-Verbose "[$scriptName] - [/public/PowerShell/Module/Invoke-PruneModule.ps1] - Importing" function Invoke-PruneModule { [CmdletBinding()] [Alias('Prune-Module')] param ( [Parameter(Mandatory = $false)] [string[]] $Name = '*', [Parameter(Mandatory = $false)] [ValidateSet('CurrentUser', 'AllUsers')] [string[]] $Scope = 'CurrentUser' ) if ($Scope -eq 'AllUsers' -and -not (IsAdmin)) { throw "Administrator rights are required to uninstall modules for all users. Please run the command again with elevated rights (Run as Administrator) or provide '-Scope CurrentUser' to your command." } $UpdateableModules = Get-InstalledModule | Where-Object Name -Like "$Name" $UpdateableModuleNames = $UpdateableModules.Name | Sort-Object -Unique foreach ($UpdateableModuleName in $UpdateableModuleNames) { $UpdateableModule = $UpdateableModules | Where-Object Name -EQ $UpdateableModuleName | Sort-Object -Property Version -Descending Write-Verbose "[$($UpdateableModuleName)] - Found [$($UpdateableModule.Count)]" -Verbose $NewestModule = $UpdateableModule | Select-Object -First 1 Write-Verbose "[$($UpdateableModuleName)] - Newest [$($NewestModule.Version -join ', ')]" -Verbose $OutdatedModules = $UpdateableModule | Select-Object -Skip 1 Write-Verbose "[$($UpdateableModuleName)] - Outdated [$($OutdatedModules.Version -join ', ')]" -Verbose foreach ($OutdatedModule in $OutdatedModules) { Write-Verbose "[$($UpdateableModuleName)] - [$($OutdatedModule.Version)] - Removing" -Verbose $OutdatedModule | Remove-Module -Force Write-Verbose "[$($UpdateableModuleName)] - [$($OutdatedModule.Version)] - Uninstalling" -Verbose Uninstall-Module -Name $OutdatedModule.Name -RequiredVersion -Force try { $OutdatedModule.ModuleBase | Remove-Item -Force -Recurse -ErrorAction Stop } catch { Write-Warning "[$($UpdateableModuleName)] - [$($OutdatedModule.Version)] - Failed to remove [$($OutdatedModule.ModuleBase)]" continue } } } } Write-Verbose "[$scriptName] - [/public/PowerShell/Module/Invoke-PruneModule.ps1] - Done" #endregion - From /public/PowerShell/Module/Invoke-PruneModule.ps1 #region - From /public/PowerShell/Module/Invoke-ReinstallModule.ps1 Write-Verbose "[$scriptName] - [/public/PowerShell/Module/Invoke-ReinstallModule.ps1] - Importing" function Invoke-ReinstallModule { <# .SYNOPSIS Reinstalls module into a given scope. .DESCRIPTION Reinstalls module into a given scope. This is useful when you want to reinstall or clean up your module versions. With this command you always get the newest available version of the module and all the previous version wiped out. .PARAMETER Name The name of the module to be reinstalled. Wildcards are supported. .PARAMETER Scope The scope of the module to will be reinstalled to. .EXAMPLE Reinstall-Module -Name Pester -Scope CurrentUser Reinstall Pester module for the current user. .EXAMPLE Reinstall-Module -Scope CurrentUser Reinstall all reinstallable modules into the current user. .NOTES General notes #> [CmdletBinding()] [Alias('Reinstall-Module')] param ( [Parameter(Mandatory = $false)] [SupportsWildcards()] [string[]] $Name = '*', [Parameter(Mandatory = $false)] [ValidateSet('CurrentUser', 'AllUsers')] [string[]] $Scope = 'CurrentUser' ) if ($Scope -eq 'AllUsers' -and -not (IsAdmin)) { throw "Administrator rights are required to uninstall modules for all users. Please run the command again with elevated rights (Run as Administrator) or provide '-Scope CurrentUser' to your command." } $modules = Get-InstalledModule | Where-Object Name -Like "$Name" Write-Verbose "Found [$($modules.Count)] modules" -Verbose $modules | ForEach-Object { if ($_.name -eq 'Pester') { Uninstall-Pester -All continue } Uninstall-Module -Name $_ -AllVersions -Force -ErrorAction SilentlyContinue } $modules.Name | ForEach-Object { Install-Module -Name $_ -Scope $Scope -Force } } Write-Verbose "[$scriptName] - [/public/PowerShell/Module/Invoke-ReinstallModule.ps1] - Done" #endregion - From /public/PowerShell/Module/Invoke-ReinstallModule.ps1 #region - From /public/PowerShell/Module/Uninstall-Pester.ps1 Write-Verbose "[$scriptName] - [/public/PowerShell/Module/Uninstall-Pester.ps1] - Importing" function Uninstall-Pester { <# .SYNOPSIS Uninstall Pester 3 from Program Files and Program Files (x86) .DESCRIPTION Uninstall Pester 3 from Program Files and Program Files (x86). This is useful when you want to install Pester 4 and you have Pester 3 installed. .PARAMETER All .EXAMPLE Uninstall-Pester Uninstall Pester 3 from Program Files and Program Files (x86). .EXAMPLE Uninstall-Pester -All Completely remove all built-in Pester 3 installations. #> [OutputType([String])] [CmdletBinding()] param ( # Completely remove all built-in Pester 3 installations [Parameter()] [switch] $All ) $pesterPaths = foreach ($programFiles in ($env:ProgramFiles, ${env:ProgramFiles(x86)})) { $path = "$programFiles\WindowsPowerShell\Modules\Pester" if ($null -ne $programFiles -and (Test-Path $path)) { if ($All) { Get-Item $path } else { Get-ChildItem "$path\3.*" } } } if (-not $pesterPaths) { "There are no Pester$(if (-not $all) {' 3'}) installations in Program Files and Program Files (x86) doing nothing." return } foreach ($pesterPath in $pesterPaths) { takeown /F $pesterPath /A /R icacls $pesterPath /reset # grant permissions to Administrators group, but use SID to do # it because it is localized on non-us installations of Windows icacls $pesterPath /grant '*S-1-5-32-544:F' /inheritance:d /T Remove-Item -Path $pesterPath -Recurse -Force -Confirm:$false } } Write-Verbose "[$scriptName] - [/public/PowerShell/Module/Uninstall-Pester.ps1] - Done" #endregion - From /public/PowerShell/Module/Uninstall-Pester.ps1 Write-Verbose "[$scriptName] - [/public/PowerShell/Module] - Done" #endregion - From /public/PowerShell/Module #region - From /public/PowerShell/Object Write-Verbose "[$scriptName] - [/public/PowerShell/Object] - Processing folder" #region - From /public/PowerShell/Object/Copy-Object.ps1 Write-Verbose "[$scriptName] - [/public/PowerShell/Object/Copy-Object.ps1] - Importing" function Copy-Object { [OutputType([object])] [CmdletBinding()] param ( [Parameter(Mandatory, ValueFromPipeline)] [Object]$InputObject ) process { $InputObject | ConvertTo-Json -Depth 100 | ConvertFrom-Json } } Write-Verbose "[$scriptName] - [/public/PowerShell/Object/Copy-Object.ps1] - Done" #endregion - From /public/PowerShell/Object/Copy-Object.ps1 Write-Verbose "[$scriptName] - [/public/PowerShell/Object] - Done" #endregion - From /public/PowerShell/Object #region - From /public/PowerShell/PSCredential Write-Verbose "[$scriptName] - [/public/PowerShell/PSCredential] - Processing folder" #region - From /public/PowerShell/PSCredential/New-PSCredential.ps1 Write-Verbose "[$scriptName] - [/public/PowerShell/PSCredential/New-PSCredential.ps1] - Importing" function New-PSCredential { <# .SYNOPSIS Creates a PSCredential .DESCRIPTION Takes in a UserName and a plain text password and creates a PSCredential .EXAMPLE New-PSCredential -UserName "Admin" -Password "P@ssw0rd!" This creates a PSCredential with username "Admin" and password "P@ssw0rd!" .EXAMPLE New-PSCredential -UserName "Admin" Prompts user for password and creates a PSCredential with username "Admin" and password the user provided. .EXAMPLE $SecretPassword = "P@ssw0rd!" | ConvertTo-SecureString -Force New-PSCredential -UserName "Admin" -Password $SecretPassword #> [OutputType([System.Management.Automation.PSCredential])] [Cmdletbinding()] param( # The username of the PSCredential [Parameter()] [string] $Username = (Read-Host -Prompt 'Enter a username'), # The plain text password of the PSCredential [Parameter()] [SecureString] $Password = (Read-Host -Prompt 'Enter Password' -AsSecureString) ) $credential = New-Object -TypeName System.Management.Automation.PSCredential($Username, $Password) return $credential } Write-Verbose "[$scriptName] - [/public/PowerShell/PSCredential/New-PSCredential.ps1] - Done" #endregion - From /public/PowerShell/PSCredential/New-PSCredential.ps1 #region - From /public/PowerShell/PSCredential/Restore-PSCredential.ps1 Write-Verbose "[$scriptName] - [/public/PowerShell/PSCredential/Restore-PSCredential.ps1] - Importing" function Restore-PSCredential { <# .SYNOPSIS Restores a PSCredential from a file. .DESCRIPTION Takes in a UserName and restores a PSCredential from a file. .EXAMPLE Restore-PSCredential -UserName "Admin" This restores the PSCredential from the default location of $env:HOMEPATH\.creds\Admin.cred .EXAMPLE Restore-PSCredential -UserName "Admin" -Path "C:\Temp" This restores the PSCredential from the location of C:\Temp\Admin.cred #> [OutputType([System.Management.Automation.PSCredential])] [CmdletBinding()] param( # The username of the PSCredential [Parameter(Mandatory)] [string] $UserName, # The folder path to restore the PSCredential from. [Parameter()] [string] $Path = "$env:HOMEPATH\.creds" ) $fileName = "$UserName.cred" $credFilePath = Join-Path -Path $Path -ChildPath $fileName $credFilePathExists = Test-Path $credFilePath if ($credFilePathExists) { $secureString = Get-Content $credFilePath | ConvertTo-SecureString $credential = New-Object -TypeName System.Management.Automation.PSCredential($UserName, $secureString) } else { throw "Unable to locate a credential file for $($Username)" } return $credential } Write-Verbose "[$scriptName] - [/public/PowerShell/PSCredential/Restore-PSCredential.ps1] - Done" #endregion - From /public/PowerShell/PSCredential/Restore-PSCredential.ps1 #region - From /public/PowerShell/PSCredential/Save-PSCredential.ps1 Write-Verbose "[$scriptName] - [/public/PowerShell/PSCredential/Save-PSCredential.ps1] - Importing" function Save-PSCredential { <# .SYNOPSIS Saves a PSCredential to a file. .DESCRIPTION Takes in a PSCredential and saves it to a file. .EXAMPLE $Credential = New-PSCredential -UserName "Admin" -Password "P@ssw0rd!" Save-PSCredential -Credential $Credential This saves the PSCredential to the default location of $env:HOMEPATH\.creds\Admin.cred .EXAMPLE $Credential = New-PSCredential -UserName "Admin" -Password "P@ssw0rd!" Save-PSCredential -Credential $Credential -Path "C:\Temp" This saves the PSCredential to the location of C:\Temp\Admin.cred #> [OutputType([void])] [CmdletBinding()] param( # The PSCredential to save. [Parameter( Mandatory, ValueFromPipeline )] [System.Management.Automation.PSCredential] $Credential, # The folder path to save the PSCredential to. [Parameter()] [string] $Path = "$env:HOMEPATH\.creds" ) $fileName = "$($Credential.UserName).cred" $credFilePath = Join-Path -Path $Path -ChildPath $fileName $credFilePathExists = Test-Path $credFilePath if (-not $credFilePathExists) { try { $null = New-Item -ItemType File -Path $credFilePath -ErrorAction Stop -Force } catch { throw $_.Exception.Message } } $Credential.Password | ConvertFrom-SecureString | Out-File $credFilePath -Force } # $SecurePassword = ConvertTo-SecureString $PlainPassword -AsPlainText -Force # $BSTR = [System.Runtime.InteropServices.Marshal]::SecureStringToBSTR($SecurePassword) # $UnsecurePassword = [System.Runtime.InteropServices.Marshal]::PtrToStringAuto($BSTR) # [Runtime.InteropServices.Marshal]::ZeroFreeBSTR($BSTR) Write-Verbose "[$scriptName] - [/public/PowerShell/PSCredential/Save-PSCredential.ps1] - Done" #endregion - From /public/PowerShell/PSCredential/Save-PSCredential.ps1 Write-Verbose "[$scriptName] - [/public/PowerShell/PSCredential] - Done" #endregion - From /public/PowerShell/PSCredential #region - From /public/PowerShell/New-PSDynamicParameter.ps1 Write-Verbose "[$scriptName] - [/public/PowerShell/New-PSDynamicParameter.ps1] - Importing" Function New-PSDynamicParameter { <# .Synopsis Create a PowerShell dynamic parameter .Description This command will create the code for a dynamic parameter that you can insert into your PowerShell script file. .Link about_Functions_Advanced_Parameters #> [cmdletbinding()] [alias('ndp')] [outputtype([System.String[]])] Param( [Parameter(Position = 0, Mandatory, HelpMessage = "Enter the name of your dynamic parameter.`nThis is a required value.")] [ValidateNotNullOrEmpty()] [alias('Name')] [string[]]$ParameterName, [Parameter(Mandatory, HelpMessage = "Enter an expression that evaluates to True or False.`nThis is code that will go inside an IF statement.`nIf using variables, wrap this in single quotes.`nYou can also enter a placeholder like '`$True' and edit it later.`nThis is a required value.")] [ValidateNotNullOrEmpty()] [string]$Condition, [Parameter(HelpMessage = 'Is this dynamic parameter mandatory?')] [switch]$Mandatory, [Parameter(HelpMessage = 'Enter an optional default value.')] [object[]]$DefaultValue, [Parameter(HelpMessage = "Enter an optional parameter alias.`nSpecify multiple aliases separated by commas.")] [string[]]$Alias, [Parameter(HelpMessage = "Enter the parameter value type such as String or Int32.`nUse a value like string[] to indicate an array.")] [type]$ParameterType = 'string', [Parameter(HelpMessage = 'Enter an optional help message.')] [ValidateNotNullOrEmpty()] [string]$HelpMessage, [Parameter(HelpMessage = 'Does this dynamic parameter take pipeline input by property name?')] [switch]$ValueFromPipelineByPropertyName, [Parameter(HelpMessage = 'Enter an optional parameter set name.')] [ValidateNotNullOrEmpty()] [string]$ParameterSetName, [Parameter(HelpMessage = "Enter an optional comment for your dynamic parameter.`nIt will be inserted into your code as a comment.")] [ValidateNotNullOrEmpty()] [string]$Comment, [Parameter(HelpMessage = 'Validate that the parameter is not NULL or empty.')] [switch]$ValidateNotNullOrEmpty, [Parameter(HelpMessage = "Enter a minimum and maximum string length for this parameter value`nas an array of comma-separated set values.")] [ValidateNotNullOrEmpty()] [int[]]$ValidateLength, [Parameter(HelpMessage = 'Enter a set of parameter validations values')] [ValidateNotNullOrEmpty()] [object[]]$ValidateSet, [Parameter(HelpMessage = "Enter a set of parameter range validations values as a`ncomma-separated list from minimum to maximum")] [ValidateNotNullOrEmpty()] [int[]]$ValidateRange, [Parameter(HelpMessage = "Enter a set of parameter count validations values as a`ncomma-separated list from minimum to maximum")] [ValidateNotNullOrEmpty()] [int[]]$ValidateCount, [Parameter(HelpMessage = 'Enter a parameter validation regular expression pattern')] [ValidateNotNullOrEmpty()] [string]$ValidatePattern, [Parameter(HelpMessage = "Enter a parameter validation scriptblock.`nIf using the form, enter the scriptblock text.")] [ValidateNotNullOrEmpty()] [scriptblock]$ValidateScript ) Begin { Write-Verbose "[$((Get-Date).TimeofDay) BEGIN ] Starting $($myinvocation.mycommand)" $out = @" DynamicParam { $(If ($comment) { "$([char]35) $comment"}) If ($Condition) { `$paramDictionary = New-Object -Type System.Management.Automation.RuntimeDefinedParameterDictionary "@ } #begin Process { if (-Not $($PSBoundParameters.ContainsKey('ParameterSetName'))) { $PSBoundParameters.Add('ParameterSetName', '__AllParameterSets') } #get validation tests $Validations = $PSBoundParameters.GetEnumerator().Where({ $_.key -match '^Validate' }) #this is structured for future development where you might need to create #multiple dynamic parameters. This feature is incomplete at this time Foreach ($Name in $ParameterName) { Write-Verbose "[$((Get-Date).TimeofDay) PROCESS] Defining dynamic parameter $Name [$($parametertype.name)]" $out += "`n # Defining parameter attributes`n" $out += " `$attributeCollection = New-Object -Type System.Collections.ObjectModel.Collection[System.Attribute]`n" $out += " `$attributes = New-Object System.Management.Automation.ParameterAttribute`n" #add attributes $attributeProperties = 'ParameterSetName', 'Mandatory', 'ValueFromPipeline', 'ValueFromPipelineByPropertyName', 'ValueFromRemainingArguments', 'HelpMessage' foreach ($item in $attributeProperties) { if ($PSBoundParameters.ContainsKey($item)) { Write-Verbose "[$((Get-Date).TimeofDay) PROCESS] Defining $item" if ( $PSBoundParameters[$item] -is [string]) { $value = "'$($PSBoundParameters[$item])'" } else { $value = "`$$($PSBoundParameters[$item])" } $out += " `$attributes.$item = $value`n" } } #add parameter validations if ($validations) { Write-Verbose "[$((Get-Date).TimeofDay) PROCESS] Processing validations" foreach ($validation in $Validations) { Write-Verbose "[$((Get-Date).TimeofDay) PROCESS] ... $($validation.key)" $out += "`n # Adding $($validation.key) parameter validation`n" Switch ($Validation.key) { 'ValidateNotNullOrEmpty' { $out += " `$v = New-Object System.Management.Automation.ValidateNotNullOrEmptyAttribute`n" $out += " `$AttributeCollection.Add(`$v)`n" } 'ValidateLength' { $out += " `$value = @($($Validation.Value[0]),$($Validation.Value[1]))`n" $out += " `$v = New-Object System.Management.Automation.ValidateLengthAttribute(`$value)`n" $out += " `$AttributeCollection.Add(`$v)`n" } 'ValidateSet' { $join = "'$($Validation.Value -join "','")'" $out += " `$value = @($join) `n" $out += " `$v = New-Object System.Management.Automation.ValidateSetAttribute(`$value)`n" $out += " `$AttributeCollection.Add(`$v)`n" } 'ValidateRange' { $out += " `$value = @($($Validation.Value[0]),$($Validation.Value[1]))`n" $out += " `$v = New-Object System.Management.Automation.ValidateRangeAttribute(`$value)`n" $out += " `$AttributeCollection.Add(`$v)`n" } 'ValidatePattern' { $out += " `$value = '$($Validation.value)'`n" $out += " `$v = New-Object System.Management.Automation.ValidatePatternAttribute(`$value)`n" $out += " `$AttributeCollection.Add(`$v)`n" } 'ValidateScript' { $out += " `$value = {$($Validation.value)}`n" $out += " `$v = New-Object System.Management.Automation.ValidateScriptAttribute(`$value)`n" $out += " `$AttributeCollection.Add(`$v)`n" } 'ValidateCount' { $out += " `$value = @($($Validation.Value[0]),$($Validation.Value[1]))`n" $out += " `$v = New-Object System.Management.Automation.ValidateCountAttribute(`$value)`n" $out += " `$AttributeCollection.Add(`$v)`n" } } #close switch } #foreach validation } #validations $out += " `$attributeCollection.Add(`$attributes)`n" if ($Alias) { Write-Verbose "[$((Get-Date).TimeofDay) PROCESS] Adding parameter alias $($alias -join ',')" Foreach ($item in $alias) { $out += "`n # Adding a parameter alias`n" $out += " `$dynalias = New-Object System.Management.Automation.AliasAttribute -ArgumentList '$Item'`n" $out += " `$attributeCollection.Add(`$dynalias)`n" } } $out += "`n # Defining the runtime parameter`n" #handle the Switch parameter since it uses a slightly different name if ($ParameterType.Name -match 'Switch') { $paramType = 'Switch' } else { $paramType = $ParameterType.Name } $out += " `$dynParam1 = New-Object -Type System.Management.Automation.RuntimeDefinedParameter('$Name', [$paramType], `$attributeCollection)`n" if ($DefaultValue) { Write-Verbose "[$((Get-Date).TimeofDay) PROCESS] Using default value $($DefaultValue)" if ( $DefaultValue[0] -is [string]) { $value = "'$($DefaultValue)'" } else { $value = "`$$($DefaultValue)" } $out += " `$dynParam1.Value = $value`n" } $Out += @" `$paramDictionary.Add('$Name', `$dynParam1) "@ } #foreach dynamic parameter name } End { $out += @" return `$paramDictionary } # end if } #end DynamicParam "@ $out Write-Verbose "[$((Get-Date).TimeofDay) END ] Ending $($myinvocation.mycommand)" } #end } Write-Verbose "[$scriptName] - [/public/PowerShell/New-PSDynamicParameter.ps1] - Done" #endregion - From /public/PowerShell/New-PSDynamicParameter.ps1 Write-Verbose "[$scriptName] - [/public/PowerShell] - Done" #endregion - From /public/PowerShell #region - From /public/String Write-Verbose "[$scriptName] - [/public/String] - Processing folder" #region - From /public/String/IsGUID.ps1 Write-Verbose "[$scriptName] - [/public/String/IsGUID.ps1] - Importing" function IsGUID { [Cmdletbinding()] [OutputType([bool])] param ( [Parameter( Mandatory = $true, Position = 0, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true)] [string] $String ) [regex]$guidRegex = '(?im)^[{(]?[0-9A-F]{8}[-]?(?:[0-9A-F]{4}[-]?){3}[0-9A-F]{12}[)}]?$' # Check GUID against regex return $String -match $guidRegex } Write-Verbose "[$scriptName] - [/public/String/IsGUID.ps1] - Done" #endregion - From /public/String/IsGUID.ps1 #region - From /public/String/IsNotNullOrEmpty.ps1 Write-Verbose "[$scriptName] - [/public/String/IsNotNullOrEmpty.ps1] - Importing" function IsNotNullOrEmpty { [Cmdletbinding()] [OutputType([bool])] param( [Parameter( Position = 0, ValueFromPipeline = $true)] $Object ) return -not ($Object | IsNullOrEmpty) <# '' | IsNullOrEmpty -Verbose '' | IsNotNullOrEmpty -Verbose ' ' | IsNullOrEmpty -Verbose ' ' | IsNotNullOrEmpty -Verbose 'a' | IsNullOrEmpty -Verbose 'a' | IsNotNullOrEmpty -Verbose @' '@ | IsNullOrEmpty -Verbose @' '@ | IsNotNullOrEmpty -Verbose @' '@ | IsNullOrEmpty -Verbose @' '@ | IsNotNullOrEmpty -Verbose @' Test '@ | IsNullOrEmpty -Verbose @' Test '@ | IsNotNullOrEmpty -Verbose $null | IsNullOrEmpty -Verbose $null | IsNotNullOrEmpty -Verbose @{} | IsNullOrEmpty -Verbose @{} | IsNotNullOrEmpty -Verbose @{ Test = 'Test' } | IsNullOrEmpty -Verbose @{ Test = 'Test' } | IsNotNullOrEmpty -Verbose @{ Test = $null Null = '' } | IsNullOrEmpty -Verbose @{ Test = $null Null = '' } | IsNotNullOrEmpty -Verbose $Object = [pscustomobject]@{} $Object | IsNullOrEmpty -Verbose $Object | IsNotNullOrEmpty -Verbose $Object = [pscustomobject]@{ Something = Get-Date } $Object | IsNullOrEmpty -Verbose $Object | IsNotNullOrEmpty -Verbose #> } Write-Verbose "[$scriptName] - [/public/String/IsNotNullOrEmpty.ps1] - Done" #endregion - From /public/String/IsNotNullOrEmpty.ps1 #region - From /public/String/IsNullOrEmpty.ps1 Write-Verbose "[$scriptName] - [/public/String/IsNullOrEmpty.ps1] - Importing" function IsNullOrEmpty { [OutputType([bool])] [Cmdletbinding()] param( [Parameter( Mandatory, ValueFromPipeline )] [object] $Object ) try { if ($null -eq $Object) { Write-Verbose 'Object is null' return $true } if ($Object -eq 0) { Write-Verbose 'Object is 0' return $true } if ($Object.GetType() -eq [string]) { if ([String]::IsNullOrWhiteSpace($Object)) { Write-Verbose 'Object is empty string' return $true } else { return $false } } if ($Object.count -eq 0) { Write-Verbose 'Object count is 0' return $true } if (-not $Object) { Write-Verbose 'Object evaluates to false' return $true } if (($Object.GetType().Name -ne 'pscustomobject') -or $Object.GetType() -ne [pscustomobject]) { Write-Verbose 'Casting object to PSCustomObject' $Object = [pscustomobject]$Object } if (($Object.GetType().Name -eq 'pscustomobject') -or $Object.GetType() -eq [pscustomobject]) { if ($Object -eq (New-Object -TypeName pscustomobject)) { Write-Verbose 'Object is similar to empty PSCustomObject' return $true } if ($Object.psobject.Properties | IsNullOrEmpty) { Write-Verbose 'Object has no properties' return $true } } } catch { Write-Verbose 'Object triggered exception' return $true } return $false } Write-Verbose "[$scriptName] - [/public/String/IsNullOrEmpty.ps1] - Done" #endregion - From /public/String/IsNullOrEmpty.ps1 #region - From /public/String/Search-GUID.ps1 Write-Verbose "[$scriptName] - [/public/String/Search-GUID.ps1] - Importing" function Search-GUID { [Cmdletbinding()] [OutputType([guid])] param( [Parameter( Mandatory = $true, Position = 0, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true)] [string] $String ) Write-Verbose "Looking for a GUID in $String" $GUID = $String.ToLower() | Select-String -Pattern '[0-9a-f]{8}\-[0-9a-f]{4}\-[0-9a-f]{4}\-[0-9a-f]{4}\-[0-9a-f]{12}' | Select-Object -ExpandProperty Matches | Select-Object -ExpandProperty Value Write-Verbose "Found GUID: $GUID" return $GUID } Write-Verbose "[$scriptName] - [/public/String/Search-GUID.ps1] - Done" #endregion - From /public/String/Search-GUID.ps1 Write-Verbose "[$scriptName] - [/public/String] - Done" #endregion - From /public/String #region - From /public/TLS Write-Verbose "[$scriptName] - [/public/TLS] - Processing folder" #region - From /public/TLS/Get-TLSConfig.ps1 Write-Verbose "[$scriptName] - [/public/TLS/Get-TLSConfig.ps1] - Importing" function Get-TLSConfig { [OutputType(ParameterSetName = 'Default',[Net.SecurityProtocolType])] [OutputType(ParameterSetName = 'ListAvailable',[Array])] [CmdletBinding(DefaultParameterSetName = 'Default')] param( [Parameter(ParameterSetName = 'ListAvailable')] [switch] $ListAvailable ) if ($ListAvailable) { return [enum]::GetValues([Net.SecurityProtocolType]) } return [Net.ServicePointManager]::SecurityProtocol } Write-Verbose "[$scriptName] - [/public/TLS/Get-TLSConfig.ps1] - Done" #endregion - From /public/TLS/Get-TLSConfig.ps1 #region - From /public/TLS/Set-TLSConfig.ps1 Write-Verbose "[$scriptName] - [/public/TLS/Set-TLSConfig.ps1] - Importing" function Set-TLSConfig { <# .SYNOPSIS Set the TLS configuration for the current PowerShell session .DESCRIPTION Set the TLS configuration for the current PowerShell session .EXAMPLE Set-TLSConfig -Protocol Tls12 Set the TLS configuration for the current PowerShell session to TLS 1.2 #> [OutputType([void])] [CmdletBinding()] param( # The TLS protocol to enable [Parameter()] [Net.SecurityProtocolType[]] $Protocol = [Net.SecurityProtocolType]::Tls12 ) foreach ($protocolItem in $Protocol) { Write-Verbose "Enabling $protocolItem" [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor $protocolItem } } Write-Verbose "[$scriptName] - [/public/TLS/Set-TLSConfig.ps1] - Done" #endregion - From /public/TLS/Set-TLSConfig.ps1 Write-Verbose "[$scriptName] - [/public/TLS] - Done" #endregion - From /public/TLS #region - From /public/URI Write-Verbose "[$scriptName] - [/public/URI] - Processing folder" #region - From /public/URI/Join-Uri.ps1 Write-Verbose "[$scriptName] - [/public/URI/Join-Uri.ps1] - Importing" function Join-Uri { <# .SYNOPSIS Join a base URI with a child paths. .DESCRIPTION Join a base URI with a child paths to create a new URI. The child paths are normalized before joining with the base URI. .EXAMPLE Join-Uri -Path 'https://example.com' -ChildPath 'foo' -AdditionalChildPath 'bar' Joins the base URI 'https://example.com' with the child paths 'foo' and 'bar' to create the URI 'https://example.com/foo/bar'. .EXAMPLE Join-Uri 'https://example.com' '/foo/' '/bar/' '//baz/something/' '/test/' https://example.com/foo/bar/baz/something/test Combines the base URI 'https://example.com' with the child paths '/foo/', '/bar/', '//baz/something/', and '/test/'. #> param ( # The base URI to join with the child path. [Parameter(Mandatory)] [uri]$Path, # The child path to join with the base URI. [Parameter(Mandatory)] [string] $ChildPath, # Additional child paths to join with the base URI. [Parameter(ValueFromRemainingArguments)] [string[]] $AdditionalChildPath ) $segments = $ChildPath, $AdditionalChildPath $normalizedSegments = $segments | ForEach-Object { $_.Trim('/') } $uri = $Path.ToString().TrimEnd('/') + '/' + ($normalizedSegments -join '/') $uri } Write-Verbose "[$scriptName] - [/public/URI/Join-Uri.ps1] - Done" #endregion - From /public/URI/Join-Uri.ps1 Write-Verbose "[$scriptName] - [/public/URI] - Done" #endregion - From /public/URI #region - From /public/Windows Write-Verbose "[$scriptName] - [/public/Windows] - Processing folder" #region - From /public/Windows/winget Write-Verbose "[$scriptName] - [/public/Windows/winget] - Processing folder" #region - From /public/Windows/winget/Clean-WingetApps.ps1 Write-Verbose "[$scriptName] - [/public/Windows/winget/Clean-WingetApps.ps1] - Importing" function Clean-WingetApps { winget source update winget uninstall --id Microsoft.549981C3F5F10_8wekyb3d8bbwe winget uninstall --id Microsoft.Getstarted_8wekyb3d8bbwe winget uninstall --id Microsoft.BingNews_8wekyb3d8bbwe winget uninstall --id Microsoft.BingWeather_8wekyb3d8bbwe winget uninstall --id Microsoft.GetHelp_8wekyb3d8bbwe winget uninstall --id Microsoft.PowerAutomateDesktop_8wekyb3d8bbwe winget uninstall --id Microsoft.WindowsFeedbackHub_8wekyb3d8bbwe winget uninstall --id Microsoft.ZuneMusic_8wekyb3d8bbwe winget uninstall --id Microsoft.YourPhone_8wekyb3d8bbwe winget uninstall --id Microsoft.People_8wekyb3d8bbwe winget uninstall --id Microsoft.MicrosoftEdge.Stable_8wekyb3d8bbwe winget uninstall --id Microsoft.GamingApp_8wekyb3d8bbwe winget uninstall --id Microsoft.XboxGamingOverlay_8wekyb3d8bbwe winget uninstall --id Microsoft.XboxGameOverlay_8wekyb3d8bbwe winget uninstall --id Microsoft.XboxSpeechToTextOverlay_8wekyb3d8bbwe winget uninstall --id Microsoft.XboxIdentityProvider_8wekyb3d8bbwe winget uninstall --id Microsoft.Xbox.TCUI_8wekyb3d8bbwe winget uninstall --id MicrosoftTeams_8wekyb3d8bbwe winget uninstall --id Clipchamp.Clipchamp_yxz26nhyzhsrt winget uninstall --id microsoft.windowscommunicationsapps_8wekyb3d8bbwe } Write-Verbose "[$scriptName] - [/public/Windows/winget/Clean-WingetApps.ps1] - Done" #endregion - From /public/Windows/winget/Clean-WingetApps.ps1 Write-Verbose "[$scriptName] - [/public/Windows/winget] - Done" #endregion - From /public/Windows/winget #region - From /public/Windows/Show-FileExtension.ps1 Write-Verbose "[$scriptName] - [/public/Windows/Show-FileExtension.ps1] - Importing" function Show-FileExtension { [CmdletBinding(DefaultParameterSetName = 'On')] Param ( [Parameter(Mandatory = $true, ParameterSetName = 'On')] [System.Management.Automation.SwitchParameter] $On, [Parameter(Mandatory = $true, ParameterSetName = 'Off')] [System.Management.Automation.SwitchParameter] $Off ) Process { # Set a variable with the value we want to set on the registry value/subkey. if ($PSCmdlet.ParameterSetName -eq 'On') { $Value = 0 } if ($PSCmdlet.ParameterSetName -eq 'Off') { $Value = 1 } # Define the path to the registry key that contains the registry value/subkey $Path = 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced' # Set the registry value/subkey. Set-ItemProperty -Path $Path -Name HideFileExt -Value $Value # Refresh open Explorer windows. # You will need to refresh the window if you have none currently open. # Create the Shell.Application ComObject $Shell = New-Object -ComObject Shell.Application # For each one of the open windows, refresh it. $Shell.Windows() | ForEach-Object { $_.Refresh() } } } Write-Verbose "[$scriptName] - [/public/Windows/Show-FileExtension.ps1] - Done" #endregion - From /public/Windows/Show-FileExtension.ps1 #region - From /public/Windows/Show-HiddenFiles.ps1 Write-Verbose "[$scriptName] - [/public/Windows/Show-HiddenFiles.ps1] - Importing" function Show-HiddenFiles { [CmdletBinding(DefaultParameterSetName = 'On')] Param ( [Parameter(Mandatory = $true, ParameterSetName = 'On')] [System.Management.Automation.SwitchParameter] $On, [Parameter(Mandatory = $true, ParameterSetName = 'Off')] [System.Management.Automation.SwitchParameter] $Off ) Process { # Set a variable with the value we want to set on the registry value/subkey. if ($PSCmdlet.ParameterSetName -eq 'On') { $Value = 1 } if ($PSCmdlet.ParameterSetName -eq 'Off') { $Value = 2 } # Define the path to the registry key that contains the registry value/subkey $Path = 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced' # Set the registry value/subkey. Set-ItemProperty -Path $Path -Name Hidden -Value $Value # Refresh open Explorer windows. # You will need to refresh the window if you have none currently open. # Create the Shell.Application ComObject $Shell = New-Object -ComObject Shell.Application # For each one of the open windows, refresh it. $Shell.Windows() | ForEach-Object { $_.Refresh() } } } Write-Verbose "[$scriptName] - [/public/Windows/Show-HiddenFiles.ps1] - Done" #endregion - From /public/Windows/Show-HiddenFiles.ps1 #region - From /public/Windows/Test-Role.ps1 Write-Verbose "[$scriptName] - [/public/Windows/Test-Role.ps1] - Importing" function Test-Role { <# .SYNOPSIS Test if the current context is running as a specified role. .DESCRIPTION Test if the current context is running as a specified role. .EXAMPLE Test-Role -Role Administrator Test if the current context is running as an Administrator. .EXAMPLE Test-Role -Role User Test if the current context is running as a User. #> [OutputType([Boolean])] [CmdletBinding()] [alias('Test-Admin', 'Test-Administrator', 'IsAdmin', 'IsAdministrator')] param( [Security.Principal.WindowsBuiltInRole] $Role = 'Administrator' ) Write-Verbose "Test Role - [$Role]" $user = [Security.Principal.WindowsIdentity]::GetCurrent() $principal = New-Object Security.Principal.WindowsPrincipal($user) $isAdmin = $principal.IsInRole([Security.Principal.WindowsBuiltInRole]::$Role) Write-Verbose "Test Role - [$Role] - [$isAdmin]" return $isAdmin } Write-Verbose "[$scriptName] - [/public/Windows/Test-Role.ps1] - Done" #endregion - From /public/Windows/Test-Role.ps1 Write-Verbose "[$scriptName] - [/public/Windows] - Done" #endregion - From /public/Windows Write-Verbose "[$scriptName] - [/public] - Done" #endregion - From /public Export-ModuleMember -Function 'ConvertFrom-Base64String','ConvertTo-Base64String','ConvertTo-Boolean','Get-FileInfo','Remove-EmptyFolder','Clear-GitRepo','Invoke-GitSquash','Reset-GitRepo','Restore-GitRepo','Squash-Branch','Sync-GitRepo','Sync-Repo','Import-Variables','New-GitHubLogGroup','Set-GitHubEnv','Merge-Hashtables','Invoke-PruneModule','Invoke-ReinstallModule','Uninstall-Pester','Copy-Object','New-PSCredential','Restore-PSCredential','Save-PSCredential','New-PSDynamicParameter','IsGUID','IsNotNullOrEmpty','IsNullOrEmpty','Search-GUID','Get-TLSConfig','Set-TLSConfig','Join-Uri','Clean-WingetApps','Show-FileExtension','Show-HiddenFiles','Test-Role' -Cmdlet '' -Variable '' -Alias '' |