tip: Add tip showing how to adjust tiPS display frequency

Author: deadlydog

src/PowerShellTips/2025-09-20-adjust-tips-display-frequency.ps1

@@ -0,0 +1,31 @@
+$tip = [tiPS.PowerShellTip]::new()
+$tip.CreatedDate = [DateTime]::Parse('2025-09-20')
+$tip.Title = 'Adjust tiPS display frequency'
+$tip.TipText = @'
+You can adjust how often tips are automatically shown by using the `Set-TiPSConfiguration` command.
+
+If you find that you are seeing the same tips over and over, it means that you've viewed all of the tips currently in the tiPS module.
+While new tips do get added to the module over time, you may want to adjust how often tips are shown, such as changing the frequency from Daily to Weekly.
+
+By default, tips are shown from newest to oldest, so even if you reduce the frequency you will still see newly added tips next.
+'@
+$tip.Example = @'
+Set-TiPSConfiguration -AutomaticallyWritePowerShellTip Biweekly
+'@
+$tip.Urls = @(
+	'https://github.com/deadlydog/PowerShell.tiPS?tab=readme-ov-file#-commands'
+)
+$tip.Category = [tiPS.TipCategory]::Module # Community, Editor, Module, NativeCmdlet, Performance, Security, Syntax, Terminal, or Other.
+$tip.Author = 'Daniel Schroeder (deadlydog)' # Optional. Get credit for your tip. e.g. 'Daniel Schroeder (deadlydog)'.
+#$tip.ExpiryDate = [DateTime]::Parse('2024-10-30') # Optional. If the tip is not relevant after a certain date, set the expiration date. e.g. Announcing a conference or event.
+
+# Category meanings:
+# Community: Social events and community resources. e.g. PowerShell Summit, podcasts, etc.
+# Editor: Editor tips and extensions. e.g. VS Code, ISE, etc.
+# Module: Modules and module tips. e.g. PSScriptAnalyzer, Pester, etc.
+# NativeCmdlet: Native cmdlet tips. e.g. Get-Process, Get-ChildItem, Get-Content, etc.
+# Performance: Tips to improve runtime performance. e.g. foreach vs ForEach-Object, ForEach-Object -Parallel, etc.
+# Security: Security tips. e.g. ExecutionPolicy, Constrained Language Mode, passwords, etc.
+# Syntax: Syntax tips. e.g. splatting, pipeline, keywords, etc.
+# Terminal: Terminal shortcuts and tips. e.g. PSReadLine, Windows Terminal, ConEmu, etc.
+# Other: Tips that don't fit into any of the other categories.

src/tiPS/PowerShellTips.json

@@ -932,5 +932,83 @@
     "Category": 8,
     "ExpiryDate": "9999-12-31T23:59:59.9999999",
     "Author": "Daniel Schroeder (deadlydog)"
+  },
+  {
+    "CreatedDate": "2025-04-18T00:00:00",
+    "Title": "Capture superfluous parameters passed to your function(s)",
+    "TipText": "Capture any parsed parameter to prevent a function from bombing out when being passed unknown / misspelled variables.\r\nComes in handy when parsing the $PSBoundParameters from a calling script with just a subset of parameters that are appropriate / needed by your (custom) function.",
+    "Example": "[CmdletBinding()]\r\nparam(\r\n[Parameter(DontShow, ValueFromRemainingArguments)]$Superfluous\r\n)\r\n\r\nWrite-Verbose -Message \"Ignoring superfluous params: $($Superfluous -join ' ')\"",
+    "Urls": [
+      "https://github.com/ChristelVDH/SyncAD2AAD/blob/main/ConnectTo-Graph.ps1",
+      "https://learn.microsoft.com/en-us/dotnet/api/system.management.automation.parameterattribute.valuefromremainingarguments",
+      "https://learn.microsoft.com/en-us/dotnet/api/system.management.automation.parameterattribute.dontshow"
+    ],
+    "Category": 6,
+    "ExpiryDate": "9999-12-31T23:59:59.9999999",
+    "Author": "Christel VdH"
+  },
+  {
+    "CreatedDate": "2025-04-29T00:00:00",
+    "Title": "Use Measure-Object to get stats about objects",
+    "TipText": "You can use the Measure-Object cmdlet to get statistics about objects in PowerShell. This cmdlet can be used to calculate the sum, average, minimum, maximum, and count of numeric properties in objects. When used with text input, it can count characters, words, and lines.\r\n\r\nThe cmdlet returns an object containing properties for each statistic, but the statistic is only actually calculated if you provided the switch for it. For example, if you only provide the -Sum switch, the Sum property will contain the sum of the values, but the Average property will be null since the -Average switch was not provided.",
+    "Example": "# Get all statistics about a range of numbers.\r\n1..10 | Measure-Object -Average -Sum -Minimum -Maximum -StandardDeviation\r\n\r\n# Get all statistics about a string.\r\n\"Hello there\" | Measure-Object -Character -Word -Line\r\n\r\n# Count the number of words in a file.\r\nGet-Content 'C:\\path\\to\\file.txt' | Measure-Object -Word\r\n\r\n# Calculate the total size (Length) of all files in the current directory.\r\nGet-ChildItem | Measure-Object -Property Length -Sum\r\n\r\n# In an array of objects, find the one with the maximum value of the Num property.\r\n@{num=3}, @{num=4}, @{num=5} | Measure-Object -Maximum Num\r\n\r\n# Get the total and maximum CPU time and paged memory size of all processes.\r\nGet-Process | Measure-Object -Property CPU,PagedMemorySize -Sum -Maximum",
+    "Urls": [
+      "https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/measure-object",
+      "https://adamtheautomator.com/powershell-measure-object/"
+    ],
+    "Category": 3,
+    "ExpiryDate": "9999-12-31T23:59:59.9999999",
+    "Author": "Daniel Schroeder (deadlydog)"
+  },
+  {
+    "CreatedDate": "2025-05-05T00:00:00",
+    "Title": "Use Join-Path and Split-Path to create cross-platform paths",
+    "TipText": "When creating file paths in PowerShell, use the `Join-Path` cmdlet instead of string concatenation. This ensures that the correct path separator is used for the current platform (e.g. `\\` on Windows and `/` on Linux/macOS). PowerShell 6 introduced the -AdditionalChildPath parameter, which allows you to specify multiple child paths to join.\r\n\r\nSimilarly, you can use the `Split-Path` cmdlet to split a path into its components. This is useful for extracting the directory or file name from a full path.",
+    "Example": "# Don't do this, as it may not work on all platforms.\r\n[string] $configFilePath = \"$HOME/Config/config.json\"\r\n\r\n# Do this instead, as it works on all platforms.\r\n[string] $configDirectoryPath = Join-Path -Path $HOME -ChildPath 'Config'\r\n[string] $configFilePath = Join-Path $configDirectoryPath 'config.json' # Excludes -Path and -ChildPath for brevity.\r\n\r\n# You can use System.IO.Path to easily join multiple paths. Helpful in Windows PowerShell.\r\n[string] $configFilePath = [System.IO.Path]::Combine($HOME, 'Config', 'config.json')\r\n\r\n# In PowerShell 6+ you can join multiple child paths at once using -AdditionalChildPath.\r\n[string] $configFilePath = Join-Path -Path $HOME -AdditionalChildPath 'Config' 'config.json'\r\n[string] $xmlFilePath = Join-Path $HOME 'Config' 'config.xml' # Excludes parameter names for brevity.\r\n\r\n# Use -Resolve to ensure we get an absolute path, and error if the path does not exist.\r\n[string] $configFilePath = Join-Path $HOME 'Config' 'config.json' -Resolve\r\n\r\n# Get the name of the file with and without the extension, it's parent directory path, and it's parent directory name.\r\n[string] $fileName = Split-Path -Path $configFilePath -Leaf\r\n[string] $fileNameWithoutExtension = Split-Path -Path $configFilePath -LeafBase\r\n[string] $directoryPath = Split-Path -Path $configFilePath -Parent\r\n[string] $directoryName = Split-Path -Path $directoryPath -Leaf\r\n\r\n# Change the working directory to the folder containing your PowerShell profile.\r\nSet-Location (Split-Path -Path $PROFILE)",
+    "Urls": [
+      "https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.management/join-path",
+      "https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.management/split-path"
+    ],
+    "Category": 3,
+    "ExpiryDate": "9999-12-31T23:59:59.9999999",
+    "Author": "Daniel Schroeder (deadlydog)"
+  },
+  {
+    "CreatedDate": "2025-09-03T00:00:00",
+    "Title": "Array Lists",
+    "TipText": "An Array list is similar to an array, but it does not have a fixed size like an array does.\r\n\r\nWith a fixed-sized array and you add an item to the array, the array is actually recreated with the additional item. This can impact performance, when working with thousands of items.\r\n\r\nAnother concern with fixed-size arrays is that there's no simple method to remove an item.",
+    "Example": "# In PowerShell, you can create an Array list using the `System.Collections.ArrayList` class. Here's how you can create and use an Array list:\r\n\r\n[System.Collections.ArrayList]$computers = @('Server1', 'Server2', 'Server3')\r\n\r\n# To create an empty array ready to add items\r\n\r\n$computers=New-Object System.Collections.ArrayList",
+    "Urls": [
+      "https://learn.microsoft.com/en-us/training/modules/work-arrays-hash-tables-window-powershell-scripts/3-work-array-lists-windows",
+      "https://learn.microsoft.com/en-us/powershell/scripting/learn/deep-dives/everything-about-arrays?view=powershell-7.5#arraylist"
+    ],
+    "Category": 4,
+    "ExpiryDate": "9999-12-31T23:59:59.9999999",
+    "Author": "Adrian Muscat (adrimus)"
+  },
+  {
+    "CreatedDate": "2025-09-20T00:00:00",
+    "Title": "Adjust tiPS display frequency",
+    "TipText": "You can adjust how often tips are automatically shown by using the `Set-TiPSConfiguration` command.\r\n\r\nIf you find that you are seeing the same tips over and over, it means that you've viewed all of the tips currently in the tiPS module.\r\nWhile new tips do get added to the module over time, you may want to adjust how often tips are shown, such as changing the frequency from Daily to Weekly.\r\n\r\nBy default, tips are shown from newest to oldest, so even if you reduce the frequency you will still see newly added tips next.",
+    "Example": "Set-TiPSConfiguration -AutomaticallyWritePowerShellTip Biweekly",
+    "Urls": [
+      "https://github.com/deadlydog/PowerShell.tiPS?tab=readme-ov-file#-commands"
+    ],
+    "Category": 2,
+    "ExpiryDate": "9999-12-31T23:59:59.9999999",
+    "Author": "Daniel Schroeder (deadlydog)"
+  },
+  {
+    "CreatedDate": "2025-09-20T00:00:00",
+    "Title": "Use Get-Verb to see approved verbs",
+    "TipText": "Use the Get-Verb cmdlet to see a list of all approved verbs in PowerShell. This is useful when creating your own functions or cmdlets, as using approved verbs helps ensure consistency and discoverability. You know right away what a function does simply by the verb it uses.\r\n\r\nGet-Verb is also great for learning about new verbs you may not have known about, including the typical alias abbreviations.",
+    "Example": "# List all approved verbs and their descriptions.\r\nGet-Verb",
+    "Urls": [
+      "https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/get-verb",
+      "https://learn.microsoft.com/en-us/powershell/scripting/developer/cmdlet/approved-verbs-for-windows-powershell-commands"
+    ],
+    "Category": 3,
+    "ExpiryDate": "9999-12-31T23:59:59.9999999",
+    "Author": "Daniel Schroeder (deadlydog)"
   }
 ]