ModernConveniences

A collection of general-purpose functions for objects, properties, and more.

• Add-CapturesToMatches: Adds named capture group values as note properties to Select-String MatchInfo objects.
• Add-Counter: Adds an incrementing integer property to each pipeline object.
• Add-DynamicParam: Adds a dynamic parameter to a script, within a DynamicParam block.
• Add-NoteProperty: Adds a NoteProperty to a PSObject, calculating the value with the object in context.
• Add-NugetPackage: Loads a NuGet package DLL, downloading as needed.
• Add-ParameterDefault: Appends or creates a value to use for the specified cmdlet parameter to use when one is not specified.
• Add-TimeSpan: Adds a timespan to DateTime values.
• Compare-Hashset: Returns differences between sets.
• Compare-Keys: Returns the differences between two dictionaries.
• Compare-Properties: Compares the properties of two objects.
• Convert-ClipboardTsvToHtml: Parses TSV clipboard data into HTML table data which is copied back to the clipboard as formatted HTML.
• Convert-ICalToMermaidGantt: Imports iCal events and converts them into a Mermaid Gantt chart for each day, sectioned by location.
• ConvertFrom-Base64: Converts base64-encoded text to bytes or text.
• ConvertFrom-Duration: Parses a Timespan from a ISO8601 duration string.
• ConvertFrom-EpochTime: Converts an integer Unix (POSIX) time (seconds since Jan 1, 1970) into a DateTime value.
• ConvertFrom-Hex: Convert a string of hexadecimal digits into a byte array.
• ConvertFrom-IsoWeekDate: Returns a DateTime object from an ISO week date string.
• ConvertTo-Base64: Converts bytes or text to base64-encoded text.
• ConvertTo-EpochTime: Converts a DateTime value into an integer Unix (POSIX) time, seconds since Jan 1, 1970.
• ConvertTo-FileName: Returns a valid and safe filename from a given string.
• ConvertTo-Hashset: Reduces a collection to unique items that can be used for mathematical set operations.
• ConvertTo-OrderedDictionary: Converts an object to an ordered dictionary of properties and values.
• ConvertTo-PowerShell: Serializes complex content into PowerShell literals.
• ConvertTo-RomanNumeral: Convert a number to a Roman numeral.
• ConvertTo-SafeEntities: Encode text as XML/HTML, escaping all characters outside 7-bit ASCII.
• Copy-Html: Copies objects as an HTML table.
• Disable-AnsiColor: Disables ANSI terminal colors.
• Enable-AnsiColor: Enables ANSI terminal colors.
• Expand-EnvironmentVariables: Replaces the name of each environment variable embedded in the specified string with the string equivalent of the value of the variable, then returns the resulting string.
• Export-MermaidXY: Generates a Mermaid XY bar/line chart for the values of a series of properties.
• Find-NewestFile: Finds the most recent file.
• Format-ByteUnits: Converts bytes to largest possible units, to improve readability.
• Format-Date: Returns a date/time as a named format.
• Format-EscapedUrl: Escape URLs more aggressively.
• Format-HtmlDataTable: Right-aligns numeric data in an HTML table for emailing, and optionally zebra-stripes &c.
• Format-Permutations: Builds format strings using every combination of elements from multiple arrays.
• Get-Clip: Gets the contents of the clipboard (cross-platform, and more reliably on Linux Wayland).
• Get-CommandParameters: Returns the parameters of the specified cmdlet.
• Get-CommandPath: Locates a command.
• Get-ConsoleHistory: Returns the DOSKey-style console command history (up arrow or F8).
• Get-EnumValues: Returns the possible values of the specified enumeration.
• Get-FrenchRepublicanDate: Returns a date and time converted to the French Republican Calendar.
• Get-ModuleScope: Returns the scope of an installed module.
• Get-OutdatedModules: Returns a list of modules that have upgrades available.
• Get-RandomBytes: Returns random bytes.
• Get-ScriptTokens: Returns the parsed PowerShell tokens from a script file.
• Get-TypeAccelerators: Returns the list of PowerShell type accelerators.
• Import-ClipboardTsv: Parses TSV clipboard data into objects.
• Import-Variables: Creates local variables from a data row or dictionary (hashtable).
• Invoke-CachedCommand: Caches the output of a command for recall if called again.
• Invoke-WindowsPowerShell: Runs commands in Windows PowerShell (typically from PowerShell Core).
• Join-Keys: Combines dictionaries together into a single dictionary.
• Limit-Digits: Rounds off a number to the requested number of digits.
• Measure-Properties: Provides frequency details about the properties across objects in the pipeline.
• Measure-Values: Provides analysis of supplied values.
• Merge-PSObject: Create a new PSObject by recursively combining the properties of PSObjects.
• Read-Choice: Returns choice selected from a list of options.
• Remove-ConsoleHistory: Removes an entry from the DOSKey-style console command history (up arrow or F8).
• Remove-NullValues: Removes dictionary entries with null vaules.
• Remove-ParameterDefault: Removes a value that would have been used for a parameter if none was specified, if one existed.
• Repair-MarkdownHeaders: Updates markdown content to replace level 1 & 2 ATX headers to Setext headers.
• Select-CapturesFromMatches: Selects named capture group values as note properties from Select-String MatchInfo objects.
• Select-ScriptCommands: Returns the commands used by the specified script.
• Set-Clip: Sets the contents of the clipboard with formatted HTML support (cross-platform, and more reliably on Linux Wayland).
• Set-ParameterDefault: Assigns a value to use for the specified cmdlet parameter to use when one is not specified.
• Set-RegexReplace: Updates text found with Select-String, using a regular expression replacement template.
• Show-Progress: Performs an operation against each item in a collection of input objects, with a progress bar.
• Show-PSDriveUsage: Displays drive usage graphically, and with a human-readable summary.
• Show-Status: Displays requested system status values using powerline font characters.
• Show-Time: Displays a formatted date using powerline font characters.
• Split-Keys: Clones a dictionary keeping only the specified keys.
• Split-Uri: Splits a URI into component parts.
• Stop-ThrowError: Throws a better error than "throw".
• Test-Administrator: Checks whether the current session has administrator privileges.
• Test-DateTime: Tests whether the given string can be parsed as a date.
• Test-FileTypeMagicNumber: Tests for a given common file type by magic number.
• Test-Interactive: Determines whether both the user and process are interactive.
• Test-MagicNumber: Tests a file for a "magic number" (identifying sequence of bytes) at a given location.
• Test-NewerFile: Returns true if the difference file is newer than the reference file.
• Test-NoteProperty: Looks for any matching NoteProperties on an object.
• Test-Range: Returns true from an initial condition until a terminating condition; a latching test.
• Test-Uri: Determines whether a string is a valid URI.
• Test-USFederalHoliday: Returns true if the given date is a U.S. federal holiday.
• Test-Variable: Indicates whether a variable has been defined.
• Trace-VariableScope: Returns details about a variable by name in all available scopes.
• Uninstall-OldModules: Uninstalls old module versions (ignoring old Windows PowerShell modules).
• Update-Files: Copies specified source files that exist in the destination directory.
• Update-Modules: Cleans up old modules.
• Use-ProgressView: Sets the progress bar display view.
• Use-ReasonableDefaults: Sets certain cmdlet parameter defaults to rational, useful values.
• Write-CallInfo: Prints caller name and parameters to the host for debugging purposes.
• Write-Info: Writes to the information stream, with color support and more.
• Write-VisibleString: Displays a string, showing nonprintable characters.