Utilities.psm1
|
#region - From classes/using.ps1 using namespace System.Net #endregion - From classes/using.ps1 #region - From classes/Windows/common.ps1 $DocsPath = [environment]::GetFolderPath('MyDocuments') $CommonDocsPath = [environment]::GetFolderPath('CommonDocuments') $DesktopPath = [environment]::GetFolderPath('Desktop') $CommonDesktopPath = [environment]::GetFolderPath('CommonDesktop') #$shellApplication = New-Object -ComObject Shell.Application #$DownloadPath = $shellApplication.NameSpace('shell:Downloads').Self.Path $StartMenuPath = [environment]::GetFolderPath('StartMenu') $CommonStartMenuPath = [environment]::GetFolderPath('CommonStartMenu') $FontsPath = [environment]::GetFolderPath('Fonts') $IPConfigFilePath = "$([Environment]::GetFolderPath('MyDocuments'))\IPConfig.json" #endregion - From classes/Windows/common.ps1 #region - From public/Git/Clear-GitRepo.ps1 function Clear-GitRepo { <# .SYNOPSIS Deletes all branches except main and the current branch #> git fetch --all --prune (git branch).Trim() | Where-Object { $_ -notmatch 'main|\*' } | ForEach-Object { git branch $_ --delete --force } } #endregion - From public/Git/Clear-GitRepo.ps1 #region - From public/Git/Invoke-GitSquash.ps1 function Invoke-GitSquash { [CmdletBinding()] [Alias('Squash-Main')] param( [Parameter()] [string] $CommitMessage = '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 } #endregion - From public/Git/Invoke-GitSquash.ps1 #region - From public/Git/Reset-GitRepo.ps1 function Reset-Repo { param( $Upstream = 'upstream', $Branch = 'main', [bool]$Push = $true ) 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 #endregion - From public/Git/Reset-GitRepo.ps1 #region - From public/Git/Restore-GitRepo.ps1 function Restore-Repo { git remote add upstream https://github.com/Azure/ResourceModules.git git fetch upstream git restore --source upstream/main * ':!*global.variables.*' ':!settings.json*' } #endregion - From public/Git/Restore-GitRepo.ps1 #region - From public/Git/Squash-Branch.ps1 function Squash-Branch { git reset $(git merge-base master $(git branch --show-current)) } Set-Alias -Name squash -Value Squash-Branch #endregion - From public/Git/Squash-Branch.ps1 #region - From public/Git/Sync-GitRepo.ps1 function Sync-Git { git fetch upstream --prune git pull git push } Set-Alias -Name sync -Value Sync-Git #endregion - From public/Git/Sync-GitRepo.ps1 #region - From public/Git/Sync-Repo.ps1 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 $_ } } #endregion - From public/Git/Sync-Repo.ps1 #region - From public/Boolean/ConvertTo-Boolean.ps1 function ConvertTo-Boolean { [CmdletBinding()] param( [Parameter( Position = 0, ValueFromPipeline = $true)] [string] $String ) switch -regex ($String.Trim()) { '^(1|true|yes|on|enabled)$' { $true } default { $false } } } #endregion - From public/Boolean/ConvertTo-Boolean.ps1 #region - From public/PowerShell/Invoke-PruneModule.ps1 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 } } } } #endregion - From public/PowerShell/Invoke-PruneModule.ps1 #region - From public/PowerShell/Invoke-ReinstallModule.ps1 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 } } #endregion - From public/PowerShell/Invoke-ReinstallModule.ps1 #region - From public/PowerShell/New-PSDynamicParameter.ps1 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 } #endregion - From public/PowerShell/New-PSDynamicParameter.ps1 #region - From public/PowerShell/Uninstall-Pester.ps1 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 Completely remove all built-in Pester 3 installations .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. #> [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 } } #endregion - From public/PowerShell/Uninstall-Pester.ps1 #region - From public/PowerShell/PSCredential/New-PSCredential.ps1 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" -Password (Read-Host -Prompt "Enter Password" -AsSecureString) This creates a PSCredential with username "Admin" and password by prompting the user for the password .EXAMPLE $SecretPassword = "P@ssw0rd!" | ConvertTo-SecureString -AsPlainText -Force New-PSCredential -UserName "Admin" -Password $SecretPassword #> [OutputType([System.Management.Automation.PSCredential])] [Cmdletbinding()] param( # The username of the PSCredential [Parameter(Mandatory)] [string] $UserName = (Read-Host -Prompt 'Enter a UserName'), # The plain text password of the PSCredential [Parameter(Mandatory)] [ValidateScript({ ($_ -is [System.Security.SecureString]) -or ($_ -is [System.String]) })] [object] $Password = (Read-Host -Prompt 'Enter Password' -AsSecureString) ) try { if ($Password -is [System.String]) { $Password = $Password | ConvertTo-SecureString -AsPlainText -Force } $credential = New-Object -TypeName System.Management.Automation.PSCredential($UserName, $Password) } catch { throw $_.Exception.Message } return $credential } #endregion - From public/PowerShell/PSCredential/New-PSCredential.ps1 #region - From public/PowerShell/PSCredential/Restore-PSCredential.ps1 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 } #endregion - From public/PowerShell/PSCredential/Restore-PSCredential.ps1 #region - From public/PowerShell/PSCredential/Save-PSCredential.ps1 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) #endregion - From public/PowerShell/PSCredential/Save-PSCredential.ps1 #region - From public/String/IsGUID.ps1 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 } #endregion - From public/String/IsGUID.ps1 #region - From public/String/IsNotNullOrEmpty.ps1 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 #> } #endregion - From public/String/IsNotNullOrEmpty.ps1 #region - From public/String/IsNullOrEmpty.ps1 function IsNullOrEmpty { [Cmdletbinding()] [OutputType([bool])] param( [Parameter( Position = 0, ValueFromPipeline = $true)] $Object ) if ($PSBoundParameters.Keys.Contains('Verbose')) { Write-Output 'Received object:' $Object Write-Output "Length is: $($Object.Length)" -ea continue Write-Output "Count is: $($Object.Count)" -ea continue try { Write-Output "Enumerator: $($Object.GetEnumerator())" -ea continue } catch {} 'PSObject' $Object.PSObject 'PSObject -- BaseObject' $Object.PSObject.BaseObject 'PSObject -- BaseObject -- BaseObject' $Object.PSObject.BaseObject.PSObject.BaseObject 'PSObject -- BaseObject -- Properties' $Object.PSObject.BaseObject.PSObject.Properties | Select-Object Name, @{n = 'Type'; e = { $_.TypeNameOfValue } }, Value | Format-Table -AutoSize 'PSObject -- Properties' $Object.PSObject.Properties | Select-Object Name, @{n = 'Type'; e = { $_.TypeNameOfValue } }, Value | Format-Table -AutoSize } 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 } #Evaluate Empty objects 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 } #endregion - From public/String/IsNullOrEmpty.ps1 #region - From public/String/Search-GUID.ps1 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 } #endregion - From public/String/Search-GUID.ps1 #region - From public/Base64/ConvertFrom-Base64String.ps1 Function ConvertFrom-Base64String { [CmdletBinding()] param ( [Parameter( Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName)] [string] $Text ) $ConvertedString = [System.Convert]::FromBase64String($Text) $DecodedText = [System.Text.Encoding]::Unicode.GetString($ConvertedString) return $DecodedText } #endregion - From public/Base64/ConvertFrom-Base64String.ps1 #region - From public/Base64/ConvertTo-Base64String.ps1 Function ConvertTo-Base64String { param( # Parameter help description [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)")) return $EncodedText } #endregion - From public/Base64/ConvertTo-Base64String.ps1 #region - From public/TLS/Get-TLSConfig.ps1 function Get-TLSConfig { [CmdletBinding()] param( [Parameter()] [switch] $ListAvailable ) if ($ListAvailable) { return [enum]::GetValues([Net.SecurityProtocolType]) } return [Net.ServicePointManager]::SecurityProtocol } #endregion - From public/TLS/Get-TLSConfig.ps1 #region - From public/TLS/Set-TLFConfig.ps1 function Set-TLSConfig { [CmdletBinding()] param( [Parameter()] [Net.SecurityProtocolType[]] $Protocol = [Net.SecurityProtocolType]::Tls12 ) foreach ($protocolItem in $Protocol) { Write-Verbose "Enabling $protocolItem" [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor $protocolItem } } #endregion - From public/TLS/Set-TLFConfig.ps1 #region - From public/Windows/Show-FileExtension.ps1 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() } } } #endregion - From public/Windows/Show-FileExtension.ps1 #region - From public/Windows/Show-HiddenFiles.ps1 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() } } } #endregion - From public/Windows/Show-HiddenFiles.ps1 #region - From public/Windows/Test-Role.ps1 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 } #endregion - From public/Windows/Test-Role.ps1 #region - From public/Windows/winget/Clean-WingetApps.ps1 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 } #endregion - From public/Windows/winget/Clean-WingetApps.ps1 #region - From public/Files/Get-FileInfo.ps1 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 } #endregion - From public/Files/Get-FileInfo.ps1 #region - From public/Files/Remove-EmptyFolder.ps1 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 } } } } #endregion - From public/Files/Remove-EmptyFolder.ps1 #region - From public/Hashtable/Merge-Hashtables.ps1 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 #> } #endregion - From public/Hashtable/Merge-Hashtables.ps1 #region - From public/GitHub/Import-Variables.ps1 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" } #endregion - From public/GitHub/Import-Variables.ps1 #region - From public/GitHub/New-GitHubLogGroup.ps1 function New-GitHubLogGroup { [CmdletBinding()] param ( [Parameter()] [string] $Title ) Write-Output "::group::$Title" } #endregion - From public/GitHub/New-GitHubLogGroup.ps1 #region - From public/GitHub/Set-GitHubEnv.ps1 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 } #endregion - From public/GitHub/Set-GitHubEnv.ps1 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','New-PSCredential','Restore-PSCredential','Save-PSCredential','Invoke-PruneModule','Invoke-ReinstallModule','New-PSDynamicParameter','Uninstall-Pester','IsGUID','IsNotNullOrEmpty','IsNullOrEmpty','Search-GUID','Get-TLSConfig','Set-TLFConfig','Clean-WingetApps','Show-FileExtension','Show-HiddenFiles','Test-Role' -Cmdlet '*' -Variable '*' -Alias '*' |