My collection of random bits of PowerShell scripts I find very useful. These could be full PowerShell scripts, PowerShell functions, PowerShell modules, or smaller bits.
Get Chocolatey Package Version
Created 2019-07-21
This is a simple PowerShell function I created that simply gets the version of the Chocolatey package URL parameter.
Get-ChocoPackageVersion
function Get-ChocoPackageVersion {
# Gets the version of the Chocolatey package specified by the URL using the -ChocoPackageVersion parameter.
# Defaults to GoogleChrome if you do not specify the ChocoPackageURL parameter.
[cmdletbinding()]
param(
[Parameter(Position=0)]
[String]$ChocoPackageURL = "https://chocolatey.org/packages/GoogleChrome"
)
$script:ChocoPackageVersion = ((Invoke-RestMethod -Uri $ChocoPackageURL).Split("`r`n") | Select-String "<title>").ToString() -split " " | Select-Object -Last 1
}
Get-ChocoPackageVersion -ChocoPackageURL "https://chocolatey.org/packages/notepadplusplus"
Write-Output "`nRetrieved package version: [$script:ChocoPackageVersion]"Output
Retrieved package version: [7.7.1]
Pronounceable Random Password
Github:
https://github.com/tjgruber/New-Passwd
Creates a random password that is actually pronounceable, making it possible to remember, but more importantly in my case, much quicker to type.
I converted this handy Script Bit from a PHP equivalent a colleague of mine had created a number of years ago. There is a single “Length” switch that allows you to specify the number of syllables that are produced.
New-Passwd -Length 4 -Count 10
Script
function New-Passwd {
<#
.SYNOPSIS
A simple script that generates a random, but human-pronounceable password.
.DESCRIPTION
Version: 2.0
This script creates a random password based on human-pronounceable syllables.
You can adjust the number of syllables, and when working with it interactively,
includes the ability to generate multiple passwords. The generated password
will include a symbol character in a random location, and a 2-4 digit number suffix.
When integrating this function into a script, you'll likely want to use the -HideOutput
switch to prevent the password from being outputted to the console.
.EXAMPLE
New-Passwd
Default generates one password that is four (4) syllables long, 15-17 character length total.
Example output:
PS > Jabgot@darsay8472
.EXAMPLE
New-Passwd -Length 20 -Count 5
Generates 5 passwords that are each 20-syllables long.
Example output:
PS > Neoreonuasantotlenlodjusveitavfihpotretvifruajigvuolua;tiuket6348
PS > Coasuukocfekbestajbacnutbabheptaksegcui.sesnadsotjuncaesojpou7255
PS > Paeruamohsadheimukbanneakui;pujgodmejsuinegjaobitfoffejgafheu2701
PS > Hapdaobagtiecokbihlubkiurubroelephep-munlijdumgemcuspagmuvkub4728
PS > Dejtegbia{gonbimpilpiltavvardiiribdujsevvujfovripdornopjiodoj3586
.EXAMPLE
New-Passwd -HideOutput
Generates one default password that is four (4) syllables long, 15-17 character length total,
and does not show the output. It is useful to include this switch when calling from within
a script where you will be using the $script:Passwd variable elsewhere.
Default is to write output.
Example output:
PS >
#>
[cmdletbinding()]
param(
[Parameter(Position=0)]
#Default length in syllables.
[Int]$Length = 4,
[Parameter(Position=1)]
#Default number of passwords to create.
[Int]$Count = 1,
[Parameter(Position=2)]
#Hides the output. useful when used within a script.
[Switch]$HideOutput
)
Begin {
#consonants except hard to speak ones
[Char[]]$lowercaseConsonants = "bcdfghjklmnprstv"
[Char[]]$uppercaseConsonants = "BCDFGHJKLMNPRSTV"
#vowels
[Char[]]$lowercaseVowels = "aeiou"
#both
$lowercaseConsantsVowels = $lowercaseConsonants+$lowercaseVowels
#numbers
[Char[]]$numbers = "0123456789"
#special characters
[Char[]]$specialCharacters = '!$.;#@{+&}?:+_="%>-*/^'+"'"
$countNum = 0
}
Process {
while ($countNum -le $Count-1) {
$script:Passwd = ''
#random location for special char between first syllable and length
$specialCharSpot = Get-Random -Minimum 1 -Maximum $Length
for ($i=0; $i -lt $Length; $i++) {
if ($i -eq $specialCharSpot) {
#add a special char
$script:Passwd += ($specialCharacters | Get-Random -Count 1)
}
#Start with uppercase
if ($i -eq 0) {
$script:Passwd += ($uppercaseConsonants | Get-Random -Count 1)
} else {
$script:Passwd += ($lowercaseConsonants | Get-Random -Count 1)
}
$script:Passwd += ($lowercaseVowels | Get-Random -Count 1)
$script:Passwd += ($lowercaseConsantsVowels | Get-Random -Count 1)
}
#add a number at the end
$randNumNum = Get-Random -Minimum 2 -Maximum 5
$script:Passwd += (($numbers | Get-Random -Count $randNumNum)-join '')
if ($HideOutput) {
# The $Passwd is not shown as output.
} else {
Write-Output "$script:Passwd"
}
$countNum++
}
}
}
Output
Bepnemluo>tia687
Tohhap-viaboi654
Rukhujduf{ril159
Nimfulbeg_run206
Pohrod(vigfuc270
Kiefao+rarsob179
Pon&pocfatder854
Par{faesekpas627
Fionav>ceaguh684
Cojvidcod!cad808
Set an Intune Win32 LoB App’s Category
Github:
https://github.com/tjgruber/Set-IntuneAppCategory
Adds or removes an Intune Win32 LoB app to or from an Intune app category based on a CategoryName match or exact CategoryId parameter.
I had a need for a function like this inside of an Azure DevOps release pipeline script. Here’s the result.
Set-IntuneAppCategory -CategoryName “App Category Name” -Add -AppId “662f02ca-eaba-4798-a20b-abab4214c0bd”
Script
<####################################################
# SET INTUNE APP CATEGORY
####################################################>
function Set-IntuneAppCategory {
<#
.SYNOPSIS
Adds or removes an Intune Win32 LoB app to or from an Intune app category.
.DESCRIPTION
Adds or removes an Intune Win32 LoB app to or from an Intune app category based on a CategoryName match or exact CategoryId parameter.
.PARAMETER CategoryName
The name of the category to match.
.PARAMETER CategoryId
The ID of the category. This needs to be exact.
.PARAMETER Add
Adds specified app to specified category.
.PARAMETER Remove
Removes specified app to specified category.
.PARAMETER AppId
The ID of the app.
.EXAMPLE
Set-IntuneAppCategory -CategoryName "Test group 0" -Add -AppId "662f02ca-eaba-4798-a20b-abab4214c0bd"
.EXAMPLE
Set-IntuneAppCategory -CategoryName "Test group 0" -Remove -AppId "662f02ca-eaba-4798-a20b-abab4214c0bd"
.NOTES
This is designed as an internal script function rather than a stand-alone function, but will work if you input the correct parameters.
.LINK
https://TimothyGruber.com
#>
[cmdletbinding()]
param(
[Parameter(Mandatory,ParameterSetName='CategoryName')]
[string]$CategoryName,
[Parameter(Mandatory,ParameterSetName='CategoryId')]
[string]$CategoryId,
[Parameter()]
[switch]$Add,
[Parameter()]
[switch]$Remove,
[Parameter(Mandatory)]
[string]$AppId
)
if ($CategoryName) {
$intuneAppGetCategoryNameIdUri = 'https://graph.microsoft.com/beta/deviceAppManagement/mobileAppCategories'
$intuneAppGetCategoryNameIdRequest = @{
ContentType = "application/json";
Method = "Get";
Uri = $intuneAppGetCategoryNameIdURI;
ErrorAction = "SilentlyContinue";
ErrorVariable = "intuneAppGetCategoryNameIdERR"
}
Invoke-GraphAPIAuthTokenCheck
$setintuneAppGetCategoryNameIdDATA = (Invoke-RestMethod -Headers $global:graphAPIReqHeader @intuneAppGetCategoryNameIdRequest)
if ($intuneAppGetCategoryNameIdERR) {
Write-Output "...ERROR - There was a problem retrieving setintuneAppGetCategoryNameIdDATA - [$intuneAppGetCategoryNameIdERR]"
}
$matchedCategoryNameId = $setintuneAppGetCategoryNameIdDATA.value | Where-Object {$_.displayName -match $CategoryName}
if (-not($matchedCategoryNameId)) {
Write-Output "...ERROR - Could not match input of [$CategoryName] to an Intune Mobile App Category."
}
$intuneAppGetCategoryIdUri = "https://graph.microsoft.com/beta/deviceAppManagement/mobileAppCategories/$($matchedCategoryNameId.id)"
$CategoryId = $matchedCategoryNameId.id
}
if ($Add) {
$requestMethod = "Post"
$intuneAppAddCategoryUri = "https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/$appId/categories/`$ref"
$intuneAppAddCategoryBody = @{
'@odata.id' = $intuneAppGetCategoryIdUri
}
$intuneAppSetCategoryRequest = @{
ContentType = "application/json";
Body = ($intuneAppAddCategoryBody | ConvertTo-Json);
Method = $requestMethod;
Uri = $intuneAppAddCategoryUri;
ErrorAction = "SilentlyContinue";
ErrorVariable = "intuneAppCategoryERR"
}
}
if ($Remove) {
$requestMethod = "Delete"
$intuneAppRemoveCategoryUri = "https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/$appId/categories/$categoryId/`$ref"
$intuneAppSetCategoryRequest = @{
ContentType = "application/json";
Method = $requestMethod;
Uri = $intuneAppRemoveCategoryUri;
ErrorAction = "SilentlyContinue";
ErrorVariable = "intuneAppCategoryERR"
}
}
Invoke-GraphAPIAuthTokenCheck
$setintuneAppSetCategoryIdDATA = (Invoke-RestMethod -Headers $global:graphAPIReqHeader @intuneAppSetCategoryRequest)
if ($intuneAppCategoryERR) {
Write-Output "...ERROR - There was a problem retrieving setintuneAppSetCategoryIdDATA - [$intuneAppCategoryERR]"
}
}