PowerShell Reference Guide

A comprehensive, beginner-friendly PowerShell reference guide built for real-world use.

Welcome to my PowerShell Reference Guide - a practical resource designed for me, the IT professional learning PowerShell. I found existing PowerShell documentation clunky and difficult to navigate, so I had Claude help me build something better. If you share that frustration, use and enjoy.

→ See full update history

What You'll Learn

This guide covers everything from PowerShell basics to advanced scripting techniques, organized into clear sections:

Getting Started

Perfect for beginners - learn the fundamentals of PowerShell:

• PowerShell Basics - What is PowerShell, versions, ISE vs VS Code, execution policies
• Cmdlets Introduction - Understanding cmdlets, the pipeline, objects vs text, and aliases
• Help System - Master Get-Help, Update-Help, and finding the right cmdlets
• Your First Script - Step-by-step guide to creating your first PowerShell script

Core Syntax & Fundamentals

Master the building blocks of PowerShell scripting:

• Variables & Data Types - Strings, integers, arrays, hash tables, type casting
• Arrays & Collections - Working with arrays, ArrayLists, and hash tables
• Operators - Comparison, logical, and arithmetic operators
• If Statements & Conditional Logic - Making decisions in your scripts
• Switch Statements - Handling multiple conditions elegantly
• Loops - For, foreach, while, do-while, and do-until loops
• Functions - Creating reusable code with parameters and return values
• Function Parameters - Validation attributes, parameter attributes, aliases, and parameter sets
• Error Handling - Try/catch/finally and managing errors gracefully
• Logging - Implementing effective logging for troubleshooting and monitoring
• Script Structure - Organizing scripts with best practices and standards
• Script Configuration Files - Externalize settings with PSD1, JSON, XML, and INI formats
• Comment-Based Help - Writing documentation for your scripts and functions

Working with Data

Learn to manipulate and format data like a pro:

• Understanding Objects & The Pipeline - Deep dive into PowerShell's object-oriented nature
• The Pipeline - Understanding PowerShell's most powerful feature
• Object Manipulation - Select-Object, Where-Object, ForEach-Object, and calculated properties
• Creating Custom Objects - PSCustomObject, Add-Member, New-Object, and building structured data
• String Manipulation - Working with strings, regex, split, join, and formatting
• Working with JSON - ConvertFrom-Json, ConvertTo-Json, nested objects, arrays, and API integration
• API Interactions - REST API calls, authentication, Invoke-RestMethod, and real-world integrations
• Formatting Output - Format-Table, Format-List, Out-GridView, Export-Csv

Practical Guides

Real-world patterns and solutions for common tasks:

• Searching Files - Master file search techniques with Get-ChildItem, filters, and recursion
• Common PowerShell Patterns - Reusable code templates for everyday scripting tasks
• Git with PowerShell - Git workflows in PowerShell: branching, merging, stashes, resets, and recovery
• One-Liners - Quick PowerShell commands for immediate productivity

Reference

Essential reference materials for PowerShell users:

• Troubleshooting Common Errors - Solutions to frequently encountered PowerShell errors
• Glossary - Comprehensive PowerShell terminology reference

File & System Operations

Manage files, folders, and the underlying system directly from PowerShell:

• File & Folder Management - New-Item, Copy-Item, Move-Item, Remove-Item, Test-Path
• Reading & Writing Files - Get-Content, Set-Content, Add-Content, Out-File
• Path Operations - Join-Path, Split-Path, Resolve-Path, Test-Path
• Services Management - Get/Start/Stop/Restart-Service, service dependencies
• Process Management - Get-Process, Start-Process, Stop-Process, monitoring
• Registry Operations - Reading and writing registry keys and values
• Event Logs - Get-WinEvent, Get-EventLog, filtering events
• Scheduled Tasks - Creating and managing scheduled tasks

Advanced Topics

Deeper system administration and security-focused scripting:

• User Account Tasks - Local user management, password operations
• Network Operations - Test-Connection, Test-NetConnection, Resolve-DnsName
• Credential Management - SecureString, PSCredential, encrypted export/import

Guiding Principles

This guide is built on the following principles:

• Beginner-friendly - Clear explanations without assuming prior knowledge
• Real-world examples - Practical code you can use immediately
• Consistent formatting - Easy to scan and find what you need
• Practical over theoretical - Focus on what you'll actually use
• Quality over quantity - Every topic is thoroughly explained

Current Status

Overall Progress

42 of 46 planned topics complete

View full progress and update history →

Getting Started

New to PowerShell? Start with the Getting Started section and work your way through sequentially.

Already familiar with the basics? Jump to any topic using the navigation menu.

Note: This guide is actively being developed. Check back regularly for new content!