How do I use PSScriptTools to parse Windows event logs?

Pipe Get-WinEvent output to Convert-EventLogRecord, which converts logs into structured objects with additional details like replacement strings, making analysis easier in PowerShell scripts.

Can PSScriptTools run on Linux or Mac?

Many functions are cross-platform in PowerShell 7, but graphical tools like Invoke-InputBox are Windows-only. Core utilities for file management and data conversion work on non-Windows systems.

PSScriptTools vs built-in PowerShell modules: what's the advantage?

PSScriptTools extends built-in cmdlets with enhanced versions, like Get-MyCounter for better performance data, and adds new utilities for tasks like markdown conversion and time zone management, saving scripting time.

How to create a simple input box with PSScriptTools?

Use Invoke-InputBox with parameters like -Prompt and -Title to create a WPF-based input form; note this only works in Windows PowerShell due to WPF dependencies, as stated in the README.

Does PSScriptTools support PowerShell 5.1?

Yes, it is compatible with Windows PowerShell 5.1 and PowerShell 7, though some features may be version-specific, such as graphical tools being limited to Windows environments.

How to contribute or report bugs for PSScriptTools?

Post issues and feedback in the GitHub repository's Issues section, as mentioned in the README, allowing community involvement in development and troubleshooting.

Open-Awesome

PSScriptTools

MITPowerShellv3.2.0

A PowerShell module providing cross-platform functions to enhance scripting, console productivity, and system administration tasks.

GitHub

1.0k stars116 forks0 contributors

What is PSScriptTools?

PSScriptTools is a PowerShell module that provides a collection of functions and utilities to enhance scripting, console productivity, and system administration tasks. It solves common problems like parsing event logs, managing files, converting data formats, and creating graphical interfaces, all while supporting cross-platform use in Windows PowerShell and PowerShell 7.

Target Audience

PowerShell scripters, system administrators, and IT professionals who need efficient tools for daily tasks, automation, and cross-platform scripting.

Value Proposition

Developers choose PSScriptTools for its extensive, ready-to-use utilities that simplify complex operations, reduce manual coding, and improve workflow efficiency in both console and scripting environments.

Overview

:wrench: :hammer: A set of PowerShell functions to enhance your functions and scripts or to facilitate working in the console. Most should work cross-platform and cross-version. Operating system limitations are handled on a per command basis. The Samples folder contains demonstration scripts. After installing the module run Open-PSScriptToolsHelp.

Use Cases

Best For

Enhancing PowerShell console productivity with aliases and session tools
Parsing and converting system logs and performance data
Managing and analyzing files and folders with advanced metrics
Creating graphical interfaces for PowerShell scripts using WPF
Converting command output to markdown for documentation
Working with time zones and date-time conversions in scripts

Not Ideal For

Projects requiring strict cross-platform compatibility without Windows dependencies, as graphical tools like Invoke-InputBox are WPF-based and Windows-only.
Teams preferring minimal, single-purpose modules to avoid bloat and maintain tight control over dependencies.
Environments with stringent version control or legacy scripts, due to historical module restructuring (e.g., v2.2.0 to v2.13.0) that may introduce breaking changes.

Pros & Cons

Pros

Cross-Platform Utility Collection

Offers a wide range of functions, such as Get-DirectoryInfo and ConvertTo-Markdown, that work in both Windows PowerShell and PowerShell 7, enhancing scripting across diverse environments.

Enhanced System Diagnostics

Provides improved commands like Get-MyCounter for easier performance data handling and Convert-EventLogRecord for better event log parsing, reducing manual coding effort.

Productivity Boosting Aliases

Includes time-saving aliases (e.g., 'dw' for Get-DirectoryInfo) and custom Select-* functions (like Select-First as 'first') to streamline console workflows and reduce typing.

Graphical Scripting Support

Features WPF-based tools such as Invoke-InputBox and ConvertTo-WPFGrid, enabling interactive graphical interfaces for PowerShell scripts on Windows, as shown in the documentation examples.

Cons

Platform Limitations for GUI Tools

Graphical utilities like Invoke-InputBox are explicitly stated not to work in PowerShell Core, limiting cross-platform use and forcing reliance on Windows for interactive scripts.

Potential Breaking Changes

The module has undergone significant restructuring (e.g., from v2.2.0 to v2.13.0), which could lead to compatibility issues or require updates in existing scripts, as noted in the installation section.

Documentation Inconsistencies

The README admits that help files may be malformed or missing for some commands, such as in Get-ModuleCommand, which can hinder discoverability and usability for developers.

Frequently Asked Questions

Related Projects

fuck

Magnificent app which corrects your previous console command.

Stars97,772

Forks3,960

Last commit2 years ago

zoxide

A smarter cd command. Supports all major shells.

Stars39,238

Forks891

Last commit11 hours ago

posh-git

A PowerShell environment for Git

Stars8,270

Forks822