Add-Border Add Border Create a text border around a string. This command will create a character or text-based border around a line of text. You might use this to create a formatted text report or to improve the display of information to the screen. Add-Border Text A single line of text that will be wrapped in a border. String String None Character The character to use for the border. It must be a single character. String String * InsertBlanks Insert blank lines before and after the text. The default behavior is to create a border box close to the text. See examples. SwitchParameter False Tab Insert X number of tabs. Int32 Int32 0 ANSIBorder Enter an ANSI escape sequence to color the border characters. String String None ANSIText Enter an ANSI escape sequence to color the text. String String None Add-Border TextBlock A multi-line block of text. You might want to trim blank lines from the beginning, end or both. String[] String[] None Character The character to use for the border. It must be a single character. String String * InsertBlanks Insert blank lines before and after the text. The default behavior is to create a border box close to the text. See examples. SwitchParameter False Tab Insert X number of tabs. Int32 Int32 0 ANSIBorder Enter an ANSI escape sequence to color the border characters. String String None ANSIText Enter an ANSI escape sequence to color the text. String String None Text A single line of text that will be wrapped in a border. String String None TextBlock A multi-line block of text. You might want to trim blank lines from the beginning, end or both. String[] String[] None Character The character to use for the border. It must be a single character. String String * InsertBlanks Insert blank lines before and after the text. The default behavior is to create a border box close to the text. See examples. SwitchParameter SwitchParameter False Tab Insert X number of tabs. Int32 Int32 0 ANSIBorder Enter an ANSI escape sequence to color the border characters. String String None ANSIText Enter an ANSI escape sequence to color the text. String String None None System.String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Add-Border "PowerShell Wins!" ******************** * PowerShell Wins! * ******************** -------------------------- EXAMPLE 2 -------------------------- PS C:\> Add-Border "PowerShell Wins!" -tab 1 ******************** * PowerShell Wins! * ******************** Note that this example may not format properly in all consoles. -------------------------- EXAMPLE 3 -------------------------- PS C:\> Add-Border "PowerShell Wins!" -character "-" -insertBlanks -------------------- - - - PowerShell Wins! - - - -------------------- -------------------------- EXAMPLE 4 -------------------------- PS C:\> Add-Border -textblock (Get-Service win* | Out-String).trim() ********************************************************************** * Status Name DisplayName * * ------ ---- ----------- * * Stopped WinDefend Windows Defender Antivirus Service * * Running WinHttpAutoProx... WinHTTP Web Proxy Auto-Discovery Se... * * Running Winmgmt Windows Management Instrumentation * * Stopped WinRM Windows Remote Management (WS-Manag... * ********************************************************************** Create a border around the output of a Get-Service command. -------------------------- EXAMPLE 5 -------------------------- PS C:\> Add-Border -Text $t -ANSIBorder "$([char]0x1b)[38;5;47m" -ANSIText "$([char]0x1b)[93m" -InsertBlanks ******************* * * * I am the walrus * * * ******************* This will write a color version of the text and border. You would this type of ANSI syntax for Windows PowerShell. In PowerShell 7, you can use the same syntax or the much easier "`e[38;5;47m". -------------------------- EXAMPLE 6 -------------------------- PS C:\> Add-Border -textblock (Get-PSWho -AsString ).trim() -ANSIBorder "`e[38;5;214m" -Character ([char]0x25CA) -ANSIText "`e[38;5;225m" ◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊ ◊ User : BOVINE320\Jeff ◊ ◊ Elevated : True ◊ ◊ Computername : BOVINE320 ◊ ◊ OperatingSystem : Microsoft Windows 10 Pro [64-bit] ◊ ◊ OSVersion : 10.0.18363 ◊ ◊ PSVersion : 7.0.1 ◊ ◊ Edition : Core ◊ ◊ PSHost : ConsoleHost ◊ ◊ WSMan : 3.0 ◊ ◊ ExecutionPolicy : RemoteSigned ◊ ◊ Culture : English (United States) ◊ ◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊◊ This example requires PowerShell 7 because of the way the escape sequence is defined. The border character is a diamond. Depending on how you are viewing this help content, it may not display properly. Online Version: http://bit.ly/31PzBsZ New-ANSIBar Compare-Module Compare Module Compare PowerShell module versions. Use this command to compare module versions between what is installed against an online repository like the PSGallery. Results will be automatically sorted by module name. Compare-Module Name The name of a module to check. Wildcards are permitted. String String None Gallery Specify the remote repository or gallery to check. String String PSGallery Name The name of a module to check. Wildcards are permitted. String String None Gallery Specify the remote repository or gallery to check. String String PSGallery System.String PSCustomObject Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Compare-Module | Where-object {$_.UpdateNeeded} Name : DNSSuffix OnlineVersion : 0.4.1 InstalledVersion : 0.2.0 PublishedDate : 10/22/2018 8:21:46 PM UpdateNeeded : True Name : InvokeBuild OnlineVersion : 5.4.2 InstalledVersion : 3.2.2 PublishedDate : 12/7/2018 1:30:46 AM UpdateNeeded : True ... List all modules that could be updated. -------------------------- EXAMPLE 2 -------------------------- PS C:\> Compare-Module | Where UpdateNeeded | Out-Gridview -title "Select modules to update" -outputMode multiple | Foreach-Object { Update-Module $_.name } Compare modules and send results to Out-Gridview. Use Out-Gridview as an object picker to decide what modules to update. -------------------------- EXAMPLE 3 -------------------------- PS C:\> Compare-Module -name xWin* | Format-Table Name OnlineVersion InstalledVersion PublishedDate UpdateNeeded ---- ------------- ---------------- ------------- ------------ xWindowsUpdate 2.7.0.0 2.7.0.0,2.5.0.0 7/12/2017 10:43:54 PM False xWinEventLog 1.2.0.0 1.2.0.0 6/13/2018 8:06:45 PM False Compare all modules that start with xWin* and display results in a table format. -------------------------- EXAMPLE 4 -------------------------- PS C:\> get-dscresource xAD* | Select-Object moduleName -Unique | Compare-Module Name : xActiveDirectory OnlineVersion : 2.22.0.0 InstalledVersion : 2.16.0.0,2.14.0.0 PublishedDate : 10/25/2018 5:25:24 PM UpdateNeeded : True Name : xAdcsDeployment OnlineVersion : 1.4.0.0 InstalledVersion : 1.1.0.0,1.0.0.0 PublishedDate : 12/20/2017 10:10:43 PM UpdateNeeded : True Get all DSC Resources that start with xAD and select the corresponding module name. Since the module name will be listed for every resource, get a unique list and pipe that to Compare-Module. Online Version: http://bit.ly/31UsaRA Find-Module Get-Module Update-Module Compare-Script Compare Script Compare PowerShell script versions. Use this command to compare script versions between what is installed against an online repository like the PSGallery. Results will be automatically sorted by the script name. Compare-Script Name The name of a script to check. Wildcards are permitted. String String None Gallery Specify the remote repository or gallery to check. String String PSGallery Name The name of a script to check. Wildcards are permitted. String String None Gallery Specify the remote repository or gallery to check. String String PSGallery System.String PSCustomObject Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Compare-Script | Where-object {$_.UpdateNeeded} Name : DNSSuffix OnlineVersion : 0.4.1 InstalledVersion : 0.2.0 PublishedDate : 10/22/2020 8:21:46 PM UpdateNeeded : True Name : InvokeBuild OnlineVersion : 5.4.2 InstalledVersion : 3.2.2 PublishedDate : 12/7/2020 1:30:46 AM UpdateNeeded : True ... List all scripts that could be updated. -------------------------- EXAMPLE 2 -------------------------- PS C:\> Compare-Script | Where UpdateNeeded | Out-Gridview -Title "Select scripts to update" -OutputMode multiple | Foreach-Object { Update-Script $_.name } Compare scripts and send results to Out-Gridview. Use Out-Gridview as an object picker to decide what scripts to update. Online Version: https://github.com/jdhitsolutions/PSScriptTools/blob/master/docs/Compare-Script.md Find-Script Get-InstalledScript Update-Script Convert-CommandToHashtable Convert CommandToHashtable Convert a PowerShell expression into a splatting equivalent. This command is intended to convert a long PowerShell expression with named parameters into a splatting alternative. The central concept is that you are editing a script file with a lengthy PowerShell expression with multiple parameters and you would like to turn it into splatting code. Convert-CommandToHashtable Text A PowerShell command using a single cmdlet or function, preferably with named parameters. String String None Text A PowerShell command using a single cmdlet or function, preferably with named parameters. String String None None Hashtable Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> $text ="Get-Winevent -listlog p* -computername SRV1 -erroraction stop" PS C:\> Convert-CommandToHashtable -Text $text | Set-Clipboard The $text variable might be a line of code from your script. The second line converts into a splatting sequence and copies it to the Windows clipboard so you can paste it back into your script. You could create a VS Code task sequence using this function. Online Version: http://bit.ly/31SLyhD Convert-HashtableToCode Convert-EventLogRecord Convert EventLogRecord Convert EventLogRecords to structured objects. When you use Get-WinEvent, the results are objects you can work with in PowerShell. However, often times there is additional information that is part of the eventlog record, such as replacement strings, that are used to construct a message. This additional information is not readily exposed. You can use this command to convert the results of a Get-WinEvent command into a PowerShell custom object with additional information. For best results, you should pipe the same event IDs to this command. Note that not every event record exposes data that is compatible with this command. For those types of event log records, you will see a RawProperties property with most likely an array of strings. Use the Message property for more information. Convert-EventLogRecord LogRecord An event log record from the Get-WinEvent command. EventLogRecord[] EventLogRecord[] None LogRecord An event log record from the Get-WinEvent command. EventLogRecord[] EventLogRecord[] None System.Diagnostics.Eventing.Reader.EventLogRecord PSCustomObject Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Get-WinEvent -FilterHashtable @{Logname = 'security';ID=5059} | Convert-EventLogRecord | Select-Object -Property TimeCreated,Subject*, Computername TimeCreated : 1/20/2020 10:48:45 AM SubjectUserSid : S-1-5-83-1-2951761591-1086169693-630393256-923523501 SubjectUserName : AFF04EB7-A25D-40BD-A809-9325ADD90B37 SubjectDomainName : NT VIRTUAL MACHINE SubjectLogonId : 0x7cbf5 Computername : Bovine320 TimeCreated : 1/20/2020 10:48:45 AM SubjectUserSid : S-1-5-83-1-2951761591-1086169693-630393256-923523501 SubjectUserName : AFF04EB7-A25D-40BD-A809-9325ADD90B37 SubjectDomainName : NT VIRTUAL MACHINE SubjectLogonId : 0x7cbf5 Computername : Bovine320 -------------------------- EXAMPLE 2 -------------------------- PS C:\> Get-WinEvent -FilterHashtable @{Logname = 'security';ID=4624} ` -MaxEvents 100 -computername win10 | Convert-EventLogRecord | Where-Object {$_.LogonType -eq 3} | Select-Object -first 10 -property TargetUsername,IPAddress, TimeCreated,Computername | Format-Table TargetUserName IpAddress TimeCreated Computername -------------- --------- ----------- ------------ ArtD fe80::ddae:8ade:c3ff:e584 1/20/2020 12:05:12 PM WIN10.Company.Pri WIN10$ - 1/20/2020 11:56:52 AM WIN10.Company.Pri WIN10$ - 1/20/2020 11:56:52 AM WIN10.Company.Pri WIN10$ - 1/20/2020 11:56:52 AM WIN10.Company.Pri WIN10$ - 1/20/2020 11:56:51 AM WIN10.Company.Pri ArtD 192.168.3.10 1/20/2020 11:45:31 AM WIN10.Company.Pri WIN10$ ::1 1/20/2020 11:39:52 AM WIN10.Company.Pri ArtD 192.168.3.10 1/20/2020 11:35:49 AM WIN10.Company.Pri ArtD 192.168.3.10 1/20/2020 11:34:36 AM WIN10.Company.Pri ArtD 192.168.3.10 1/20/2020 11:32:06 AM WIN10.Company.Pri This example filters on a property added by this command to only show interactive logons. -------------------------- EXAMPLE 3 -------------------------- PS C:\> Get-WinEvent -FilterHashtable @{Logname ='system'; ID =7040} -MaxEvent 10 | Convert-EventlogRecord | Select-Object -Property TimeCreated,@{Name="Service";Expression={$_.param4}}, @{Name="OriginalState";Expression = {$_.param2}}, @{Name="NewState";Expression={$_.param3}},Computername | Format-Table TimeCreated Service OriginalState NewState Computername ----------- ------- ------------- -------- ------------ 1/20/2020 9:26:08 AM BITS demand start auto start Bovine320 1/20/2020 5:47:17 AM BITS auto start demand start Bovine320 1/20/2020 5:45:11 AM BITS demand start auto start Bovine320 1/20/2020 1:44:31 AM BITS auto start demand start Bovine320 1/20/2020 1:42:30 AM BITS demand start auto start Bovine320 1/19/2020 8:53:37 PM BITS auto start demand start Bovine320 1/17/2020 8:27:10 PM TrustedInstaller demand start auto start Bovine320 1/17/2020 8:27:10 PM TrustedInstaller auto start demand start Bovine320 1/17/2020 8:26:29 PM TrustedInstaller demand start auto start Bovine320 1/17/2020 8:26:20 PM TrustedInstaller auto start demand start Bovine320 Once you know the type of data, you can customize the output or build a script around it. -------------------------- EXAMPLE 4 -------------------------- PS C:\> Get-WinEvent -FilterHashtable @{Logname = "Application"; ID=17137} -MaxEvents 1 | Convert-EventLogRecord LogName : Application RecordType : Information TimeCreated : 1/20/2020 2:31:52 PM ID : 17137 RawProperties : {TickleEventDB} Message : Starting up database 'TickleEventDB'. Keywords : {Classic} Source : MSSQL$SQLEXPRESS Computername : Bovine320 This record doesn't have structured extra data. The replacement strings are stored as text so the command displays the data using the RawProperties property. -------------------------- EXAMPLE 5 -------------------------- PS C:\> $all = New-PSSession -ComputerName 'win10','srv1','srv2','dom1' PS C:\> $local = Get-Item Function:\Convert-EventLogRecord PS C:\> Invoke-Command -ScriptBlock { New-item -Path Function: -Name $using:local.name -Value $using:local.ScriptBlock } -Session $all PS C:\> Invoke-Command { Get-WinEvent -FilterHashtable @{Logname='security';id=4624} -MaxEvents 10 | Convert-EventLogRecord | Select-Object -Property Computername,Time*,TargetUser*, TargetDomainName,Subject*} -session $all -HideComputerName | Select-Object -Property * -ExcludeProperty runspaceID Computername : WIN10.Company.Pri TimeCreated : 1/20/2020 5:21:17 PM TargetUserSid : S-1-5-18 TargetUserName : SYSTEM TargetDomainName : NT AUTHORITY SubjectUserSid : S-1-5-18 SubjectUserName : WIN10$ SubjectDomainName : COMPANY SubjectLogonId : 0x3e7 Computername : WIN10.Company.Pri TimeCreated : 1/20/2020 5:18:51 PM TargetUserSid : S-1-5-18 TargetUserName : SYSTEM TargetDomainName : NT AUTHORITY SubjectUserSid : S-1-5-18 SubjectUserName : WIN10$ SubjectDomainName : COMPANY SubjectLogonId : 0x3e7 Computername : WIN10.Company.Pri TimeCreated : 1/20/2020 5:16:07 PM TargetUserSid : S-1-5-21-278538743-3177530655-100218012-1105 TargetUserName : ArtD TargetDomainName : COMPANY.PRI SubjectUserSid : S-1-0-0 SubjectUserName : - SubjectDomainName : - SubjectLogonId : 0x0 ... The first command creates PSSessions to several remote computers. The local copy of this command is created in the remote PSSessions. Then event log data is retrieved in the remote sessions and converted using the Convert-EventlogRecord function in each session. Online Version: http://bit.ly/314L8W9 Get-WinEvent Convert-HashtableString Convert HashtableString Convert a hashtable string into a hashtable object. This function is similar to Import-PowerShellDataFile. But where that command can only process a file, this command will take any hashtable-formatted string and convert it into an actual hashtable. Convert-HashtableString Text Enter your hashtable string. String String None Text Enter your hashtable string. String String None System.String hashtable Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> get-content c:\work\test.psd1 | unprotect-cmsmessage | Convert-HashtableString Name Value ---- ----- CreatedBy BOVINE320\Jeff CreatedAt 10/02/2020 21:28:47 UTC Computername Think51 Error Completed True Date 10/02/2020 21:29:35 UTC Scriptblock restart-service spooler -force CreatedOn BOVINE320 The test.psd1 file is protected as a CMS Message. In this example, the contents are decoded as a string which is then in turn converted into an actual hashtable. Online Version: http://bit.ly/31VA9Of Import-PowerShellDatafile Convert-HashtableToCode Convert-HashtableToCode Convert HashtableToCode Convert a hashtable to a string representation. Use this command to convert a hashtable into its text or string equivalent. It is assumed that any array values contain items of the same type. This command has not been tested with large or complex hashtables, so you might need to manually edit the output to meet your tastes or requirements. Convert-HashtableToCode Hashtable A hashtable to convert. It can be standard or ordered hashtable. Hashtable Hashtable None Indent Specify the number of tabs to indent. You shouldn't need to specify this parameter. It exists for situations where there are nested hashtables. Int32 Int32 1 Convert-HashtableToCode Hashtable A hashtable to convert. It can be standard or ordered hashtable. Hashtable Hashtable None Inline Write the hashtable as an inline expression. SwitchParameter False Hashtable A hashtable to convert. It can be standard or ordered hashtable. Hashtable Hashtable None Indent Specify the number of tabs to indent. You shouldn't need to specify this parameter. It exists for situations where there are nested hashtables. Int32 Int32 1 Inline Write the hashtable as an inline expression. SwitchParameter SwitchParameter False System.Collections.Hashtable System.String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> $h = @{Name="SRV1";Asset=123454;Location="Omaha"} PS C:\> Convert-HashtableToCode $h @{ Name = 'SRV1' Asset = 123454 Location = 'Omaha' } Convert a hashtable object to a string equivalent that you can copy into your script. -------------------------- Example 2 -------------------------- PS C:\> Convert-HashtableToCode $h -inline @{Name = 'SRV1';Asset = 123454;Location = 'Omaha'} Create an inline string version of the hashtable. Online Version: http://bit.ly/31SLU7X Convert-HashtableString Convert-HtmlToAnsi Convert HtmlToAnsi Convert an HTML color code to ANSI. This simple function is designed to convert an HTML color code like #ff5733 into an ANSI escape sequence. To use the resulting value you still need to construct an ANSI string with the escape character and the closing [0m. Convert-HtmlToAnsi HtmlCode Specify an HTML color code like #13A10E. You need to include the # character. String String None HtmlCode Specify an HTML color code like #13A10E. You need to include the # character. String String None System.String System.String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Convert-HtmlToAnsi "#ff5733" [38;2;255;87;51m -------------------------- Example 2 -------------------------- PS C:\> "Running processes: `e$(cha "#ff337d")$((Get-Process).count)`e[0m" Running processes: 306 The number of processes will be displayed in color. This example is using the cha alias for Convert-HtmlToAnsi. Online Version: https://bit.ly/3qfPnwj ConvertFrom-LexicalTimespan ConvertFrom LexicalTimespan Convert a lexical timespan into a PowerShell timespan. When working with some XML data, such as that from scheduled tasks, timespans or durations are stored in a lexical format like P0DT0H0M47S. You can use this command to convert that value into a timespan object. ConvertFrom-LexicalTimespan String Enter a lexical time string like P23DT3H43M. This is case-sensitive. String String None AsString Format the timespan as a string SwitchParameter False AsString Format the timespan as a string SwitchParameter SwitchParameter False String Enter a lexical time string like P23DT3H43M. This is case-sensitive. String String None System.String String Timespan Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> ConvertFrom-LexicalTimespan P0DT0H0M47S Days : 0 Hours : 0 Minutes : 0 Seconds : 47 Milliseconds : 0 Ticks : 470000000 TotalDays : 0.000543981481481481 TotalHours : 0.0130555555555556 TotalMinutes : 0.783333333333333 TotalSeconds : 47 TotalMilliseconds : 47000 -------------------------- Example 2 -------------------------- PS C:\> Get-ScheduledTask -TaskName DailyWatcher | Select-Object Taskname, @{Name="ExecutionLimit";Expression = ` { ConvertFrom-LexicalTimespan $_.settings.ExecutionTimeLimit }} Taskname ExecutionLimit -------- -------------- DailyWatcher 3.00:00:00 Online Version: http://bit.ly/37C3gJJ ConvertTo-LexicalTimespan ConvertFrom-Text ConvertFrom Text Convert structured text to objects. This command will take structured text such as from a log file and convert it to objects that you can use in the PowerShell pipeline. You can specify the path to a text file, or pipe content directly into this command. The piped content could even be output from command-line tools. You have to specify a regular expression pattern that uses named captures. The names will become property names in the custom objects. The command will write a generic custom object to the pipeline. However, you can specify a custom type name. You might want to do this if you have your own format ps1xml file and want to handle formatting through that file. ConvertFrom-Text Pattern A regular expression pattern that uses named captures. This parameter has an aliases of regex and rx. Regex Regex None InputObject Any text that you want to pipe into this command. It can be a certain number of lines from a large text or log file. Or the output of a command line tool. Be sure to filter out blank lines. String String None NoProgress By default this command will display a progress bar to inform the user on the status. For large data sets this can impact performance. Use this parameter to suppress the progress messages. SwitchParameter False TypeName Enter an optional typename for the object output. If you don't use one, the command will write a generic custom object to the pipeline. String String None ConvertFrom-Text Pattern A regular expression pattern that uses named captures. This parameter has an aliases of regex and rx. Regex Regex None Path The filename and path to the text or log file. String String None NoProgress By default this command will display a progress bar to inform the user on the status. For large data sets this can impact performance. Use this parameter to suppress the progress messages. SwitchParameter False TypeName Enter an optional typename for the object output. If you don't use one, the command will write a generic custom object to the pipeline. String String None InputObject Any text that you want to pipe into this command. It can be a certain number of lines from a large text or log file. Or the output of a command line tool. Be sure to filter out blank lines. String String None NoProgress By default this command will display a progress bar to inform the user on the status. For large data sets this can impact performance. Use this parameter to suppress the progress messages. SwitchParameter SwitchParameter False Path The filename and path to the text or log file. String String None Pattern A regular expression pattern that uses named captures. This parameter has an aliases of regex and rx. Regex Regex None TypeName Enter an optional typename for the object output. If you don't use one, the command will write a generic custom object to the pipeline. String String None System.String PSCustomObject Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> $b = "(?<Date>\d{2}-\d{2}-\d{4}\s\d{2}:\d{2}).*(?<Error>\d+),\s+(?<Step>.*):\s+(?<Action>\w+),\s+(?<Path>(\w+\\)*\w+\.\w+)" PS C:\> ConvertFrom-Text -pattern $b -path C:\windows\DtcInstall.log Date : 10-18-2020 10:49 Error : 0 Step : CMsdtcUpgradePlugin::PostApply Action : Enter Path : com\complus\dtc\dtc\msdtcstp\msdtcplugin.cpp Date : 10-18-2020 10:49 Error : 0 Step : CMsdtcUpgradePlugin::PostApply Action : Exit Path : com\complus\dtc\dtc\msdtcstp\msdtcplugin.cpp ... The first command creates a variable to hold the regular expression pattern that defines named captures for content in the DtcInstall.log. The second line runs the command using the pattern and the log file. -------------------------- EXAMPLE 2 -------------------------- PS C:\> $wu = "(?<Date>\d{4}-\d{2}-\d{2})\s+(?<Time>(\d{2}:)+\d{3})\s+(?<PID>\d+)\s+(?<TID>\w+)\s+(?<Component>\w+)\s+(?<Message>.*)" PS C:\> $out = ConvertFrom-Text -pattern $wu -path C:\Windows\WindowsUpdate.log -noprogress PS C:\> $out | Group-Object Component | Sort-Object Count Count Name Group ----- ---- ----- 20 DtaStor {@{Date=2020-01-27; Time=07:19:19:584; PID=1... 72 Setup {@{Date=2020-01-27; Time=07:19:05:868; PID=1... 148 SLS {@{Date=2020-01-27; Time=07:19:05:086; PID=1... 150 PT {@{Date=2020-01-27; Time=07:19:08:946; PID=1... 209 WuTask {@{Date=2020-01-26; Time=20:05:28:483; PID=1... 256 EP {@{Date=2020-01-26; Time=21:21:23:341; PID=1... 263 Handler {@{Date=2020-01-27; Time=07:19:42:878; PID=3... 837 Report {@{Date=2020-01-26; Time=21:21:23:157; PID=1... 900 IdleTmr {@{Date=2020-01-26; Time=21:21:23:338; PID=1... 903 Service {@{Date=2020-01-26; Time=20:05:29:104; PID=1... 924 Misc {@{Date=2020-01-26; Time=21:21:23:033; PID=1... 1062 DnldMgr {@{Date=2020-01-26; Time=21:21:23:159; PID=1... 2544 AU {@{Date=2020-01-26; Time=19:55:27:449; PID=1... 2839 Agent {@{Date=2020-01-26; Time=21:21:23:045; PID=1... PS C:\> $out | Where-Object {\[datetime\]$_.date -ge \[datetime\]"2/10/2020" -AND $_.component -eq "AU"} | Format-Table Date,Time,Message -wrap Date Time Message ---- ---- ------- 2020-02-10 05:36:44:183 ########### AU: Initializing Automatic Updates ########### 2020-02-10 05:36:44:184 Additional Service {117CAB2D-82B1-4B5A-A08C-4D62DBEE7782} with Approval type {Scheduled} added to AU services list 2020-02-10 05:36:44:184 AIR Mode is disabled 2020-02-10 05:36:44:185 # Approval type: Scheduled (User preference) 2020-02-10 05:36:44:185 # Auto-install minor updates: Yes (User preference) 2020-02-10 05:36:44:185 # ServiceTypeDefault: Service 117CAB2D-82B1-4B5A-A08C-4D62DBEE7782 Approval type: (Scheduled) 2020-02-10 05:36:44:185 # Will interact with non-admins (Non-admins are elevated (User preference)) 2020-02-10 05:36:44:204 WARNING: Failed to get Wu Exemption info from NLM, assuming not exempt, error = 0x80070490 2020-02-10 05:36:44:213 AU finished delayed initialization 2020-02-10 05:38:01:000 ############# ... In this example, the WindowsUpdate log is converted from text to objects using the regular expression pattern. Given the size of the log file this process can take some time to complete so the progress bar is turned off to improve performance. -------------------------- EXAMPLE 3 -------------------------- PS C:\> Get-Content c:\windows\windowsupdate.log -totalcount 50 | ConvertFrom-Text $wu This example gets the first 50 lines from the Windows update log and converts that to objects using the pattern from the previous example. -------------------------- EXAMPLE 4 -------------------------- PS C:\> $c = "(?<Protocol>\w{3})\s+(?<LocalIP>(\d{1,3}\.){3}\d{1,3}):(?<LocalPort>\d+)\s+(?<ForeignIP>.*):(?<ForeignPort>\d+)\s+(?<State>\w+)?" PS C:\> netstat | select -skip 4 | ConvertFrom-Text $c | Format-Table -autosize Protocol LocalIP LocalPort ForeignIP ForeignPort State -------- ------- --------- --------- ----------- ----- TCP 127.0.0.1 19872 Novo8 50835 ESTABLISHED TCP 127.0.0.1 50440 Novo8 50441 ESTABLISHED TCP 127.0.0.1 50441 Novo8 50440 ESTABLISHED TCP 127.0.0.1 50445 Novo8 50446 ESTABLISHED TCP 127.0.0.1 50446 Novo8 50445 ESTABLISHED TCP 127.0.0.1 50835 Novo8 19872 ESTABLISHED TCP 192.168.6.98 50753 74.125.129.125 5222 ESTABLISHED The first command creates a variable to be used with output from the Netstat command which is used in the second command. -------------------------- EXAMPLE 5 -------------------------- PS C:\> $arp = "(?<IPAddress>(\d{1,3}\.){3}\d{1,3})\s+(?<MAC>(\w{2}-){5}\w{2})\s+(?<Type>\w+$)" PS C:\> arp -g -N 172.16.10.22 | Select-Object -skip 3 | ForEach-Object {$_.Trim()} | ConvertFrom-Text $arp -noprogress -typename arpData IPAddress MAC Type --------- --- ---- 172.16.10.1 00-13-d3-66-50-4b dynamic 172.16.10.100 00-0d-a2-01-07-5d dynamic 172.16.10.101 2c-76-8a-3d-11-30 dynamic 172.16.10.121 00-0e-58-ce-8b-b6 dynamic 172.16.10.122 1c-ab-a7-99-9a-e4 dynamic 172.16.10.124 00-1e-2a-d9-cd-b6 dynamic 172.16.10.126 00-0e-58-8c-13-ac dynamic 172.16.10.128 70-11-24-51-84-60 dynamic ... The first command creates a regular expression for the ARP command. The second prompt shows the ARP command being used to select the content, trimming each line, and then converting the output to text using the regular expression named pattern. This example also defines a custom type name for the output. Online Version: http://bit.ly/31VAujZ Get-Content About_Regular_Expressions ConvertFrom-UTCTime ConvertFrom UTCTime Convert a datetime value from universal. Use this command to convert a universal datetime object into local time. This command was introduced in v2.3.0. ConvertFrom-UTCTime DateTime Enter a Universal Datetime value DateTime DateTime None DateTime Enter a Universal Datetime value DateTime DateTime None System.DateTime System.DateTime Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> ConvertFrom-UTCTime "18:00" Monday, March 4, 2020 1:00:00 PM Covert the time 18:00 for the current day from universal time to local time. This result reflects Eastern Time which on this date is UTC-5. Online Version: http://bit.ly/31RGo5q ConvertTo-UTCTime Get-Date ConvertTo-Hashtable ConvertTo Hashtable Convert an object into a hashtable. This command will take an object and create a hashtable based on its properties. You can have the hashtable exclude some properties as well as properties that have no value. ConvertTo-Hashtable InputObject A PowerShell object to convert to a hashtable. Object Object None NoEmpty Do not include object properties that have no value. SwitchParameter False Exclude An array of property names to exclude from the hashtable. String[] String[] None Alphabetical Create a hashtable with property names arranged alphabetically. SwitchParameter False InputObject A PowerShell object to convert to a hashtable. Object Object None NoEmpty Do not include object properties that have no value. SwitchParameter SwitchParameter False Exclude An array of property names to exclude from the hashtable. String[] String[] None Alphabetical Create a hashtable with property names arranged alphabetically. SwitchParameter SwitchParameter False System.Object System.Collections.Specialized.OrderedDictionary Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ This was originally described at: http://jdhitsolutions.com/blog/2013/01/convert-powershell-object-to-hashtable-revised -------------------------- EXAMPLE 1 -------------------------- PS C:\> Get-Process -id $pid | Select-Object name,id,handles,workingset | ConvertTo-Hashtable Name Value ---- ----- WorkingSet 418377728 Name powershell_ise Id 3456 Handles 958 -------------------------- EXAMPLE 2 -------------------------- PS C:\> $hash = Get-Service spooler | ConvertTo-Hashtable -Exclude CanStop,CanPauseAndContinue -NoEmpty PS C:\> $hash Name Value ---- ----- ServiceType Win32OwnProcess, InteractiveProcess ServiceName spooler ServiceHandle SafeServiceHandle DependentServices {Fax} ServicesDependedOn {RPCSS, http} Name spooler Status Running MachineName . RequiredServices {RPCSS, http} DisplayName Print Spooler This created a hashtable from the Spooler service object, skipping empty properties and excluding CanStop and CanPauseAndContinue. -------------------------- EXAMPLE 3 -------------------------- PS C:\> Get-Service bits | Select-Object Name,Displayname,Status, @{Name="Computername";Expression={$_.Machinename}} | ConvertTo-Hashtable -Alphabetical Name Value ---- ----- Computername . DisplayName Background Intelligent Transfer Service Name bits Status Running Convert an object to a hashtable and order the properties alphabetically. Online Version: http://bit.ly/31SG9Y2 About_Hash_Tables Get-Member ConvertTo-LexicalTimespan ConvertTo LexicalTimespan Convert a timespan to lexical time. Convert a timespan into a lexical version that you can insert into an XML document. ConvertTo-LexicalTimespan Timespan Enter a timespan object TimeSpan TimeSpan None Timespan Enter a timespan object TimeSpan TimeSpan None System.TimeSpan String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> ConvertTo-LexicalTimespan (New-Timespan -Days 7) P7D You can insert this value into an XML document where you need to represent a time-span. Online Version: http://bit.ly/2S5qPUK ConvertFrom-LexicalTimespan ConvertTo-LocalTime ConvertTo LocalTime Convert a foreign time to local. It can be tricky sometimes to see a time in a foreign location and try to figure out what that time is locally. This command attempts to simplify this process. In addition to the remote time, you need the base UTC offset for the remote location. You can use Get-Timezone or Get-TZData to help. See examples. The parameter for DaylightSavingTime is to indicate that the remote location is observing DST. You can use this with the location's standard UTC offset, or you can specify an offset that takes DST into account. ConvertTo-LocalTime Datetime Enter a non-local date time DateTime DateTime None UTCOffset Enter the location's' UTC Offset. You can use Get-Timezone to discover it. TimeSpan TimeSpan None DaylightSavingTime Indicate that the foreign location is using Daylight Saving Time SwitchParameter False Datetime Enter a non-local date time DateTime DateTime None UTCOffset Enter the location's' UTC Offset. You can use Get-Timezone to discover it. TimeSpan TimeSpan None DaylightSavingTime Indicate that the foreign location is using Daylight Saving Time SwitchParameter SwitchParameter False None DateTime Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> ConvertTo-LocalTime "3/15/2019 7:00AM" 8:00:00 Thursday, March 14, 2019 7:00:00 PM Convert a time that is in Singapore to local (Eastern) time. -------------------------- Example 2 -------------------------- PS C:\> Get-TimeZone -ListAvailable | where-object id -match hawaii Id : Hawaiian Standard Time DisplayName : (UTC-10:00) Hawaii StandardName : Hawaiian Standard Time DaylightName : Hawaiian Daylight Time BaseUtcOffset : -10:00:00 SupportsDaylightSavingTime : False PS C:\> ConvertTo-LocalTime "10:00AM" -10:00:00 Thursday, March 14, 2019 4:00:00 PM In this example, the user is first determining the UTC offset for Hawaii. Then 10:00AM in Honolulu, is converted to local time which in this example is in the Eastern Time zone. Online Version: http://bit.ly/31VABfp Get-TimeZone Get-Date Get-MyTimeInfo Get-TZList ConvertFrom-UTCTime ConvertTo-UTCTime ConvertTo-Markdown ConvertTo Markdown Convert pipeline output to a markdown document. This command is designed to accept pipelined output and create a generic markdown document. The pipeline output will formatted as a text block or you can specify a table. The AsList parameter technically still create a table, but it is two columns with the property namd and value. You can optionally define a title, content to appear before the output, and content to appear after the output. Best efforts have been made to produce markdown output that meets basic standards. The command does not create a text file. You need to pipe results from this command to a cmdlet like Out-File or Set-Content. See examples. ConvertTo-Markdown Inputobject Typically the results of a PowerShell command or expression. Object Object None Title Specify a top-level title. You do not need to include any markdown. It will automatically be formatted with a H1 tag. String String None PreContent Enter whatever content you want to appear before converted input. You can use whatever markdown you wish. String[] String[] None PostContent Enter whatever content you want to appear after converted input. You can use whatever markdown you wish. String[] String[] None Width Specify the document width. Depending on what you intend to do with the markdown from this command you may want to adjust this value. Int32 Int32 80 ConvertTo-Markdown Inputobject Typically the results of a PowerShell command or expression. Object Object None Title Specify a top-level title. You do not need to include any markdown. It will automatically be formatted with a H1 tag. String String None PreContent Enter whatever content you want to appear before converted input. You can use whatever markdown you wish. String[] String[] None PostContent Enter whatever content you want to appear after converted input. You can use whatever markdown you wish. String[] String[] None AsTable Format the incoming data as a markdown table. This works best with similar content such as the result of running a PowerShell command. SwitchParameter False ConvertTo-Markdown Inputobject Typically the results of a PowerShell command or expression. Object Object None Title Specify a top-level title. You do not need to include any markdown. It will automatically be formatted with a H1 tag. String String None PreContent Enter whatever content you want to appear before converted input. You can use whatever markdown you wish. String[] String[] None PostContent Enter whatever content you want to appear after converted input. You can use whatever markdown you wish. String[] String[] None AsList Display results as a 2 column markdown table. The first column will be the property name with the value formatted as a string in the second column. SwitchParameter False Inputobject Typically the results of a PowerShell command or expression. Object Object None Title Specify a top-level title. You do not need to include any markdown. It will automatically be formatted with a H1 tag. String String None PreContent Enter whatever content you want to appear before converted input. You can use whatever markdown you wish. String[] String[] None PostContent Enter whatever content you want to appear after converted input. You can use whatever markdown you wish. String[] String[] None Width Specify the document width. Depending on what you intend to do with the markdown from this command you may want to adjust this value. Int32 Int32 80 AsTable Format the incoming data as a markdown table. This works best with similar content such as the result of running a PowerShell command. SwitchParameter SwitchParameter False AsList Display results as a 2 column markdown table. The first column will be the property name with the value formatted as a string in the second column. SwitchParameter SwitchParameter False System.Object System.String Learn more about PowerShell: https://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Get-Service Bits,Winrm | Convertto-Markdown -title "Service Check" -precontent "## $($env:computername)" # Service Check ## THINK51 \`\`\`text Status Name DisplayName ------ ---- ----------- Running Bits Background Intelligent Transfer Ser... Running Winrm Windows Remote Management (WS-Manag... \`\`\` Create markdown output from a Get-Service command. -------------------------- EXAMPLE 2 -------------------------- PS C:\> Get-Service Bits,Winrm | Convertto-Markdown -title "Service Check" -precontent "## $($env:computername)"` -postcontent "_report $(Get-Date)_" | Out-File c:\work\svc.md Re-run the previous command and save the output to a file. -------------------------- EXAMPLE 3 -------------------------- PS C:\> $computers = "srv1","srv2","srv4" PS C:\> $Title = "System Report" PS C:\> $footer = "_report run by $($env:USERDOMAIN)\$($env:USERNAME)_" PS C:\> $sb = { $os = Get-CimInstance -classname win32_operatingsystem -property caption, lastbootUptime \[PSCustomObject\]@{ PSVersion = $PSVersionTable.PSVersion OS = $os.caption Uptime = (Get-Date) - $os.lastbootUpTime SizeFreeGB = (Get-Volume -DriveLetter C).SizeRemaining /1GB } } PS C:\> $out = Convertto-Markdown -title $Title PS C:\> foreach ($computer in $computers) { $out+= Invoke-command -scriptblock $sb -Computer $computer -HideComputerName | Select-Object -Property * -ExcludeProperty RunspaceID | ConvertTo-Markdown -PreContent "## $($computer.toUpper())" } PS C:\>$out += ConvertTo-Markdown -PostContent $footer PS C:\>$out | Set-Content c:\work\report.md Here is an example that creates a series of markdown fragments for each computer and in the end creates a markdown document. The commands are shown at a PowerShell prompt, but you are likely to put them in a PowerShell script file. -------------------------- EXAMPLE 4 -------------------------- PS C:\> Get-WindowsVersion | ConvertTo-Markdown -title "OS Summary" -PreContent "## $($env:computername)" -AsList # OS Summary ## THINKX1 | | | |----|----| |ProductName|Windows 10 Pro| |EditionID|Professional| |ReleaseID|2009| |Build|22000.376| |Branch|co_release| |InstalledUTC|8/10/2021 12:17:07 AM| |Computername|THINKX1-JH| Create a "list" table with output from the Get-WindowsVersion command. -------------------------- EXAMPLE 5 -------------------------- PS C:\> Get-Service | Sort-Object -property Displayname | Foreach-Object -begin { "# Service Status`n" } -process { $name = $_.Displayname $_ | Select-Object -property Name,StartType,Status, @{Name="RequiredServices";Expression = {$_.requiredservices.name -join ','}} | ConvertTo-Markdown -asList -PreContent "## $Name" } -end { "### $($env:computername) $(Get-Date)" } | Out-File c:\work\services.md The example will create a markdown file with a title of Service Status. Each service will be converted to a markdown list with the DisplayName as pre-content. Online Version: http://bit.ly/31Nn21e Convertto-HTML Out-File ConvertTo-TitleCase ConvertTo TitleCase Convert a string to title case. This command is a simple function to convert a string to title or proper case. ConvertTo-TitleCase Text Text to convert to title case. String String None Text Text to convert to title case. String String None System.String System.String -------------------------- Example 1 -------------------------- PS C:\> ConvertTo-TitleCase "working summary" Working Summary -------------------------- Example 2 -------------------------- PS C:\> "art deco","jack frost","al fresco" | ConvertTo-TitleCase Art Deco Jack Frost Al Fresco Online Version: https://bit.ly/3gQclWl ConvertTo-UTCTime ConvertTo UTCTime Convert a local datetime to universal time. Convert a local datetime to universal time. The default is now but you can specify a datetime value. You also have an option to format the result as a sortable string. This command was introduced in v2.3.0. ConvertTo-UTCTime DateTime Enter a Datetime value DateTime DateTime now AsString Convert the date-time value to a sortable string. This is the same thing as running a command like "{0:u}" -f (Get-Date).ToUniversaltime() SwitchParameter False DateTime Enter a Datetime value DateTime DateTime now AsString Convert the date-time value to a sortable string. This is the same thing as running a command like "{0:u}" -f (Get-Date).ToUniversaltime() SwitchParameter SwitchParameter False System.DateTime System.DateTime Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-Date Monday, December 28, 2020 7:43:13 PM PS C:\> ConvertTo-UTCTime Tuesday, December 29, 2020 12:43:37 AM -------------------------- Example 2 -------------------------- PS C:\> ConvertTo-UTCTime -asString 2020-12-29 00:44:01Z Online Version: http://bit.ly/31RGrOE ConvertFrom-UTCTime Get-Date ConvertTo-WPFGrid ConvertTo WPFGrid Send command output to an interactive WPF-based grid. This command is an alternative to Out-Gridview. It works much the same way. Run a PowerShell command and pipe it to this command. The output will be displayed in an auto-sized data grid. You can click on column headings to sort. You can resize columns and you can re-order columns. You will want to be selective about which properties you pipe through to this command. See examples. You can specify a timeout value which will automatically close the form. If you specify a timeout and the Refresh parameter, then the contents of the datagrid will automatically refreshed using the timeout value as an integer. This will only work when you pipe a PowerShell expression to ConvertTo-WPFGrid as one command. This will fail if you break the command in the PowerShell ISE or use a nested prompt. Beginning with v2.4.0 the form now has a Refresh button which will automatically refresh the datagrid. You should set a refresh interval that is greater than the time it takes to complete the command. Because the grid is running in a new background runspace, it does not automatically inherit anything from your current session. However, you can use the -UserProfile parameter which will load your user profile scripts into the runspace. You can specify a list of locally defined variables to be used in the form. Use the variable name without the $. Finally, you can also use the -InitializationScript parameter and specify a scriptblock of PowerShell code to initialize the runspace. This is helpful when you need to dot source external scripts or import modules not in your module path. This command runs the WPF grid in a new runspace so your PowerShell prompt will not be blocked. However, after closing the form you may be left with the runspace. You can use Remove-Runspace to clean up or wait until you restart PowerShell. This command requires a Windows platform. ConvertTo-WPFGrid InputObject Typically the results of a PowerShell command or expression. You should select the specific properties you wish to display. PSObject PSObject None Title Specify a title for your form. String String ConvertTo-WPFGrid Timeout By default, the grid will remain displayed until you manually close it. But you can specify a timeout interval in seconds. The minimum accepted value is 5 seconds. If you use this parameter with -Refresh, then the datagrid will be refreshed with results of the PowerShell expression you piped to ConvertTo-WPFGrid. Int32 Int32 0 Refresh If you specify this parameter and a Timeout value, this command will refresh the datagrid with the PowerShell expression piped into ConvertTo-WPFGrid. You should use a value that is longer than the time it takes to complete the command that generates your data. This parameter will only work if you are using ConvertTo-WPFGrid at the end of a pipelined expression. See examples. SwitchParameter False UseProfile Load your PowerShell profiles into the background runspace. SwitchParameter False UseLocalVariable Load locally defined variables into the background runspace String[] String[] None InitializationScript Run this scriptblock to initialize the background runspace. You might need to dot source a script file or load a non-standard module. ScriptBlock ScriptBlock None Gridlines Control how grid lines are displayed in the form. You may not want to have any or perhaps only vertical or horizontal lines. String String None ConvertTo-WPFGrid Title Specify a title for your form. String String ConvertTo-WPFGrid Timeout By default, the grid will remain displayed until you manually close it. But you can specify a timeout interval in seconds. The minimum accepted value is 5 seconds. If you use this parameter with -Refresh, then the datagrid will be refreshed with results of the PowerShell expression you piped to ConvertTo-WPFGrid. Int32 Int32 0 Refresh If you specify this parameter and a Timeout value, this command will refresh the datagrid with the PowerShell expression piped into ConvertTo-WPFGrid. You should use a value that is longer than the time it takes to complete the command that generates your data. This parameter will only work if you are using ConvertTo-WPFGrid at the end of a pipelined expression. See examples. SwitchParameter False UseProfile Load your PowerShell profiles into the background runspace. SwitchParameter False Scriptblock Enter a scriptblock that will generate data to be populated in the form ScriptBlock ScriptBlock None UseLocalVariable Load locally defined variables into the background runspace String[] String[] None InitializationScript Run this scriptblock to initialize the background runspace. You might need to dot source a script file or load a non-standard module. ScriptBlock ScriptBlock None Gridlines Control how grid lines are displayed in the form. You may not want to have any or perhaps only vertical or horizontal lines. String String None InputObject Typically the results of a PowerShell command or expression. You should select the specific properties you wish to display. PSObject PSObject None Title Specify a title for your form. String String ConvertTo-WPFGrid Timeout By default, the grid will remain displayed until you manually close it. But you can specify a timeout interval in seconds. The minimum accepted value is 5 seconds. If you use this parameter with -Refresh, then the datagrid will be refreshed with results of the PowerShell expression you piped to ConvertTo-WPFGrid. Int32 Int32 0 Refresh If you specify this parameter and a Timeout value, this command will refresh the datagrid with the PowerShell expression piped into ConvertTo-WPFGrid. You should use a value that is longer than the time it takes to complete the command that generates your data. This parameter will only work if you are using ConvertTo-WPFGrid at the end of a pipelined expression. See examples. SwitchParameter SwitchParameter False UseProfile Load your PowerShell profiles into the background runspace. SwitchParameter SwitchParameter False Scriptblock Enter a scriptblock that will generate data to be populated in the form ScriptBlock ScriptBlock None UseLocalVariable Load locally defined variables into the background runspace String[] String[] None InitializationScript Run this scriptblock to initialize the background runspace. You might need to dot source a script file or load a non-standard module. ScriptBlock ScriptBlock None Gridlines Control how grid lines are displayed in the form. You may not want to have any or perhaps only vertical or horizontal lines. String String None System.Object None Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Get-Process | Sort-Object WS -Descending | Select-object -first 20 ID,Name,WS,VM,PM,Handles,StartTime | Convertto-WPFGrid -Refresh -timeout 20 -Title "Top Processes" Get the top 20 processes based on the value of the WorkingSet property and display selected properties in the WPF Grid. The contents will automatically refresh every 20 seconds. You will need to manually close the form. -------------------------- EXAMPLE 2 -------------------------- PS C:\> $vmhost = "CHI-HVR2" PS C:\> Get-VM -computername $VMHost | Select Name,State,Uptime, @{Name="AssignedMB";Expression={$_.MemoryAssigned/1mb -as [int]}}, @{Name="DemandMB";Expression={$_.MemoryDemand/1mb -as [int]}} | ConvertTo-WPFGrid -title "VM Report $VMHost" -timeout 30 -refresh -uselocalvariable VMHost Get Hyper-V virtual machine information and refresh every 30 seconds. Because the command is using a locally defined variable it is also being used in the form. Note that this would be written as one long pipelined expression. It is formatted here for the sake of the help documentation. -------------------------- EXAMPLE 3 -------------------------- PS C:\> Get-VMData -host CHI-HVR2 | ConvertTo-WPFGrid -title "VM Data" -refresh -timeout 60 -useprofile This example uses a hypothetical command that might be defined in a PowerShell profile script. ConvertTo-WPFGrid will load the profile scripts so that the data can be updated every 60 seconds. -------------------------- EXAMPLE 4 -------------------------- PS C:\> (Get-Processdata -Computername $computers).where({$_.workingset -ge 100mb}) | ConvertTo-WPFGrid -Title "Process Report" -UseLocalVariable computers -InitializationScript {. C:\scripts\Get-ProcessData.ps1} -Refresh -Timeout 30 This command runs a function that is defined in a script file. In order for the form to refresh, it must also dot source the script which is happening with the InitializationScript parameter. The example is also loading the local $computers variable so that it too is available upon refresh. Online Version: http://bit.ly/31TxZyi Out-GridView ConvertTo-HTML ConvertTo-Markdown Copy-Command Copy Command Copy a PowerShell command. This command will copy a PowerShell command, including parameters and help to a new user-specified command. You can use this to create a "wrapper" function or to easily create a proxy function. The default behavior is to create a copy of the command complete with the original comment-based help block. For best results, run this in the PowerShell ISE or Visual Studio code, the copied command will be opened in a new tab or file. Copy-Command Command The name of a PowerShell command, preferably a cmdlet but that is not a requirement. You can specify an alias and it will be resolved. String String None NewName Specify a name for your copy of the command. If no new name is specified, the original name will be used. String String None IncludeDynamic The command will only copy explicitly defined parameters unless you specify to include any dynamic parameters as well. If you copy a command and it seems to be missing parameters, re-copy and include dynamic parameters. SwitchParameter False AsProxy Create a traditional proxy function. SwitchParameter False UseForwardHelp By default the copy process will create a comment-based help block with the original command's help which you can then edit to meet your requirements. Or you can opt to retain the forwarded help links to the original command. SwitchParameter False Command The name of a PowerShell command, preferably a cmdlet but that is not a requirement. You can specify an alias and it will be resolved. String String None NewName Specify a name for your copy of the command. If no new name is specified, the original name will be used. String String None IncludeDynamic The command will only copy explicitly defined parameters unless you specify to include any dynamic parameters as well. If you copy a command and it seems to be missing parameters, re-copy and include dynamic parameters. SwitchParameter SwitchParameter False AsProxy Create a traditional proxy function. SwitchParameter SwitchParameter False UseForwardHelp By default the copy process will create a comment-based help block with the original command's help which you can then edit to meet your requirements. Or you can opt to retain the forwarded help links to the original command. SwitchParameter SwitchParameter False None System.String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Copy-Command Get-Process Get-MyProcess Create a copy of Get-Process called Get-MyProcess. -------------------------- EXAMPLE 2 -------------------------- PS C:\> Copy-Command Get-Eventlog -asproxy -useforwardhelp Create a proxy function for Get-Eventlog and use forwarded help links. -------------------------- EXAMPLE 3 -------------------------- PS C:\> Copy-Command Get-ADComputer Get-MyADComputer -includedynamic Create a wrapper function for Get-ADComputer called Get-MyADComputer. Due to the way the Active Directory cmdlets are written, most parameters appear to be dynamic so you need to include dynamic parameters otherwise there will be no parameters in the final function. Online Version: http://bit.ly/31Ty8Sm Get-Command Copy-HelpExample Copy HelpExample Copy code snippet from help examples. This command is intended to make it easier to copy code snippets from help examples to the clipboard. You can select one or more examples which have been trimmed of comments, blank lines and most prompts. Some code examples contain the output or have several lines of code. You will need to manually delete what you don't want. If this command is run on a Windows system you have a dynamic parameter to use Out-Gridview to display your choices. When prompted enter a comma-separated list of the examples you wish to copy. Otherwise, the command will display a console-based menu. Note that if you are using the PowerShell ISE you will be forced to use Out-GridView. Copy-HelpExample Name Enter the name of the PowerShell command. String String None Path Gets help that explains how the cmdlet works in the specified provider path. Enter a PowerShell provider path. String String None UseGridView Select help examples using Out-Gridview. This parameter is only available on Windows systems. The parameter has an alias of 'ogv'. SwitchParameter False Name Enter the name of the PowerShell command. String String None Path Gets help that explains how the cmdlet works in the specified provider path. Enter a PowerShell provider path. String String None UseGridView Select help examples using Out-Gridview. This parameter is only available on Windows systems. The parameter has an alias of 'ogv'. SwitchParameter SwitchParameter False None None Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Copy-HelpExample -Name Stop-Process Code Samples Each help example is numbered to the left. At the prompt below, select the code samples you want to copy to the clipboard. Separate multiple values with a comma. Some example code includes the output. [1] Example 1: Stop all instances of a process Stop-Process -Name "notepad" [2] Example 2: Stop a specific instance of a process Stop-Process -Id 3952 -Confirm -PassThru Confirm Are you sure you want to perform this action? Performing operation "Stop-Process" on Target "notepad (3952)". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):y Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName ------- ------ ----- ----- ----- ------ -- ----------- 41 2 996 3212 31 3952 notepad [3] Example 3: Stop a process and detect that it has stopped calc $p = Get-Process -Name "calc" Stop-Process -InputObject $p Get-Process | Where-Object {$_.HasExited} [4] Example 4: Stop a process not owned by the current user Get-Process -Name "lsass" | Stop-Process Stop-Process : Cannot stop process 'lsass (596)' because of the following error : Access is denied At line:1 char:34 + Get-Process -Name "lsass" | Stop-Process <<<< [ADMIN]: Get-Process -Name "lsass" | Stop-Process Warning! Are you sure you want to perform this action? Performing operation 'Stop-Process' on Target 'lsass(596)' [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): [ADMIN]: Get-Process -Name "lsass" | Stop-Process -Force [ADMIN]: Please select items to copy to the clipboard by number. Separate multiple entries with a comma. Press Enter alone to cancel: The console menu will be displayed using ANSI. Enter a comma separated list of numbers for the items to copy to the clipboard. Online Version: https://bit.ly/3dlKTfI Get-Help Copy-HistoryCommand Copy HistoryCommand Copy a history command line to the clipboard. You can use this command to copy the commandline from a given PowerShell history item to the clipboard.The default item will the be last history item. Once copied, you can paste into your following prompt to edit and/or re-run. Linux platforms require the xclip utility to be in the path. Lee Holmes has a similar function called Copy-History in the PowerShell Cookbook that lets you copy a range of history commands to the clipboard. Copy-HistoryCommand ID The history ID number. The default is the last command. Int32[] Int32[] $(Get-History).Count Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter False Passthru Use this parameter if you also want to see the command as well as copy it to the clipboard. SwitchParameter False WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter False Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter SwitchParameter False ID The history ID number. The default is the last command. Int32[] Int32[] $(Get-History).Count Passthru Use this parameter if you also want to see the command as well as copy it to the clipboard. SwitchParameter SwitchParameter False WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter SwitchParameter False Int None System.String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Copy-HistoryCommand Copy the last command to the clipboard. -------------------------- Example 2 -------------------------- PS C:\> Copy-HistoryCommand 25 -passthru get-process -computername $computer | sort ws -Descending | select -first 3 Copy the command from history item 25 to the clipboard and also pass it to the pipeline. -------------------------- Example 3 -------------------------- PS C:\> Copy-HistoryCommand (100..110) Copy history items 100 through 110 to the clipboard. -------------------------- Example 4 -------------------------- PS C:\> $c = [scriptblock]::Create($(Copy-HistoryCommand 25 -passthru)) PS C:\> &$c Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id SI ProcessName ------- ------ ----- ----- ----- ------ -- -- ----------- 10414 12744 488164 461596 ...76 3128 0 dns 581 67 171868 141620 ...82 3104 0 MsMpEng 678 48 118132 89572 840 7180 0 ServerManager This copies the command from history item 25 and turns it into a scriptblock. Online Version: https://bit.ly/3nPKjwX Get-History Set-Clipboard Out-Copy Copy-PSFunction Copy PSFunction Copy a local PowerShell function to a remote session. This command is designed to solve the problem when you want to run a function loaded locally on a remote computer. Copy-PSFunction will copy a PowerShell function that is loaded in your current PowerShell session to a remote PowerShell session. The remote session must already be created. The copied function only exists remotely for the duration of the remote PowerShell session. If the function relies on external or additional files, you will have to copy them to the remote session separately. Copy-PSFunction Name Enter the name of a local function. String[] String[] None Force Overwrite an existing function with the same name. The default behavior is to skip existing functions. SwitchParameter False Session Specify an existing PSSession. PSSession PSSession None Force Overwrite an existing function with the same name. The default behavior is to skip existing functions. SwitchParameter SwitchParameter False Name Enter the name of a local function. String[] String[] None Session Specify an existing PSSession. PSSession PSSession None System.String[] Deserialized.System.Management.Automation.FunctionInfo Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> "Get-LastBoot","Get-DiskFree" | Copy-PSFunction -session $S Copy the local functions Get-LastBoot and Get-DiskFree to a previously created PSSession saved as $S. You could then run the function remotely using Invoke-Command. Online Version: https://bit.ly/2FpejNh Copy-Item Export-PSAnsiFileMap Export PSAnsiFileMap Export a PSAnsiFileMap to a file. The PSScriptTools module includes a JSON file that is automatically imported as the global PSAnsiFileMap variable. This variable is used for the custom ANSI formatted table view, among other module commands. If you wish to customize the file map, you can use the Set-PSAnsiFileMap command. These changes are not permanent and will be overwritten the next time you import the PSScriptTools module. To use your customized settings, you need to export your modified $PSAnsiFileMap object with this command. The command will export the settings to a JSON file called psansifilemap.json in the root of $HOME. The next time you import the PSScriptTools module, it will use this file if found. To revert to the default file map either rename or delete the file in $HOME. Export-PSAnsiFileMap Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter False Passthru SwitchParameter False WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter False Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter SwitchParameter False Passthru SwitchParameter SwitchParameter False WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter SwitchParameter False None None System.IO.FileInfo Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\>Export-PSAnsiFileMap -Passthru Directory: C:\Users\Jeff Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 12/28/2020 1:02 PM 1631 psansifilemap.json Online Version: https://bit.ly/361o7Y9 Get-PSAnsiFileMap Set-PSAnsiFileMap Find-CimClass Find CimClass Search CIM for a class. This function is designed to search an entire CIM repository for a class name. Sometimes, you can guess a CIM/WMI class name but not know the full name or even the correct namespace. Find-CimClass will recursively search for a given classname in all namespaces. You can use wildcards and search remote computers. This command requires a Windows platform. Find-CimClass Classname Enter the name of a CIM/WMI class. Wildcards are permitted. String String None Computername Enter the name of a computer to search. String String localhost Exclude Enter a pattern for class names to EXCLUDE from the results. You can use wildcards or regular expressions. String String None Classname Enter the name of a CIM/WMI class. Wildcards are permitted. String String None Computername Enter the name of a computer to search. String String localhost Exclude Enter a pattern for class names to EXCLUDE from the results. You can use wildcards or regular expressions. String String None None Microsoft.Management.Infrastructure.CimClass Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources -------------------------- Example 1 -------------------------- PS C:\> Find-CimClass -Classname *protection* NameSpace: Root/CIMV2/mdm/dmmap CimClassName CimClassMethods CimClassProperties ------------ --------------- ------------------ MDM_AppLocker_EnterpriseDataProt... {} {InstanceID, Parent... MDM_AppLocker_EnterpriseDataProt... {} {InstanceID, Parent... MDM_EnterpriseDataProtection {} {InstanceID, Parent... MDM_EnterpriseDataProtection_Set... {} {AllowAzureRMSForED... MDM_Policy_Config01_DataProtecti... {} {AllowDirectMemoryA... MDM_Policy_Result01_DataProtecti... {} {AllowDirectMemoryA... MDM_Reporting_EnterpriseDataProt... {} {InstanceID, LogCou... MDM_Reporting_EnterpriseDataProt... {} {InstanceID, Logs, ... MDM_WindowsAdvancedThreatProtection {} {InstanceID, Offboa... MDM_WindowsAdvancedThreatProtect... {} {GroupIds, Instance... MDM_WindowsAdvancedThreatProtect... {} {Criticality, Grou ... MDM_WindowsAdvancedThreatProtect... {} {InstanceID, LastCo... NameSpace: Root/Microsoft/SecurityClient CimClassName CimClassMethods CimClassProperties ------------ --------------- ------------------ ProtectionTechnologyStatus {} {PackedXml, SchemaV... ... -------------------------- Example 2 -------------------------- PS C:\> Find-CimClass -Classname *volume* -Exclude "win32_Perf*" Search for any class with 'volume' in the name but exclude anything that starts with 'win32_Perf'. Online Version: http://bit.ly/31SEzp2 Get-CimClass Format-Percent Format Percent Format a value as a percentage. This command calculates a percentage of a value from a total, with the formula: (value/total)*100. The default is to return a value to 2 decimal places but you can configure that with -Decimal. There is also an option to format the percentage as a string which will include the % symbol. Format-Percent Value The numerator value. Object Object None Total The denominator value. Object Object None Decimal The number of decimal places to return between 0 and 15. Int32 Int32 2 AsString Write the result as a string. SwitchParameter False Value The numerator value. Object Object None Total The denominator value. Object Object None Decimal The number of decimal places to return between 0 and 15. Int32 Int32 2 AsString Write the result as a string. SwitchParameter SwitchParameter False System.Object System.Double System.String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Format-Percent -value 1234.567 -total 5000 -decimal 4 24.6913 Calculate a percentage from 1234.567 out of 5000 (i.e. 1234.567/5000) to 4 decimal points. -------------------------- EXAMPLE 2 -------------------------- PS C:\> Get-CimInstance win32_operatingsystem -computer chi-dc04 | Select-Object PSComputername,TotalVisibleMemorySize, @{Name="PctFreeMem";Expression={ Format-Percent $_.FreePhysicalMemory $_.TotalVisibleMemorySize}} PSComputerName TotalVisibleMemorySize PctFreeMem -------------- ---------------------- ---------- chi-dc04 1738292 23.92 -------------------------- EXAMPLE 3 -------------------------- PS C:\> Get-CimInstance win32_operatingsystem -computer chi-dc04 | Select-Object PSComputername,TotalVisibleMemorySize, @{Name="PctFreeMem";Expression={ Format-Percent $_.FreePhysicalMemory $_.TotalVisibleMemorySize -asString}} PSComputerName TotalVisibleMemorySize PctFreeMem -------------- ---------------------- ---------- chi-dc04 1738292 23.92% Online Version: http://bit.ly/31UsX50 Format-Value Format-String Format-String Format String Options for formatting strings. Use this command to apply different types of formatting to strings. You can apply multiple transformations. They are applied in this order: 1) Reverse 2) Randomization 3) Replace 4) Case Format-String Text Any string you want to format. String String None Reverse Reverse the text string. SwitchParameter False Case Valid values are Upper, Lower, Proper, Alternate, and Toggle. Proper case will capitalize the first letter of the string. Alternate case will alternate between upper and lower case, starting with upper case, e.g. PoWeRsHeLl Toggle case will make upper case lower and vice versa, e.g. Powershell -> pOWERSHELL String String None Replace Specify a hashtable of replacement values. The hashtable key is the string you want to replace and the value is the replacement (see examples). Replacement keys are CASE SENSITIVE. Hashtable Hashtable None Randomize Re-arrange the text in a random order. SwitchParameter False Text Any string you want to format. String String None Reverse Reverse the text string. SwitchParameter SwitchParameter False Case Valid values are Upper, Lower, Proper, Alternate, and Toggle. Proper case will capitalize the first letter of the string. Alternate case will alternate between upper and lower case, starting with upper case, e.g. PoWeRsHeLl Toggle case will make upper case lower and vice versa, e.g. Powershell -> pOWERSHELL String String None Replace Specify a hashtable of replacement values. The hashtable key is the string you want to replace and the value is the replacement (see examples). Replacement keys are CASE SENSITIVE. Hashtable Hashtable None Randomize Re-arrange the text in a random order. SwitchParameter SwitchParameter False System.String System.String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> "P@ssw0rd" | Format-String -Reverse dr0wss@P -------------------------- EXAMPLE 2 -------------------------- PS C:\> "P@ssw0rd" | Format-String -Reverse -Randomize rs0Pd@ws -------------------------- EXAMPLE 3 -------------------------- PS C:\> $env:computername | Format-String -Case Lower win81-ent-01 -------------------------- EXAMPLE 4 -------------------------- PS C:\> Format-String "p*wer2she!!" -Case Alternate P*WeR2ShE!! -------------------------- EXAMPLE 5 -------------------------- PS C:\> Format-String "alphabet" -Randomize -Replace @{a="@";e=3} ` -Case Alternate 3bPl@tH@ -------------------------- EXAMPLE 6 -------------------------- PS C:\> "pOWERSHELL" | Format-String -Case Toggle Powershell Online Version: http://bit.ly/31UsW0W Format-Value Format-Percent Format-Value Format Value Format a numeric value. This command will format a given numeric value. By default, it will treat the number as an integer. Or you can specify a certain number of decimal places. The command will also allow you to format the value in KB, MB, etc. You can let the command auto-detect the value and divide with an appropriate value. Format-Value Unit The unit of measurement for your value. Valid choices are "KB","MB","GB","TB", and "PB". If you don't specify a unit, the value will remain as is, although you can still specify the number of decimal places. String String None InputObject Object Object None Decimal The number of decimal places to return between 0 and 15. Int32 Int32 0 Format-Value InputObject Object Object None Decimal The number of decimal places to return between 0 and 15. Int32 Int32 0 AsNumber Format the numeric value as a number using detected cultural settings for a separator like a comma. If the incoming value contains decimal points, by default they will be removed unless you use -Decimal. The output will be a string. SwitchParameter False Format-Value InputObject Object Object None Decimal The number of decimal places to return between 0 and 15. Int32 Int32 0 Autodetect Attempt to autodetect and format the value. SwitchParameter False Format-Value InputObject Object Object None AsCurrency Format the numeric value as currency using detected cultural settings. The output will be a string. SwitchParameter False InputObject Object Object None Unit The unit of measurement for your value. Valid choices are "KB","MB","GB","TB", and "PB". If you don't specify a unit, the value will remain as is, although you can still specify the number of decimal places. String String None Decimal The number of decimal places to return between 0 and 15. Int32 Int32 0 Autodetect Attempt to autodetect and format the value. SwitchParameter SwitchParameter False AsCurrency Format the numeric value as currency using detected cultural settings. The output will be a string. SwitchParameter SwitchParameter False AsNumber Format the numeric value as a number using detected cultural settings for a separator like a comma. If the incoming value contains decimal points, by default they will be removed unless you use -Decimal. The output will be a string. SwitchParameter SwitchParameter False System.Object System.Object Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-CimInstance -class win32_logicaldisk -filter "DriveType=3" | Select-Object DeviceID, @{Name="SizeGB";Expression={$_.size | Format-Value -unit GB}}, @{Name="FreeGB";Expression={$_.freespace | Format-Value -unit GB -decimal 2}} DeviceID SizeGB FreeGB -------- ------ ------ C: 200 124.97 D: 437 29.01 E: 25 9.67 -------------------------- Example 2 -------------------------- PS C:\> (Get-Process chrome | measure ws -sum ).sum | Format-Value -Autodetect -verbose -Decimal 4 VERBOSE: Starting: Format-Value VERBOSE: Status: Using parameter set Auto VERBOSE: Status: Formatting 965332992 VERBOSE: Status: Using Autodetect VERBOSE: ..as MB VERBOSE: Status: Reformatting 920.61328125 VERBOSE: ..to 4 decimal places 920.6133 VERBOSE: Ending: Format-Value -------------------------- Example 3 -------------------------- PS C:\> 3456.5689 | Format-Value -AsCurrency $3,456.57 Format a value as currency. -------------------------- Example 4 -------------------------- PS C:\> 1234567.8973 | Format-Value -AsNumber -Decimal 2 1,234,567.90 Format the value as a number to 2 decimal points. Online Version: http://bit.ly/31PAuBP Format-String Format-Percent Get-CommandSyntax Get CommandSyntax Get provider-specific command syntax. Some PowerShell commands are provider aware and may have special syntax or parameters depending on what PSDrive you are using when you run the command. In Windows PowerShell, the help system could show you syntax based on a given path. However, this no longer appears to work. This command is intended as an alternative. Specify a cmdlet or function name, and the output will display the syntax detected when using different providers. Dynamic parameters will be highlighted with an ANSI-escape sequence. Get-CommandSyntax Name Enter the name of a PowerShell cmdlet or function. Ideally, it has been loaded into the current PowerShell session. String String None Name Enter the name of a PowerShell cmdlet or function. Ideally, it has been loaded into the current PowerShell session. String String None None System.String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-CommandSyntax -Name Get-Item Registry Get-Item [-Path] <string[]> [-Filter <string>] [-Include <string[]>] [-Exclude <string[]>] [-Force] [-Credential <pscredential>] [<CommonParameters>] Get-Item -LiteralPath <string[]> [-Filter <string>] [-Include <string[]>] [-Exclude <string[]>] [-Force] [-Credential <pscredential>] [<CommonParameters>] Alias Get-Item [-Path] <string[]> [-Filter <string>] [-Include <string[]>] [-Exclude <string[]>] [-Force] [-Credential <pscredential>] [<CommonParameters>] Get-Item -LiteralPath <string[]> [-Filter <string>] [-Include <string[]>] [-Exclude <string[]>] [-Force] [-Credential <pscredential>] [<CommonParameters>] ... The output will show each PowerShell Provider and the corresponding command syntax. Dynamic parameters will be highlighted by color. Online Version: https://bit.ly/2H0mgti Get-Help Get-Command Get-DirectoryInfo Get DirectoryInfo Get directory information. This command is designed to provide quick access to top-level directory information. The default behavior is to show the total number of files in the immediate directory. Although the command will also capture the total file size in the immediate directory. You can use the Depth parameter to recurse through a specified number of levels. The command output will use a wide format by default. However, other wide views are available. See Examples. Get-DirectoryInfo Path Specify the top-level path. String String None Depth The Depth parameter determines the number of subdirectories to recursively query. Int32 Int32 None Depth The Depth parameter determines the number of subdirectories to recursively query. Int32 Int32 None Path Specify the top-level path. String String None None DirectoryStat Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-DirectoryInfo Path: C:\ gemfonts [15] PerfLogs [0] Pluralsight [17] Presentations [1] Program Files [0] Program Files (x86) [0] Ruby27-x64 [3] Scripts [3652] Thunderbird [0] Training [3] Users [0] Windows [38] Windows.old [0] Windows10Upgrade [23] work [13] The default output will use ANSI escape sequences. -------------------------- Example 2 -------------------------- PS C:\> Get-DirectoryInfo -Path D:\ | Format-Wide -View sizemb Path: D:\ autolab [0MB] backtemp [0MB] Backup [0.01MB] Backups [140.49MB] bovine320 [0MB] Databases [0MB] Exports [0MB] iso [16137.65MB] JDHIT [35.58MB] Logitech [0MB] OneDrive [0MB] rip [60.99MB] temp [10.67MB] video [83.56MB] VMDisks [68053MB] VMs [0MB] Using one of the alternate Format-Wide views. Other views are size and sizekb. -------------------------- Example 3 -------------------------- PS C:\> Get-DirectoryInfo D:\Autolab\ -Depth 2 | Format-Table -GroupBy parent -Property Name,File* -wrap Parent: D:\Autolab Name FileCount FileSize ---- --------- -------- Configurations 0 0 Hotfixes 0 0 ISOs 6 16838768742 MasterVirtualHardDisks 3 22326280192 Resources 0 0 VMVirtualHardDisks 0 0 Parent: D:\Autolab\Configurations Name FileCount FileSize ---- --------- -------- Implement-Windows-Server-DHCP-2016 7 65126 Jason-DSC-Env 7 66933 microsoft-powershell-implementing-jea 7 65462 MultiRole 7 65820 MultiRole-Server-2016 7 62063 PowerShellLab 7 83541 SingleServer 4 15784 SingleServer2012R2 4 15937 SingleServer2012R2-GUI 4 16005 SingleServer-GUI-2016 4 16397 SingleServer-GUI-2019 4 15845 Windows10 4 20695 Parent: D:\Autolab\Configurations\PowerShellLab Name FileCount FileSize ---- --------- -------- PostSetup 5 15275 Here's an example using the DirectoryStat object with different formatting. Online Version: https://bit.ly/2GU4iIK Get-ChildItem Get-FileExtensionInfo Get FileExtensionInfo Get a report of files based on their extension. This command will search a given directory and produce a report of all files based on their file extension. This command is only available in PowerShell 7. Get-FileExtensionInfo Path Specify the root directory path to search String String None Hidden Include files in hidden folders SwitchParameter False IncludeFiles Add the corresponding collection of files. You can access these items by the Files property. SwitchParameter False Recurse Recurse through all folders. SwitchParameter False Hidden Include files in hidden folders SwitchParameter SwitchParameter False IncludeFiles Add the corresponding collection of files. You can access these items by the Files property. SwitchParameter SwitchParameter False Path Specify the root directory path to search String String None Recurse Recurse through all folders. SwitchParameter SwitchParameter False None FileExtensionInfo Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-FileExtensionInfo c:\work Path: C:\work [THINKP1] Extension Count TotalSize Smallest Average Largest --------- ----- --------- -------- ------- ------- 1 0 0 0 0 .bat 1 122 122 122 122 .bmp 2 14113 4509 7056.5 9604 .csv 7 188085 107 26869.29 129351 .db 3 18432 6144 6144 6144 .gif 1 7110 7110 7110 7110 .htm 1 2586 2586 2586 2586 .html 8 580178 1060 72522.25 238054 .jdh 1 92 92 92 92 .jpb 1 9604 9604 9604 9604 .jpg 2 23827 9604 11913.5 14223 .json 8 366166 546 45770.75 310252 .log 1 6323 6323 6323 6323 .md 2 4031 389 2015.5 3642 .pdf 1 80704 80704 80704 80704 .png 4 47598 1071 11899.5 22700 .ps1 5 2713 64 542.6 1530 .ps1xml 2 5765 2794 2882.5 2971 .psd1 1 7696 7696 7696 7696 .reg 1 8802 8802 8802 8802 .txt 27 332297 7 12307.3 72047 .xml 10 67920544 1584 6792054.4 58504746 .zip 1 13493443 13493443 13493443 13493443 The extension with the largest total size will be highlighted in color. Online Version: https://bit.ly/3f50Wjs Get-FolderSizeInfo Get-FileItem Get FileItem A PowerShell version of the Where CLI command. This is an enhanced, PowerShell version of the WHERE command from the traditional CLI which will find files in %PATH% that match a particular pattern. Get-FileItem Pattern The name of the file to find. Separate multiple entries with a comma. Wildcards are allowed. You can also specify a regular expression pattern by including the -REGEX parameter. String[] String[] None Regex Indicates that the pattern is a regular expression. SwitchParameter False Path The folders to search other than %PATH%. String[] String[] None Recurse Used with -Path to indicate a recursive search. SwitchParameter False Full Write the full file object to the pipeline. The default is just the full name. SwitchParameter False Quiet Returns True if a match is made. This parameter will override -Full. SwitchParameter False First Stop searching after the pattern is found. Don't search any more paths. SwitchParameter False Pattern The name of the file to find. Separate multiple entries with a comma. Wildcards are allowed. You can also specify a regular expression pattern by including the -REGEX parameter. String[] String[] None Regex Indicates that the pattern is a regular expression. SwitchParameter SwitchParameter False Path The folders to search other than %PATH%. String[] String[] None Recurse Used with -Path to indicate a recursive search. SwitchParameter SwitchParameter False Full Write the full file object to the pipeline. The default is just the full name. SwitchParameter SwitchParameter False Quiet Returns True if a match is made. This parameter will override -Full. SwitchParameter SwitchParameter False First Stop searching after the pattern is found. Don't search any more paths. SwitchParameter SwitchParameter False String String Boolean System.IO.FileInfo Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Get-Fileitem notepad.exe C:\Windows\system32\notepad.exe C:\Windows\notepad.exe Find notepad.exe in %PATH% and return the full file name. This is the default behavior. -------------------------- EXAMPLE 2 -------------------------- PS C:\> PSWhere foo.exe -quiet False Search for foo.exe and return $True if found. This command is using the PSWhere alias. -------------------------- EXAMPLE 3 -------------------------- PS C:\> Get-FileItem "^\d+\S+\.txt" -Regex -path c:\scripts -full Directory: C:\scripts Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 12/5/2007 2:19 PM 30146 1000FemaleNames.txt -a--- 12/5/2007 2:19 PM 29618 1000MaleNames.txt -a--- 6/2/2010 11:02 AM 31206 1000names.txt -a--- 6/3/2010 8:52 AM 3154 100names.txt -a--- 4/13/2012 10:27 AM 3781 13ScriptBlocks-v2.txt -a--- 8/13/2010 10:41 AM 3958 13ScriptBlocks.txt -a--- 2/7/2011 1:37 PM 78542 2500names.txt -a--- 2/8/2011 9:43 AM 157396 5000names.txt Find all TXT files in C:\Scripts that start with a number and display full file information. Online Version: http://bit.ly/31VAIHR Get-ChildItem Where.exe Get-FolderSizeInfo Get FolderSizeInfo Get folder size information. This command is an alternative to discovering the size of a folder, or at least an easier method. Use the -Hidden parameter to include hidden files in the output. The measurement will include all files in all sub-folders. Note that this command has been optimized for performance, but if you have a lot of files to count that will take time, especially when using Windows PowerShell. When querying system folders like C:\Windows on a Windows PowerShell platform, you might get better results including hidden files. Due to the nature of the .NET Framework changes, you might see different results for the same folder when run in PowerShell 7 compared to Windows PowerShell 5.1. Get-FolderSizeInfo Path Enter a file system path like C:\Scripts. String[] String[] None Hidden Include hidden directories. SwitchParameter False Hidden Include hidden directories. SwitchParameter SwitchParameter False Path Enter a file system path like C:\Scripts. String[] String[] None System.String[] FolderSizeInfo Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-FolderSizeInfo -Path d:\temp Computername Path TotalFiles TotalSize ------------ ---- ---------- --------- BOVINE320 D:\temp 48 121824451 -------------------------- Example 2 -------------------------- PS C:\> Get-FolderSizeInfo -Path d:\temp -hidden Computername Path TotalFiles TotalSize ------------ ---- ---------- --------- BOVINE320 D:\temp 146 125655552 Include hidden files. -------------------------- Example 3 -------------------------- PS C:\> Get-ChildItem d:\ -Directory | Get-FolderSizeInfo | Where-Object TotalSize -gt 1MB | Sort-Object TotalSize -Descending | Format-Table -View mb Computername Path TotalFiles TotalSizeMB ------------ ---- ---------- ----------- BOVINE320 D:\VMDisks 18 114873.7246 BOVINE320 D:\ISO 17 42526.8204 BOVINE320 D:\SQLServer2017Media 1 710.8545 BOVINE320 D:\officeViewers 4 158.9155 BOVINE320 D:\Temp 48 116.1809 BOVINE320 D:\Sysinternals 153 59.6169 BOVINE320 D:\blog 41 21.9948 BOVINE320 D:\BackTemp 2 21.6734 BOVINE320 D:\rip 3 11.1546 BOVINE320 D:\logs 134 3.9517 BOVINE320 D:\2016 5 1.5608 Get the top-level directories from D and pipe them to Get-FolderSizeInfo. Items with a total size of greater than 1MB are sorted on the total size and then formatted as a table using a built-in view called MB which formats the total size in MB. There are also views named KB,GB and TB to display formatted results accordingly. -------------------------- Example 4 -------------------------- PS C:\> Get-Childitem c:\work -Directory | Get-FolderSizeInfo -Hidden | Where-Object {$_.totalsize -ge 2mb} | Format-Table -view name Path: C:\work Name TotalFiles TotalKB ---- ---------- ------- A 20 5843.9951 keepass 15 5839.084 PowerShellBooks 26 4240.3779 sunday 47 24540.6523 Get all sub-folders under C:\work greater than 2MB in size and display using the Name table view. Online Version: http://bit.ly/2RCoWQ6 Test-EmptyFolder Get-ChildItem Measure-Object Get-FormatView Get FormatView Get defined format views. PowerShell's formatting system includes custom views that display objects in different ways. Unfortunately, this information is not readily available to a typical PowerShell user. Get-FormatView displays the available views for a given object type. You might get additional views when importing modules such as the PSScriptTools module. The result is there might be different views depending on if you use Format-Table, or Format-List. If you only see a single defined view, that is the default for that type of control. Get-FormatView TypeName Specify a typename such as System.Diagnostics.Process. String String * PowerShellVersion Specify the version of PowerShell this cmdlet gets for the formatting data. Enter a two-digit number separated by a period. Version Version your current PowerShell version TypeName Specify a typename such as System.Diagnostics.Process. String String * PowerShellVersion Specify the version of PowerShell this cmdlet gets for the formatting data. Enter a two-digit number separated by a period. Version Version your current PowerShell version None PSFormatView This command relies on data provided by Get-FormatData. Some object types might be stored in PowerShell in unexpected ways. This command should have an alias of gfv. Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-FormatView system.diagnostics.process Type: System.Diagnostics.Process Format Name ------ ---- Table process Table Priority Table StartTime Wide process Table WS The default view should be the first one listed for each format type. With this information, you can now run a command like `Get-Process | Format-Table -view Priority`. The WS view is added when you import the PSScriptTools module. -------------------------- Example 2 -------------------------- PS C:\> (Get-Service bits).gettype() | Get-FormatView Type: System.ServiceProcess.ServiceController Format Name ------ ---- Table service List System.ServiceProcess.ServiceController Table service Table Ansi You can pipe a type name to the command. -------------------------- Example 3 -------------------------- PS C:\> Get-FormatView | Where-Object Format -eq Table | Group-Object typename | Where-Object count -gt 1 | Select-Object Name, @{Name="Names";Expression = {$_.group.name}} Name Names ---- ----- FolderSizeInfo {default, MB, GB, KB...} gitsize {mb, default} ModuleCommand {default, verb} System.Diagnostics.Process {process, Priority, StartTime.. System.IO.DirectoryInfo {children, ansi} System.IO.FileInfo {children, ansi} System.Management.Automation.AliasInfo {CommandInfo, AliasInfo, opti.. System.Management.Automation.ApplicationInfo {CommandInfo, ApplicationInfo} System.Management.Automation.ExternalScriptInfo {CommandInfo, ExternalScriptI.. System.Management.Automation.FilterInfo {CommandInfo, FilterInfo} System.Management.Automation.FunctionInfo {CommandInfo, FunctionInfo} System.Management.Automation.ScriptInfo {CommandInfo, ScriptInfo} System.ServiceProcess.ServiceController {service, service, Ansi} This example expression is getting all Table format views for types that have more than 1 defined. If a type only has a single view, that is the default which you are seeing already. The output you see here shows additional table views for different object types. Online Version: https://bit.ly/3dw2Nwo Get-FormatData Get-Member New-PSFormatXML Get-GitSize Get GitSize Get the size of .git folder. When using git, it creates a hidden folder for change tracking. Because the file is hidden it is easy to overlook how large it might become. The command uses a formatting file to display a default view. There is an additional table view called MB that you can use. Get-GitSize Path The path to the parent folder, not the .git folder. String String current location Path The path to the parent folder, not the .git folder. String String current location System.String gitSize Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ This is a variation of code posted at https://gist.github.com/jdhitsolutions/cbdc7118f24ba551a0bb325664415649 -------------------------- EXAMPLE 1 -------------------------- PS C:\Scripts\PiedPiper> Get-GitSize Path Files SizeKB ---- ----- ------ C:\scripts\PiedPiper 751 6859.9834 Get the size of the .git folder from the current path. -------------------------- EXAMPLE 2 -------------------------- PS C:\> Get-ChildItem c:\scripts -Directory | Get-GitSize | Sort-Object -property Size -descending | Select-Object -first 5 -property Computername,Name,Files,Size Computername Name Files Size ------------ ---- ----- ---- WIN10DSK2 PSAutoLab 526 193760657 WIN10DSK2 DevOps-Courses 29 53298180 WIN10DSK2 PSScriptTools 751 7024623 WIN10DSK2 PSGUI 32 6705894 WIN10DSK2 DscWorkshop 24 5590511 Get the directories under C:\Scripts that have a .git folder and sort on the Size property in descending order. Then select the first 5 directories and use the specified properties. -------------------------- EXAMPLE 3 -------------------------- PS S:\PSReleaseTools> Get-GitSize | Format-Table -view mb Path Files SizeMB ---- ----- ------ C:\scripts\PSReleaseTools 440 3.0588 Get the git folder size and format using the MB table view. Online Version: https://bit.ly/3bj81JZ Get-ChildItem Measure-Object Remove-MergedBranch Get-LastModifiedFile Get LastModifiedFile Get files based on last modified data. This command is designed to make it easier to identify last modified files. You can specify by an interval such as 3 months or 24 hours. Get-LastModifiedFile Filter Specify a file filter like *.ps1. String String None Path Specify the folder to search. String String current location Interval Specify the search interval based on the last write time. Hours Minutes Days Months Years String String Hours IntervalCount Specify the number of intervals. Int32 Int32 24 Recurse Recurse from the specified path. SwitchParameter False Filter Specify a file filter like *.ps1. String String None Interval Specify the search interval based on the last write time. String String Hours IntervalCount Specify the number of intervals. Int32 Int32 24 Path Specify the folder to search. String String current location Recurse Recurse from the specified path. SwitchParameter SwitchParameter False None System.IO.FileInfo This command was first described at https://jdhitsolutions.com/blog/powershell/8622/finding-modified-files-with-powershell/ Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-LastModifiedFile -Path c:\work Directory: C:\work Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 11/30/2021 1:52 PM 2010 a.txt -a--- 11/30/2021 1:52 PM 5640 b.txt The default behavior is to find all files modified in the last 24 hours. -------------------------- Example 2 -------------------------- PS C:\> Get-LastModifiedFile -Path c:\scripts -Filter *.ps1 -Interval Months -IntervalCount 6 Directory: C:\Scripts Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 11/19/2021 2:36 PM 1434 calendar-prompt.ps1 -a--- 10/11/2021 11:26 AM 1376 ChangeOSCaption.ps1 -a--- 8/27/2021 8:06 AM 2754 Check-ModuleUpdate.ps1 -a--- 9/17/2021 9:23 AM 1822 CleanJobs.ps1 -a--- 7/14/2021 10:36 AM 436 Clear-Win11Recommended.ps1 -a--- 10/18/2021 5:24 PM 5893 ComingSoon.ps1 -a--- 10/25/2021 5:23 PM 4966 Configure-PSVirtualMachine.ps1 ... Get all .ps1 files in C:\Scripts that have been modified in the last 6 months. Online Version: https://bit.ly/3FbzOu3 Get-ChildItem Get-DirectoryInfo Get-FolderSizeInfo Get-ModuleCommand Get ModuleCommand Get a summary of module commands. This is an alternative to Get-Command to make it easier to see at a glance what commands are contained within a module and what they can do. By default, Get-ModuleCommand looks for loaded modules. Use -ListAvailable to see commands in the module but not currently loaded. Note that if the help file is malformed or missing, you might get oddly formatted results. Get-ModuleCommand FullyQualifiedName Specifies names of modules in the form of ModuleSpecification objects. The FullyQualifiedName parameter accepts a module name that is specified in the following formats: @{ModuleName = "modulename"; ModuleVersion = "version_number"} @{ModuleName = "modulename"; ModuleVersion = "version_number"; Guid = "GUID"} ModuleName and ModuleVersion are required, but Guid is optional. You cannot specify the FullyQualifiedName parameter in the same command as a Name parameter. ModuleSpecification ModuleSpecification None ListAvailable Indicates that this cmdlet gets all installed modules. Get-Module finds modules in paths listed in the PSModulePath environment variable. Without this parameter, Get-ModuleCommand gets only the modules that are both listed in the PSModulePath environment variable, and that are loaded in the current session. ListAvailable does not return information about modules that are not found in the PSModulePath environment variable, even if those modules are loaded in the current session. SwitchParameter False Get-ModuleCommand Name The name of an installed module. String String None ListAvailable Indicates that this cmdlet gets all installed modules. Get-Module finds modules in paths listed in the PSModulePath environment variable. Without this parameter, Get-ModuleCommand gets only the modules that are both listed in the PSModulePath environment variable, and that are loaded in the current session. ListAvailable does not return information about modules that are not found in the PSModulePath environment variable, even if those modules are loaded in the current session. SwitchParameter False FullyQualifiedName Specifies names of modules in the form of ModuleSpecification objects. The FullyQualifiedName parameter accepts a module name that is specified in the following formats: @{ModuleName = "modulename"; ModuleVersion = "version_number"} @{ModuleName = "modulename"; ModuleVersion = "version_number"; Guid = "GUID"} ModuleName and ModuleVersion are required, but Guid is optional. You cannot specify the FullyQualifiedName parameter in the same command as a Name parameter. ModuleSpecification ModuleSpecification None ListAvailable Indicates that this cmdlet gets all installed modules. Get-Module finds modules in paths listed in the PSModulePath environment variable. Without this parameter, Get-ModuleCommand gets only the modules that are both listed in the PSModulePath environment variable, and that are loaded in the current session. ListAvailable does not return information about modules that are not found in the PSModulePath environment variable, even if those modules are loaded in the current session. SwitchParameter SwitchParameter False Name The name of an installed module. String String None None ModuleCommand Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-ModuleCommand PSCalendar ModuleName: PSCalendar Name Alias Synopsis ---- ----- -------- Get-Calendar cal Displays a visual representation of a calendar. Show-Calendar scal Display a colorized calendar month in the console. Show-GuiCalendar gcal Display a WPF-based calendar Get module commands using the default formatted view. You can install this module from the PowerShell Gallery. -------------------------- Example 2 -------------------------- PS C:\> Get-ModuleCommand smbshare -ListAvailable | Format-List ModuleName : SmbShare Name : Block-SmbShareAccess Alias : blsmba Synopsis : Adds a deny ACE for a trustee to the security descriptor of the SMB share. ModuleName : SmbShare Name : Close-SmbOpenFile Alias : cssmbo Synopsis : Closes a file that is open by one of the clients of the SMB server. ModuleName : SmbShare Name : Close-SmbSession Alias : cssmbse Synopsis : Ends forcibly the SMB session. ... Using the default list view. -------------------------- Example 3 -------------------------- PS C:\> Get-ModuleCommand PSScriptTools | Format-Table -view verb Verb: Add Name Alias Type Synopsis ---- ----- ---- -------- Add-Border Function Create a text border around a string. Verb: Compare Name Alias Type Synopsis ---- ----- ---- -------- Compare-Module cmo Function Compare PowerShell module versions. ... Display commands using a custom table view called 'Verb'. -------------------------- Example 4 -------------------------- PS C:\ Get-ModuleCommand PSScriptTools | Format-Table -view version ModuleName: PSScriptTools [v2.41.0] Name Alias Compatible PSVersion ---- ----- ---------- --------- Add-Border ab {Desktop, Core} 5.1 Compare-Module cmo {Desktop, Core} 5.1 Compare-Script csc {Desktop, Core} 5.1 Convert-CommandToHashtable {Desktop, Core} 5.1 ... Using the custom table view 'version'. Online Version: https://bit.ly/2Kfjm1Q Get-Command Get-Module Get-MyAlias Get MyAlias Get non-default aliases defined in the current session. Often you might define aliases for functions and scripts you use often. It may difficult sometimes to remember them all or to find them in the default Get-Alias output. This command will list all currently defined aliases that are not part of the initial PowerShell state. The PSScriptTools module also includes a custom formatting file for alias objects which you can use with Get-Alias or Get-MyAlias. See examples. Get-MyAlias NoModule Only show aliases that DO NOT belong to a module. SwitchParameter False NoModule Only show aliases that DO NOT belong to a module. SwitchParameter SwitchParameter False None System.Management.Automation.AliasInfo Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-MyAlias CommandType Name Version Source ----------- ---- ------- ------ Alias abt -> Get-AboutInfo Alias bv -> Brave Alias cal -> Get-Calendar 1.11.0 PSCalendar Alias cc -> Copy-Command 2.27.0 PSScriptTools Alias cfn -> New-CustomFileName 2.27.0 PSScriptTools Alias CFS -> ConvertFrom-String 3.1.0.0 Microsoft.Po... Alias cft -> ConvertFrom-Text 2.27.0 PSScriptTools Alias chc -> Convert-HashTableToCode 2.27.0 PSScriptTools Alias che -> Copy-HelpExample 2.27.0 PSScriptTools Alias cl -> Create-List Alias clr -> Convert-EventLogRecord 2.27.0 PSScriptTools Alias clt -> ConvertTo-LocalTime 2.27.0 PSScriptTools Alias cmo -> Compare-Module 2.27.0 PSScriptTools ... Get all aliases that aren't par of the initial session state. This will include aliases defined in any modules you have loaded. -------------------------- Example 2 -------------------------- PS C:\> Get-MyAlias -NoModule CommandType Name Version Source ----------- ---- ------- ------ Alias abt -> Get-AboutInfo Alias bv -> Brave Alias cl -> Create-List Get defined aliases that don't belong to a module. These should be aliases you have defined in stand-alone scripts or your profile. -------------------------- Example 3 -------------------------- PS C:\> Get-MyAlias -NoModule | Format-Table -View options Name Definition Options ModuleName Version ---- ---------- ------- ---------- ------- abt Get-AboutInfo None bv Brave None cl Create-List None np notepad ReadOnly Get your aliases and pipe to format table using a custom view defined by the PSScriptTools module. Online Version: https://github.com/jdhitsolutions/PSScriptTools/blob/master/docs/Get-MyAlias.md Get-Alias Get-MyCounter Get MyCounter Get performance counter data. Get-MyCounter is an enhanced version of Get-Counter which is available on Windows platforms to retrieve performance counter data. One of the challenges with Get-Counter is how it formats results. Get-MyCounter takes the same information and writes a custom object to the pipeline that is easier to work with. You can pipe counters from Get-Counter to this command. The custom object has an associated formatting file with custom views. See examples. Get-MyCounter Counter Gets data from the specified performance counters. Enter one or more counter paths. Wildcards are permitted only in the Instance value. You can also pipe counter path strings to Get-MyCounter. Each counter path has the following format: \\ComputerName\CounterSet(Instance)\CounterName For example: \\Server01\Processor(2)\% User Time The ComputerName element is optional. If you omit it, Get-MyCounter uses the value of the ComputerName parameter. String[] String[] None ComputerName The name of a remote computer. Querying a remote computer does not use PowerShell remoting and requires administrator-level permissions. Typically, the RemoteRegistry service must also be running. String[] String[] localhost Continuous Gets samples continuously until you press CTRL+C. By default, Get-MyCounter gets only one counter sample. You can use the SampleInterval parameter to set the interval for continuous sampling. SwitchParameter False MaxSamples Specifies the number of samples to get from each counter. The default is 1 sample. To get samples continuously (no maximum sample size), use the Continuous parameter. Int64 Int64 None SampleInterval Specifies the time between samples in seconds. The minimum value and the default value are 1 second Int32 Int32 None ComputerName The name of a remote computer. Querying a remote computer does not use PowerShell remoting and requires administrator-level permissions. Typically, the RemoteRegistry service must also be running. String[] String[] localhost Continuous Gets samples continuously until you press CTRL+C. By default, Get-MyCounter gets only one counter sample. You can use the SampleInterval parameter to set the interval for continuous sampling. SwitchParameter SwitchParameter False Counter Gets data from the specified performance counters. Enter one or more counter paths. Wildcards are permitted only in the Instance value. You can also pipe counter path strings to Get-MyCounter. Each counter path has the following format: \\ComputerName\CounterSet(Instance)\CounterName For example: \\Server01\Processor(2)\% User Time The ComputerName element is optional. If you omit it, Get-MyCounter uses the value of the ComputerName parameter. String[] String[] None MaxSamples Specifies the number of samples to get from each counter. The default is 1 sample. To get samples continuously (no maximum sample size), use the Continuous parameter. Int64 Int64 None SampleInterval Specifies the time between samples in seconds. The minimum value and the default value are 1 second Int32 Int32 None System.String[] myCounter Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-Counter -list "system" | Get-MyCounter Computername: SERVER18 Timestamp Category Counter Value --------- -------- ------- ----- 11/4/2020 10:48:47 AM system file read operations/sec 203.3096 11/4/2020 10:48:47 AM system file write operations/sec 252.6566 11/4/2020 10:48:47 AM system file control operations/sec 197.3879 11/4/2020 10:48:47 AM system file read bytes/sec 206336.5281 11/4/2020 10:48:47 AM system file write bytes/sec 56409.5271 11/4/2020 10:48:47 AM system file control bytes/sec 10452.6787 11/4/2020 10:48:47 AM system context switches/sec 6068.6924 11/4/2020 10:48:47 AM system system calls/sec 17854.7266 11/4/2020 10:48:47 AM system file data operations/sec 455.9662 11/4/2020 10:48:47 AM system system up time 73056.4005 11/4/2020 10:48:47 AM system processor queue length 0 11/4/2020 10:48:47 AM system processes 301 11/4/2020 10:48:47 AM system threads 4502 11/4/2020 10:48:47 AM system alignment fixups/sec 0 11/4/2020 10:48:47 AM system exception dispatches/sec 6.9086 11/4/2020 10:48:47 AM system floating emulations/sec 0 11/4/2020 10:48:47 AM system % registry quota in use 4.0327 Get all of the System counters with Get-Counter and pipe them to Get-MyCounter. -------------------------- Example 2 -------------------------- PS C:\> Get-MyCounter -computername server18 | Format-table -view category Category: network interface(intel[r] ethernet connection [11] i219-lm) Computername Timestamp Counter Value ------------ --------- ------- ----- SERVER18 11/4/2020 11:20:09 AM bytes total/sec 2662.0477 Category: network interface(intel[r] wi-fi 6 ax201 160mhz) Computername Timestamp Counter Value ------------ --------- ------- ----- SERVER18 11/4/2020 11:20:09 AM bytes total/sec 0 Category: processor(_total) Computername Timestamp Counter Value ------------ --------- ------- ----- SERVER18 11/4/2020 11:20:09 AM % processor time 1.4158 Category: memory Computername Timestamp Counter Value ------------ --------- ------- ----- SERVER18 11/4/2020 11:20:09 AM % committed bytes in use 40.5214 SERVER18 11/4/2020 11:20:09 AM cache faults/sec 0 Category: physicaldisk(_total) Computername Timestamp Counter Value ------------ --------- ------- ----- SERVER18 11/4/2020 11:20:09 AM % disk time 0.0217 SERVER18 11/4/2020 11:20:09 AM current disk queue length 0 Get the default counter set and pipe to Get-MyCounter to get values for the local host. -------------------------- Example 3 -------------------------- PS C:\> $c = (Get-Counter -list logicaldisk).PathsWithinstances | Where-Object {$_ -match "\(c:\)\\%"} PS C:\> Get-MyCounter -Counter $c -ComputerName SERVER18,SERVER2 | Format-Table -view category Category: logicaldisk(c:) Computername Timestamp Counter Value ------------ --------- ------- ----- SERVER18 11/4/2020 10:50:03 AM % free space 48.3822 SERVER2 11/4/2020 10:50:04 AM % free space 54.5916 SERVER18 11/4/2020 10:50:03 AM % disk time 1.4669 SERVER2 11/4/2020 10:50:04 AM % disk time 5.3787 SERVER18 11/4/2020 10:50:03 AM % disk read time 0.8467 SERVER2 11/4/2020 10:50:04 AM % disk read time 0 SERVER18 11/4/2020 10:50:03 AM % disk write time 0.6203 SERVER2 11/4/2020 10:50:04 AM % disk write time 5.3787 SERVER18 11/4/2020 10:50:03 AM % idle time 98.5846 SERVER2 11/4/2020 10:50:04 AM % idle time 93.3567 PS C:\> Get-MyCounter -Counter $c -ComputerName SERVER18,SERVER2 | Sort-Object Computername Computername: SERVER18 Timestamp Category Counter Value --------- -------- ------- ----- 11/4/2020 10:50:35 AM logicaldisk(c:) % free space 48.3822 11/4/2020 10:50:35 AM logicaldisk(c:) % disk time 0.0263 11/4/2020 10:50:35 AM logicaldisk(c:) % disk read time 0 11/4/2020 10:50:35 AM logicaldisk(c:) % disk write time 0.0263 11/4/2020 10:50:35 AM logicaldisk(c:) % idle time 99.9435 Computername: SERVER2 Timestamp Category Counter Value --------- -------- ------- ----- 11/4/2020 10:50:37 AM logicaldisk(c:) % free space 54.5916 11/4/2020 10:50:37 AM logicaldisk(c:) % disk time 0 11/4/2020 10:50:37 AM logicaldisk(c:) % disk read time 0 11/4/2020 10:50:37 AM logicaldisk(c:) % disk write time 0 11/4/2020 10:50:37 AM logicaldisk(c:) % idle time 99.0114 The first command gets a collection of logical disk counters for drive C. The second command gets performance counter data for two remote computers and formats the results using a custom view. The last command repeats the process but sorts the result by the computer name. -------------------------- Example 4 -------------------------- PS C:\> $p = Get-MyCounter -Counter "\IPv4\Datagrams/sec" -ComputerName SERVER2 -SampleInterval 5 -MaxSamples 30 This command will get the specified counter value every 5 seconds for a total of 30 samples. Online Version: https://bit.ly/2JS5NZ1 Get-Counter Get-MyTimeInfo Get MyTimeInfo Display time settings for a collection of locations. This command is designed to present a console-based version of a world clock. You provide a hashtable of locations and their respective time zones and the command will write a custom object to the pipeline. Be aware that TimeZone names may vary depending on the .NET Framework version. You may need to enumerate using a command like [System.TimeZoneInfo]::GetSystemTimeZones().ID or the Get-TZList command. A Note on Formatting: Normally, a PowerShell command should write an object to the pipeline and then you could use Format-Table or Format-List as you wanted. Those commands will continue to work. However, given the way this command writes to the pipeline, that is with dynamically generated properties, it is difficult to create the usual format ps1xml file. To provide some nicer formatting this command has optional parameters to help your format the output. Note that even though it may look like a table, the output object will be a string. This command was added in v2.3.0. Get-MyTimeInfo Locations Use an ordered hashtable of location names and timezones. You can find timezones with the Get-TimeZone cmdlet or through the .NET Framework with an expression like [System.TimeZoneinfo]::GetSystemTimeZones() The hashtable key should be the location or city name and the value should be the time zone ID. Be careful as it appears time zone IDs are case-sensitive. The default value is: [ordered]@{ Singapore = "Singapore Standard Time"; Seattle = "Pacific Standard Time"; Stockholm = "Central Europe Standard Time"; } You might want to define a default value in $PSDefaultParameterValues with your own defaults. It is recommended you limit this hashtable to no more than 5 locations, especially if you want to format the results as a table. OrderedDictionary OrderedDictionary see note HomeTimeZone Specify the timezone ID of your home location. You might want to set this as a PSDefaultParameterValue String String Eastern Standard Time DateTime Specify the datetime value to use. The default is now. DateTime DateTime $(Get-Date) AsTable Display the results as a formatted table. This parameter has an alias of ft. SwitchParameter False AsList Display the results as a formatted list. This parameter has an alias of fl. SwitchParameter False Locations Use an ordered hashtable of location names and timezones. You can find timezones with the Get-TimeZone cmdlet or through the .NET Framework with an expression like [System.TimeZoneinfo]::GetSystemTimeZones() The hashtable key should be the location or city name and the value should be the time zone ID. Be careful as it appears time zone IDs are case-sensitive. The default value is: [ordered]@{ Singapore = "Singapore Standard Time"; Seattle = "Pacific Standard Time"; Stockholm = "Central Europe Standard Time"; } You might want to define a default value in $PSDefaultParameterValues with your own defaults. It is recommended you limit this hashtable to no more than 5 locations, especially if you want to format the results as a table. OrderedDictionary OrderedDictionary see note HomeTimeZone Specify the timezone ID of your home location. You might want to set this as a PSDefaultParameterValue String String Eastern Standard Time DateTime Specify the datetime value to use. The default is now. DateTime DateTime $(Get-Date) AsTable Display the results as a formatted table. This parameter has an alias of ft. SwitchParameter SwitchParameter False AsList Display the results as a formatted list. This parameter has an alias of fl. SwitchParameter SwitchParameter False Datetime myTimeInfo System.String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- P{S C:\>Get-MyTimeInfo Now : 3/4/2020 1:28:43 PM Home : 3/4/2020 1:28:43 PM UTC : 3/4/2020 6:28:43 PM Singapore : 3/5/2020 2:28:43 AM Seattle : 3/4/2020 10:28:43 AM Stockholm : 3/4/2020 7:28:43 PM IsDaylightSavings : False The default output is a custom object with each timezone as a property. -------------------------- EXAMPLE 2 -------------------------- Get-MyTimeInfo -AsTable Now: 03/04/2020 13:28:11 UTC: 03/04/2020 18:28:11 Home Singapore Seattle Stockholm IsDaylightSavings ---- --------- ------- --------- ----------------- 3/4/2020 1:28:11 PM 3/5/2020 2:28:11 AM 3/4/2020 10:28:11 AM 3/4/2020 7:28:11 PM False Display current time information as a table. The output is a string. -------------------------- EXAMPLE 3 -------------------------- PS C:\> Get-MyTimeInfo -AsList Now: 03/04/2020 13:27:03 UTC: 03/04/2020 18:27:03 Home : 3/4/2020 1:27:03 PM Singapore : 3/5/2020 2:27:03 AM Seattle : 3/4/2020 10:27:03 AM Stockholm : 3/4/2020 7:27:03 PM IsDaylightSavings : False Get current time info formatted as a list. -------------------------- EXAMPLE 4 -------------------------- PS C:\> $loc = [ordered]@{"Hong Kong"="China Standard Time";Honolulu="Hawaiian Standard Time";Mumbai = "India Standard Time"} PS C:\> Get-MyTimeInfo -Locations $loc -ft Now: 03/04/2020 13:26:23 UTC: 03/04/2020 18:26:23 Home Hong Kong Honolulu Mumbai IsDaylightSavings ---- --------- -------- ------ ----------------- 3/4/2020 1:26:23 PM 3/5/2020 2:26:23 AM 3/4/2020 8:26:23 AM 3/4/2020 11:56:23 PM False Using a custom location hashtable, get time zone information formatted as a table. This example is using the -ft alias for the AsTable parameter. Even though this is formatted as a table the actual output is a string. -------------------------- EXAMPLE 5 -------------------------- PS C:\> Get-MyTimeInfo -Locations ([ordered]@{Seattle="Pacific Standard time";"New Zealand" = "New Zealand Standard Time"}) -HomeTimeZone "central standard time" | Select Now,Home,Seattle,'New Zealand' Now Home Seattle New Zealand --- ---- ------- ----------- 3/4/2020 1:18:36 PM 3/4/2020 12:18:36 PM 3/4/2020 10:18:36 AM 3/5/2020 7:18:36 AM This is a handy command when traveling and your laptop is using a locally derived time and you want to see the time in other locations. It is recommended that you set a PSDefaultParameter value for the HomeTimeZone parameter in your PowerShell profile. Online Version: http://bit.ly/31RGxG0 Get-TimeZone Get-MyVariable Get MyVariable Get all user-defined variables. This function will return all variables not defined by PowerShell or by this function itself. The default is to return all user-created variables from the global scope but you can also specify a scope such as script, local, or a number 0 through 5. The command will also display the value type for each variable. If you want to suppress this output use the -NoTypeInformation switch. Get-MyVariable Scope The scope to query. The default is the Global scope but you can also specify Local, Script, Private or a number between 0 and 3 where 0 is the current scope, 1 is the parent scope, 2 is the grandparent scope, and so on. String String Global NoTypeInformation If specified, suppress the type information for each variable value. SwitchParameter False Scope The scope to query. The default is the Global scope but you can also specify Local, Script, Private or a number between 0 and 3 where 0 is the current scope, 1 is the parent scope, 2 is the grandparent scope, and so on. String String Global NoTypeInformation If specified, suppress the type information for each variable value. SwitchParameter SwitchParameter False None System.Management.Automation.PSVariable Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ An earlier version of this function is described at http://jdhitsolutions.com/blog/2012/05/get-my-variable-revisited -------------------------- EXAMPLE 1 -------------------------- PS C:\> Get-MyVariable NName Value Type ---- ----- ---- a bits ServiceController dt 10/22/2020 10:49:38 AM DateTime foo 123 Int32 r {1, 2, 3, 4...} Object[] ... Depending on the value and how PowerShell chooses to display it, you may not see the type. -------------------------- EXAMPLE 2 -------------------------- PS C:\> Get-MyVariable | Select-Object name,type Name Type ---- ---- a ServiceController dt DateTime foo Int32 r Object[] -------------------------- EXAMPLE 3 -------------------------- PS C:\> Get-MyVariable | Export-Clixml myvar.xml PS C:\> import-clixml .\myvar.xml | ForEach-Object {set-variable -Name $_.name -Value $_.value} You can then import this XML file in another session to restore these variables. -------------------------- EXAMPLE 4 -------------------------- PS C:\> function foo { c:\scripts\Get-MyVariable2.ps1; $a=4;$b=2;$c=$a*$b; Get-MyVariable -notypeinformation -scope 1 -verbose; $c } PS C:\> foo VERBOSE: Getting system defined variables VERBOSE: Found 49 VERBOSE: Getting current variables in 1 scope VERBOSE: Found 27 VERBOSE: Filtering variables Name Value ---- ----- a 4 b 2 c 8 VERBOSE: Finished getting my variables 8 This sample function dot sources the script with this function. Within the function, Get-MyVariable is called specifying scope 1, or the parent scope. Scope 0 would be the scope of the Get-MyVariable function. Here's the result. -------------------------- EXAMPLE 5 -------------------------- PS C:\> Get-MyVariable | where {$_.type -eq "Scriptblock"} | Select-Object name,value Name Value ---- ----- bigp ps | where {$_.ws -gt 100mb} dirt Param(\[string\]$Path=$env:temp) Get-C... disk Param (\[string\]$computername=$env:co... run gsv | where {$_.status -eq "running"} up Param(\[string\]$computername=$env:com... Get all my variables that are scriptblocks. Online Version: http://bit.ly/31PAvFT Get-Variable About_Variables About_Scope Get-ParameterInfo Get ParameterInfo Retrieve command parameter information. Using Get-Command, this function will return information about parameters for any loaded cmdlet or function. The common parameters like Verbose and ErrorAction are omitted. Get-ParameterInfo returns a custom object with the most useful information an administrator might need to know. See examples. Get-ParameterInfo Command The name of a cmdlet or function. The parameter has an alias of Name. String String None Parameter {{Fill Parameter Description}} String String None Command The name of a cmdlet or function. The parameter has an alias of Name. String String None Parameter {{Fill Parameter Description}} String String None System.String PSParameterInfo Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Get-ParameterInfo Get-Service ParameterSet: Default Name : Name Aliases : ServiceName Mandatory : False IsDynamic : False Position : 0 Type : System.String[] ValueFromPipeline : True ValueFromPipelineByPropertyName : True ParameterSet: __AllParameterSets Name : ComputerName Aliases : Cn Mandatory : False IsDynamic : False Position : Named Type : System.String[] ValueFromPipeline : False ValueFromPipelineByPropertyName : True Name : DependentServices Aliases : DS Mandatory : False IsDynamic : False Position : Named Type : System.Management.Automation.SwitchParameter ValueFromPipeline : False ValueFromPipelineByPropertyName : False ... Return parameter information for Get-Service using the default list view. -------------------------- EXAMPLE 2 -------------------------- PS C:\> Get-ParameterInfo mkdir | Select-Object Name,Type,Position,parameterset Name Type Position ParameterSet ---- ---- -------- ------------ Path System.String[] 0 pathSet Path System.String[] 0 nameSet Name System.String Named nameSet Value System.Object Named __AllParameterSets Force System.Management.Automation.Switch... Named __AllParameterSets Credential System.Management.Automation.PSCred... Named __AllParameterSets UseTransaction System.Management.Automation.Switch... Named __AllParameterSets Get selected parameter information for the mkdir command. -------------------------- EXAMPLE 3 -------------------------- PS C:\> Get-ParameterInfo Test-WSMan | Sort Parameterset | Format-Table ParameterSet: __AllParameterSets Name Aliases Mandatory Position Type ---- ------- --------- -------- ---- CertificateThumbprint False Named System.String Credential cred,c False Named System.Management.Automati... ComputerName cn False 0 System.String Authentication auth,am False Named Microsoft.WSMan.Management.... ParameterSet: ComputerName Name Aliases Mandatory Position Type ---- ------- --------- -------- ---- UseSSL False Named System.Management.Automation.Swit... Port False Named System.Int32 ApplicationName False Named System.String Get all parameters from Test-WSMan and display details as a formatted table. The object type from Get-ParameterInfo has a default table view. -------------------------- Example 4 -------------------------- PS C:\> Get-ParameterInfo -Command Get-Counter -Parameter computername ParameterSet: __AllParameterSets Name : computername Aliases : Cn Mandatory : False IsDynamic : False Position : Named Type : System.String[] ValueFromPipeline : False ValueFromPipelineByPropertyName : False Get details on the Computername parameter of the Get-Counter cmdlet. Online Version: http://bit.ly/31XfFER Get-Command Get-PathVariable Get PathVariable Get information from locations in %PATH%. Use this command to test the locations specified in the %PATH% environment variable. On Windows platforms, you can distinguish between settings set per machine and those set per user. On non-Windows platforms, the scope will be Process. Get-PathVariable Scope On Windows platforms you can distinguish between Machine and User specific settings. All User Machine String String All Scope On Windows platforms you can distinguish between Machine and User specific settings. String String All None EnvPath Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-PathVariable Scope UserName Path Exists ----- -------- ---- ------ User Jeff C:\Program Files\kdiff3 True User Jeff C:\Program Files (x86)\Bitvise SSH Client True User Jeff C:\Program Files\OpenSSH True ... Machine Jeff C:\WINDOWS True Machine Jeff C:\WINDOWS\system32 True Machine Jeff C:\WINDOWS\System32\Wbem True ... -------------------------- Example 2 -------------------------- PS /home/jeff> Get-PathVariable | Where-Object {-Not $_.exists} Scope : Process Computername : Bovine320 UserName : jeff Path : /snap/bin Exists : False This example is on a Linux platform, finding locations that don't exist or can be verified. You could run the same command on Windows. Online Version: https://bit.ly/33UwYKo Get-PowerShellEngine Get PowerShellEngine Get the path to the current PowerShell engine. Use this command to find the path to the PowerShell executable, or engine that is running your current session. The default is to provide the path only. But you can also get detailed information Get-PowerShellEngine Detail Include additional information. Not all properties may have values depending on operating system and PowerShell version. SwitchParameter False Detail Include additional information. Not all properties may have values depending on operating system and PowerShell version. SwitchParameter SwitchParameter False System.String PSCustomObject Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Get-PowerShellEngine C:\WINDOWS\System32\WindowsPowerShell\v1.0\powershell.exe -------------------------- EXAMPLE 2 -------------------------- PS C:\> Get-PowerShellEngine -detail Path : C:\WINDOWS\System32\WindowsPowerShell\v1.0\powershell.exe FileVersion : 10.0.15063.0 (WinBuild.160101.0800) PSVersion : 5.1.15063.502 ProductVersion : 10.0.15063.0 Edition : Desktop Host : Visual Studio Code Host Culture : en-US Platform : This result is from running in the Visual Studio Code integrated PowerShell terminal. -------------------------- EXAMPLE 3 -------------------------- PS C:\> Get-PowerShellEngine -detail Path : C:\Program Files\PowerShell\7\pwsh.exe FileVersion : 7.1.0.0 PSVersion : 7.1.0 ProductVersion : 7.1.0 SHA: d2953dcaf8323b95371380639ced00dac4ed209f Edition : Core Host : ConsoleHost Culture : en-US Platform : Win32NT This result is from running in a PowerShell 7 session on Windows 10 Online Version: http://bit.ly/31SKmLm $PSVersionTable $Host Get-Process Get-PSAnsiFileMap Get PSAnsiFileMap Display the PSAnsiFileMap Use this command to display the PSAnsiFileMap global variable. The Ansi pattern will be shown using the pattern. Get-PSAnsiFileMap None PSAnsiFileEntry Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-PSAnsiFileMap Description Pattern ANSI ----------- ------- ---- PowerShell \.((ps(d|m)?1)|(ps1xml))$ `e[38;2;252;127;12m`e[38;2;252;127;12m Text \.((txt)|(log)|(htm(l)?))$ `e[38;2;58;120;255m`e[38;2;58;120;255m ... The output will display the ANSI sequence using the sequence itself. The escape character will be based on the version of PowerShell you are using. This example shows output from PowerShell 7. Online Version: https://bit.ly/3sKBrcR Set-PSAnsiFileMap Get-PSLocation Get PSLocation Get common location values. This command will write an object to the pipeline that displays the values of common file locations. You might find this helpful when scripting cross-platform. Get-PSLocation None PSLocation Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Get-PSLocation Temp : C:\Users\Jeff\AppData\Local\Temp\ Home : C:\Users\Jeff\Documents Desktop : C:\Users\Jeff\Desktop PowerShell : C:\Users\Jeff\Documents\WindowsPowerShell PSHome : C:\Windows\System32\WindowsPowerShell\v1.0 Results on a Windows system. -------------------------- EXAMPLE 2 -------------------------- PS C:\> Get-PSLocation Temp : /tmp/ Home : /home/jeff Desktop : PowerShell : /home/jeff/.config/powershell PSHome : /opt/microsoft/powershell/7 Results on a Linux system running PowerShell. Online Version: http://bit.ly/31SEOQY Get-Location Set-Location Get-PSProfile Get PSProfile Get PowerShell profile locations This command is designed for Windows-based systems to show all possible PowerShell profile scripts. Including those for VS Code and the PowerShell ISE. Get-PSProfile None PSProfilePath Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-PSProfile Name: PowerShell Scope Path Exists ----- ---- ------ AllUsersCurrentHost C:\Program Files\PowerShell\7\Microsoft.PowerShell_profile.ps1 False AllUsersAllHosts C:\Program Files\PowerShell\7\profile.ps1 False CurrentUserAllHosts C:\Users\Jeff\Documents\PowerShell\profile.ps1 True CurrentUserCurrentHost C:\Users\Jeff\Documents\PowerShell\Microsoft.PowerShell_profile.ps1 True Name: Windows PowerShell Scope Path Exists ----- ---- ------ AllUsersCurrentHost C:\WINDOWS\System32\WindowsPowerShell\v1.0\Microsoft.PowerShell_profile.ps1 True AllUsersAllHosts C:\WINDOWS\System32\WindowsPowerShell\v1.0\profile.ps1 True CurrentUserAllHosts C:\Users\Jeff\Documents\WindowsPowerShell\profile.ps1 True CurrentUserCurrentHost C:\Users\Jeff\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1 True Name: VSCode PowerShell Scope Path Exists ----- ---- ------ CurrentUserCurrentHost C:\Users\Jeff\Documents\PowerShell\Microsoft.VSCode_profile.ps1 True AllUsersCurrentHost C:\Program Files\PowerShell\7\Microsoft.VSCode_profile.ps1 False ... The command has a default formatted table view. -------------------------- Example 2 -------------------------- PS C:\> Get-PSProfile | Where-Object Exists | Format-List Name: PowerShell Scope : CurrentUserAllHosts Path : C:\Users\Jeff\Documents\PowerShell\profile.ps1 Exists : True LastModified : 9/9/2020 2:35:45 PM Scope : CurrentUserCurrentHost Path : C:\Users\Jeff\Documents\PowerShell\Microsoft.PowerShell_profile.ps1 Exists : True LastModified : 9/9/2020 2:03:44 PM Name: Windows PowerShell Scope : AllUsersCurrentHost Path : C:\WINDOWS\System32\WindowsPowerShell\v1.0\Microsoft.PowerShell_profile.ps1 Exists : True LastModified : 10/9/2020 4:08:35 PM ... The command has a default list view. Online Version: https://bit.ly/3dqVRjO Get-PSScriptTools Get PSScriptTools Get a summary of PSScriptTools commands. You can use this command to get a summary display of functions included in the PSScriptTools module. Use the -Verb parameter to filter the output. Get-PSScriptTools Verb Filter commands based on a standard PowerShell verb. String String None Verb Filter commands based on a standard PowerShell verb. String String None None PSScriptTool Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-PSScriptTools Verb: Add Name Alias Synopsis ---- ----- -------- Add-Border Create a text border around a string. Verb: Compare Name Alias Synopsis ---- ----- -------- Compare-Module cmo Compare PowerShell module versions. Verb: Convert Name Alias Synopsis ---- ----- -------- Convert-CommandToHashtable Convert a PowerShell expression i... Convert-EventLogRecord clr Convert EventLogRecords to struct... Convert-HashtableString Convert a hashtable string into a... Convert-HashtableToCode Convert a hashtable to a string r... ... -------------------------- Example 2 -------------------------- PS C:\> Get-PSScriptTools | Where alias Verb: Compare Name Alias Synopsis ---- ----- -------- Compare-Module cmo Compare PowerShell module versions. Compare-Script csc Compare PowerShell script versions. Verb: Convert Name Alias Synopsis ---- ----- -------- Convert-EventLogRecord clr Convert EventLogRecords to structured... Convert-HashtableToCode chc Convert a hashtable to a string repre... ... List commands with defined aliases in the PSScriptTools module. -------------------------- Example 3 -------------------------- PS C:\> Get-PSScriptTools -Verb Select Verb:Select Name Alias Synopsis ---- ----- -------- Select-After after Select objects after a give... Select-Before before Select objects before a giv... Select-First First Select the first X number o... Select-Last Last Select the last X number of... Select-Newest newest Select the newest X number ... Select-Oldest oldest Select the oldest X number ... Get all module commands that use the Select verb. Online Version: http://bit.ly/3acixBH Get-Command Get-Module Open-PSScriptToolsHelp Get-PSSessionInfo Get PSSessionInfo Get details about the current PowerShell session This command will provide a snapshot of the current PowerShell session. The Runtime and Memory properties are defined by script so if you save the result to a variable, you will get current values everytime you look at the variable. Get-PSSessionInfo None PSSessionInfo This command has an alias of gsin. Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-PSSessionInfo ProcessID : 1112 Command : "C:\Program Files\PowerShell\7\pwsh.exe" -noprofile Host : ConsoleHost Started : 4/9/2021 9:36:13 AM PSVersion : 7.1.3 Elevated : True Parent : System.Diagnostics.Process (WindowsTerminal) Runtime : 00:31:26.2716486 MemoryMB : 129 The Memory value is in MB. If running in a PowerShell console session, the Elevated value will be displayed in color. -------------------------- Example 2 -------------------------- PS /home> Get-PSSessionInfo ProcessID : 71 Command : pwsh Host : ConsoleHost Started : 04/09/2021 09:38:55 PSVersion : 7.1.3 Elevated : False Parent : System.Diagnostics.Process (bash) Runtime : 00:30:07.1669248 MemoryMB : 133 The result from a Linux host. Online Version: https://bit.ly/3xOCRFb Get-Host Get-Process Get-PSUnique Get PSUnique Filter for unique objects. You can use this command to filter for truly unique objects. That is, every property on every object is considered unique. Most things in PowerShell are already guaranteed to be unique, but you might import data from a CSV file with duplicate entries. Get-PSUnique can help filter. This command works best with simple objects. Objects with nested objects as properties may not be properly deteted. Get-PSUnique InputObject Simple, objects. The flatter the better this command will work. Object Object None InputObject Simple, objects. The flatter the better this command will work. Object Object None Object Object Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> $clean = Import-CSV c:\data\newinfo.csv | Get-PSUnique Import unique objects from a CSV file and save the results to a variable. Online Version: https://bit.ly/3FcGibX Compare-Object Get-PSWho Get PSWho Get PowerShell user summary information. This command will provide a summary of relevant information for the current user in a PowerShell session. You might use this to troubleshoot an end-user problem running a script or command. The default behavior is to write an object to the pipeline, but you can use the -AsString parameter to force the command to write a string. This makes it easier to use in your scripts with Write-Verbose. Get-PSWho AsString Write the summary object as a string. This can be useful when you want to save the information in a log file. SwitchParameter False AsString Write the summary object as a string. This can be useful when you want to save the information in a log file. SwitchParameter SwitchParameter False None PSWho System.String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Get-PSWho User : Desk01\Jeff Elevated : False Computername : Desk01 OperatingSystem : Microsoft Windows 10 Pro [64-bit] OSVersion : 10.0.19042 PSVersion : 5.1.19041.906 Edition : Desktop PSHost : ConsoleHost WSMan : 3.0 ExecutionPolicy : RemoteSigned Culture : English (United States) -------------------------- EXAMPLE 2 -------------------------- PS /home/jhicks> Get-PSWho User : jeff Elevated : False Computername : Desk01 OperatingSystem : Linux 5.4.72-microsoft-standard-WSL2 #1 SMP Wed Oct 28 23:40:43 UTC 2020 OSVersion : Ubuntu 20.04.2 LTS PSVersion : 7.1.3 Edition : Core PSHost : ConsoleHost WSMan : 3.0 ExecutionPolicy : Unrestricted Culture : Invariant Language (Invariant Country) -------------------------- EXAMPLE 3 -------------------------- PS C:\> Get-PSWho User : Desk01\Jeff Elevated : True Computername : Desk01 OperatingSystem : Microsoft Windows 10 Pro [64-bit] OSVersion : 10.0.19042 PSVersion : 7.1.3 Edition : Core PSHost : ConsoleHost WSMan : 3.0 ExecutionPolicy : RemoteSigned Culture : English (United States) -------------------------- EXAMPLE 4 -------------------------- PS C:\> Get-PSWho -asString | Set-Content c:\test\who.txt Online Version: http://bit.ly/31SF1ne Test-IsElevated Get-CimInstance Get-ExecutionPolicy $PSVersionTable $Host Get-TZData Get TZData Get time zone details. This command uses a free and publicly available REST API offered by http://worldtimeapi.org to get information about a time zone. You can use Get-TZList to find an area and this command to display the details. The time zone area name is case-sensitive. The default is to write a custom object to the pipeline, but you also have an option of seeing the raw data that is returned from the API. On PowerShell Core, the raw data will be slightly different. Note that if the site is busy you may get an error. If that happens, wait a minute and try again. Get-TZData TimeZoneArea Enter a timezone location like Pacific/Auckland. It is case sensitive. Use Get-TZList to retrieve a list of areas. String String None Raw Return raw, unformatted data. Due to the way PowerShell Core automatically wants to format date time strings, raw output had to be slightly adjusted. SwitchParameter False Raw Return raw, unformatted data. Due to the way PowerShell Core automatically wants to format date time strings, raw output had to be slightly adjusted. SwitchParameter SwitchParameter False TimeZoneArea Enter a timezone location like Pacific/Auckland. It is case sensitive. Use Get-TZList to retrieve a list of areas. String String None System.String PSCustomObject TimeZoneData Learn more about PowerShell:http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-TZData Australia/Hobart PS C:\> Get-TZData Australia/Hobart Timezone Label Offset DST Time -------- ----- ------ --- ---- Australia/Hobart AEDT 11:00:00 True 3/16/2020 5:35:46 AM Get time zone information for Hobart. -------------------------- Example 2 -------------------------- PS C:\> Get-TZData Asia/Tokyo -Raw week_number : 11 utc_offset : +09:00 unixtime : 1552674997 timezone : Asia/Tokyo dst_until : dst_from : dst : False day_of_year : 75 day_of_week : 6 datetime : 2020-03-16T03:36:37.829505+09:00 abbreviation : JST Get time zone information for Tokyo as a raw format. -------------------------- Example 3 -------------------------- PS C:\> Get-TZList Antarctica | Get-TZData | Sort-Object Offset Timezone Label Offset DST Time -------- ----- ------ --- ---- Antarctica/Rothera -03 -03:00:00 False 3/15/2020 3:39:59 PM Antarctica/Palmer -03 -03:00:00 False 3/15/2020 3:39:59 PM Antarctica/Troll +00 00:00:00 False 3/15/2020 6:40:00 PM Antarctica/Syowa +03 03:00:00 False 3/15/2020 9:39:59 PM Antarctica/Mawson +05 05:00:00 False 3/15/2020 11:39:59 PM Antarctica/Vostok +06 06:00:00 False 3/16/2020 12:40:00 AM Antarctica/Davis +07 07:00:00 False 3/16/2020 1:39:58 AM Antarctica/Casey +08 08:00:00 False 3/16/2020 2:39:58 AM Antarctica/DumontDUrville +10 10:00:00 False 3/16/2020 4:39:58 AM Antarctica/Macquarie +11 11:00:00 False 3/16/2020 5:39:58 AM Get all time zone areas in Antarctica and pipe them to Get-TZData to retrieve the details. -------------------------- Example 4 -------------------------- PS C:\> Get-TZData Europe/Rome | ConvertTo-LocalTime -Datetime "3/15/2020 4:00PM" Friday, March 15, 2020 11:00:00 AM Convert the datetime in Rome to local time, which in this example is Eastern time. Online Version: http://bit.ly/31SFfe4 Get-TZList Get-TZList Get TZList Get a list of time zone areas. This command uses a free and publicly available REST API offered by http://worldtimeapi.org to get a list of time zone areas. You can get a list of all areas or by geographic location. Use Get-TZData to then retrieve details. You must have Internet access for this command to work. Note that if the site is busy you may get an error. If that happens, wait a minute and try again. Get-TZList All Get a list of all timezone areas SwitchParameter False Get-TZList TimeZoneArea Specify a time zone region. Africa America Antarctica Asia Atlantic Australia Europe Indian Pacific String String None All Get a list of all timezone areas SwitchParameter SwitchParameter False TimeZoneArea Specify a time zone region. String String None System.String string Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-TZList -all Africa/Abidjan Africa/Accra Africa/Algiers Africa/Bissau Africa/Cairo ... Get a list of all time zone areas. -------------------------- Example 2 -------------------------- PS C:\> Get-TZList Atlantic Atlantic/Azores Atlantic/Bermuda Atlantic/Canary Atlantic/Cape_Verde Atlantic/Faroe Atlantic/Madeira Atlantic/Reykjavik Atlantic/South_Georgia Atlantic/Stanley Get all time zone areas in the Atlantic region. Online Version: http://bit.ly/31SFp5a Get-TZData Get-WhoIs Get WhoIs Lookup WhoIS data for a given IPv4 address. This command queries the ARIN database to lookup WhoIs information for a given IPv4 address. Get-WhoIs IPAddress Enter a valid IPV4 address to lookup with WhoIs. It is assumed all of the octets are less than 254. String String None IPAddress Enter a valid IPV4 address to lookup with WhoIs. It is assumed all of the octets are less than 254. String String None System.String WhoIsResult Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> get-whois 208.67.222.222 | Select-Object -Property * IP : 208.67.222.222 Name : OPENDNS-NET-1 RegisteredOrganization : Cisco OpenDNS, LLC City : San Francisco StartAddress : 208.67.216.0 EndAddress : 208.67.223.255 NetBlocks : 208.67.216.0/21 Updated : 3/2/2012 8:03:18 AM -------------------------- Example 2 -------------------------- PS C:\> '1.1.1.1','8.8.8.8','208.67.222.222'| get-whois Name IP RegisteredOrganization NetBlocks Updated ---- -- ---------------------- --------- ------- APNIC-1 1.1.1.1 Asia Pacific Network Information Centre 1.0.0.0/8 7/30/2010 8:23:43 AM LVLT-GOGL-8-8-8 8.8.8.8 Google LLC 8.8.8.0/24 3/14/2014 3:52:05 PM OPENDNS-NET-1 208.67.222.222 Cisco OpenDNS, LLC 208.67.216.0/21 3/2/2012 8:03:18 AM Online Version: http://bit.ly/31Ut7JE Invoke-RestMethod Get-WindowsVersion Get WindowsVersion Get Windows version information. This is a PowerShell version of the winver.exe utility. This command uses PowerShell remoting to query the registry on a remote machine to retrieve Windows version information. The parameters are the same as in Invoke-Command. If you are querying the local computer, all other parameters will be ignored. Get-WindowsVersion Computername Specifies the computers on which the command runs. The default is the local computer. When you use the ComputerName parameter, Windows PowerShell creates a temporary connection that is used only to run the specified command and is then closed. If you need a persistent connection, use the Session parameter. Type the NETBIOS name, IP address, or fully qualified domain name of one or more computers in a comma-separated list. To specify the local computer, type the computer name, localhost, or a dot (.). To use an IP address in the value of ComputerName , the command must include the Credential parameter. Also, the computer must be configured for HTTPS transport or the IP address of the remote computer must be included in the WinRM TrustedHosts list on the local computer. For instructions for adding a computer name to the TrustedHosts list, see "How to Add a Computer to the Trusted Host List" in about_Remote_Troubleshooting. On Windows Vista and later versions of the Windows operating system, to include the local computer in the value of ComputerName , you must open Windows PowerShell by using the Run as administrator option. String[] String[] $env:COMPUTERNAME Credential Specifies a user account that has permission to perform this action. The default is the current user. Type a user name, such as User01 or Domain01\User01. Or, enter a PSCredential object, such as one generated by the Get-Credential cmdlet. If you type a user name, this cmdlet prompts you for a password. PSCredential PSCredential None UseSSL Indicates that this cmdlet uses the Secure Sockets Layer (SSL) protocol to establish a connection to the remote computer. By default, SSL is not used. WS-Management encrypts all Windows PowerShell content transmitted over the network. The UseSSL parameter is an additional protection that sends the data across an HTTPS, instead of HTTP. If you use this parameter, but SSL is not available on the port that is used for the command, the command fails. SwitchParameter False ThrottleLimit Specifies the maximum number of concurrent connections that can be established to run this command. If you omit this parameter or enter a value of 0, the default value, 32, is used. The throttle limit applies only to the current command, not to the session or to the computer. Int32 Int32 0 Authentication Specifies the mechanism that is used to authenticate the user's credentials. The acceptable values for this parameter are: - Default - Basic - Credssp - Digest - Kerberos - Negotiate - NegotiateWithImplicitCredential The default value is Default. CredSSP authentication is available only in Windows Vista, Windows Server 2008, and later versions of the Windows operating system. For information about the values of this parameter, see the description of the AuthenticationMechanismEnumeration (http://go.microsoft.com/fwlink/?LinkID=144382) in the Microsoft Developer Network (MSDN) library. CAUTION: Credential Security Support Provider (CredSSP) authentication, in which the user's credentials are passed to a remote computer to be authenticated, is designed for commands that require authentication on more than one resource, such as accessing a remote network share. This mechanism increases the security risk of the remote operation. If the remote computer is compromised, the credentials that are passed to it can be used to control the network session. String String Default Computername Specifies the computers on which the command runs. The default is the local computer. When you use the ComputerName parameter, Windows PowerShell creates a temporary connection that is used only to run the specified command and is then closed. If you need a persistent connection, use the Session parameter. Type the NETBIOS name, IP address, or fully qualified domain name of one or more computers in a comma-separated list. To specify the local computer, type the computer name, localhost, or a dot (.). To use an IP address in the value of ComputerName , the command must include the Credential parameter. Also, the computer must be configured for HTTPS transport or the IP address of the remote computer must be included in the WinRM TrustedHosts list on the local computer. For instructions for adding a computer name to the TrustedHosts list, see "How to Add a Computer to the Trusted Host List" in about_Remote_Troubleshooting. On Windows Vista and later versions of the Windows operating system, to include the local computer in the value of ComputerName , you must open Windows PowerShell by using the Run as administrator option. String[] String[] $env:COMPUTERNAME Credential Specifies a user account that has permission to perform this action. The default is the current user. Type a user name, such as User01 or Domain01\User01. Or, enter a PSCredential object, such as one generated by the Get-Credential cmdlet. If you type a user name, this cmdlet prompts you for a password. PSCredential PSCredential None UseSSL Indicates that this cmdlet uses the Secure Sockets Layer (SSL) protocol to establish a connection to the remote computer. By default, SSL is not used. WS-Management encrypts all Windows PowerShell content transmitted over the network. The UseSSL parameter is an additional protection that sends the data across an HTTPS, instead of HTTP. If you use this parameter, but SSL is not available on the port that is used for the command, the command fails. SwitchParameter SwitchParameter False ThrottleLimit Specifies the maximum number of concurrent connections that can be established to run this command. If you omit this parameter or enter a value of 0, the default value, 32, is used. The throttle limit applies only to the current command, not to the session or to the computer. Int32 Int32 0 Authentication Specifies the mechanism that is used to authenticate the user's credentials. The acceptable values for this parameter are: - Default - Basic - Credssp - Digest - Kerberos - Negotiate - NegotiateWithImplicitCredential The default value is Default. CredSSP authentication is available only in Windows Vista, Windows Server 2008, and later versions of the Windows operating system. For information about the values of this parameter, see the description of the AuthenticationMechanismEnumeration (http://go.microsoft.com/fwlink/?LinkID=144382) in the Microsoft Developer Network (MSDN) library. CAUTION: Credential Security Support Provider (CredSSP) authentication, in which the user's credentials are passed to a remote computer to be authenticated, is designed for commands that require authentication on more than one resource, such as accessing a remote network share. This mechanism increases the security risk of the remote operation. If the remote computer is compromised, the credentials that are passed to it can be used to control the network session. String String Default System.String WindowsVersion Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\>Get-WindowsVersion Computername: DESK109 ProductName EditionID ReleaseID Build InstalledUTC ----------- --------- --------- ----- ------------ Windows 10 Pro Professional 2009 19042 10/16/2020 3:09:01 PM Query the local host. -------------------------- EXAMPLE 2 -------------------------- PS C:\> Get-WindowsVersion -Computername srv1,srv2,win10 -Credential $art Computername: WIN10 ProductName EditionID ReleaseID Build InstalledUTC ----------- --------- --------- ----- ------------ Windows 10 Enterprise Enterprise 1903 18362 2/6/2020 5:28:34 PM Computername: SRV1 ProductName EditionID ReleaseID Build InstalledUTC ----------- --------- --------- ----- ------------ Windows Server 2016 ServerStandard 1607 14393 2/6/2020 5:27:42 PM Standard Computername: SRV2 ProductName EditionID ReleaseID Build InstalledUTC ----------- --------- --------- ----- ------------ Windows Server 2016 ServerStandard 1607 14393 2/6/2020 6:47:12 PM Standard Get Windows version information from remote computers using an alternate credential. -------------------------- Example 3 -------------------------- PS C:\> Get-WindowsVersion -Computername Dom1 | Select-Object * ProductName : Windows Server 2016 Standard Evaluation EditionID : ServerStandardEval ReleaseID : 1607 Build : 14393.3474 Branch : rs1_release InstalledUTC : 2/6/2020 5:18:50 PM Computername : DOM1 Online Version: http://bit.ly/31QKsTt Get-WindowsVersionString WinVer.exe Invoke-Command Get-WindowsVersionString Get WindowsVersionString Get Windows version information. This is a PowerShell version of the winver.exe utility.T his command uses PowerShell remoting to query the registry on a remote machine to retrieve Windows version information. The parameters are the same as in Invoke-Command. The command writes a string of version information. If you are querying the local computer, all other parameters will be ignored. Get-WindowsVersionString Computername Specifies the computers on which the command runs. The default is the local computer. When you use the ComputerName parameter, Windows PowerShell creates a temporary connection that is used only to run the specified command and is then closed. If you need a persistent connection, use the Session parameter. Type the NETBIOS name, IP address, or fully qualified domain name of one or more computers in a comma-separated list. To specify the local computer, type the computer name, localhost, or a dot (.). To use an IP address in the value of ComputerName , the command must include the Credential parameter. Also, the computer must be configured for HTTPS transport or the IP address of the remote computer must be included in the WinRM TrustedHosts list on the local computer. For instructions for adding a computer name to the TrustedHosts list, see "How to Add a Computer to the Trusted Host List" in about_Remote_Troubleshooting. On Windows Vista and later versions of the Windows operating system, to include the local computer in the value of ComputerName , you must open Windows PowerShell by using the Run as administrator option. String[] String[] $env:COMPUTERNAME Credential Specifies a user account that has permission to perform this action. The default is the current user. Type a user name, such as User01 or Domain01\User01. Or, enter a PSCredential object, such as one generated by the Get-Credential cmdlet. If you type a user name, this cmdlet prompts you for a password. PSCredential PSCredential None UseSSL Indicates that this cmdlet uses the Secure Sockets Layer (SSL) protocol to establish a connection to the remote computer. By default, SSL is not used. WS-Management encrypts all Windows PowerShell content transmitted over the network. The UseSSL parameter is an additional protection that sends the data across an HTTPS, instead of HTTP. If you use this parameter, but SSL is not available on the port that is used for the command, the command fails. SwitchParameter False ThrottleLimit Specifies the maximum number of concurrent connections that can be established to run this command. If you omit this parameter or enter a value of 0, the default value, 32, is used. The throttle limit applies only to the current command, not to the session or to the computer. Int32 Int32 0 Authentication Specifies the mechanism that is used to authenticate the user's credentials. The acceptable values for this parameter are: - Default - Basic - Credssp - Digest - Kerberos - Negotiate - NegotiateWithImplicitCredential The default value is Default. CredSSP authentication is available only in Windows Vista, Windows Server 2008, and later versions of the Windows operating system. For information about the values of this parameter, see the description of the AuthenticationMechanismEnumeration (http://go.microsoft.com/fwlink/?LinkID=144382) in the Microsoft Developer Network (MSDN) library. CAUTION: Credential Security Support Provider (CredSSP) authentication, in which the user's credentials are passed to a remote computer to be authenticated, is designed for commands that require authentication on more than one resource, such as accessing a remote network share. This mechanism increases the security risk of the remote operation. If the remote computer is compromised, the credentials that are passed to it can be used to control the network session. String String Default Computername Specifies the computers on which the command runs. The default is the local computer. When you use the ComputerName parameter, Windows PowerShell creates a temporary connection that is used only to run the specified command and is then closed. If you need a persistent connection, use the Session parameter. Type the NETBIOS name, IP address, or fully qualified domain name of one or more computers in a comma-separated list. To specify the local computer, type the computer name, localhost, or a dot (.). To use an IP address in the value of ComputerName , the command must include the Credential parameter. Also, the computer must be configured for HTTPS transport or the IP address of the remote computer must be included in the WinRM TrustedHosts list on the local computer. For instructions for adding a computer name to the TrustedHosts list, see "How to Add a Computer to the Trusted Host List" in about_Remote_Troubleshooting. On Windows Vista and later versions of the Windows operating system, to include the local computer in the value of ComputerName , you must open Windows PowerShell by using the Run as administrator option. String[] String[] $env:COMPUTERNAME Credential Specifies a user account that has permission to perform this action. The default is the current user. Type a user name, such as User01 or Domain01\User01. Or, enter a PSCredential object, such as one generated by the Get-Credential cmdlet. If you type a user name, this cmdlet prompts you for a password. PSCredential PSCredential None UseSSL Indicates that this cmdlet uses the Secure Sockets Layer (SSL) protocol to establish a connection to the remote computer. By default, SSL is not used. WS-Management encrypts all Windows PowerShell content transmitted over the network. The UseSSL parameter is an additional protection that sends the data across an HTTPS, instead of HTTP. If you use this parameter, but SSL is not available on the port that is used for the command, the command fails. SwitchParameter SwitchParameter False ThrottleLimit Specifies the maximum number of concurrent connections that can be established to run this command. If you omit this parameter or enter a value of 0, the default value, 32, is used. The throttle limit applies only to the current command, not to the session or to the computer. Int32 Int32 0 Authentication Specifies the mechanism that is used to authenticate the user's credentials. The acceptable values for this parameter are: - Default - Basic - Credssp - Digest - Kerberos - Negotiate - NegotiateWithImplicitCredential The default value is Default. CredSSP authentication is available only in Windows Vista, Windows Server 2008, and later versions of the Windows operating system. For information about the values of this parameter, see the description of the AuthenticationMechanismEnumeration (http://go.microsoft.com/fwlink/?LinkID=144382) in the Microsoft Developer Network (MSDN) library. CAUTION: Credential Security Support Provider (CredSSP) authentication, in which the user's credentials are passed to a remote computer to be authenticated, is designed for commands that require authentication on more than one resource, such as accessing a remote network share. This mechanism increases the security risk of the remote operation. If the remote computer is compromised, the credentials that are passed to it can be used to control the network session. String String Default System.String System.String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Get-WindowsVersionString -Computername win10 -credential company\artd WIN10 Windows 10 Enterprise (OS Build 15063.1418) Get a string version of Windows version information from a remote computer and use an alternate credential. -------------------------- EXAMPLE 2 -------------------------- PS C:\> Get-WindowsVersionString BOVINE320 Windows 10 Pro Version Professional (OS Build 17763.253) Get version information for the local host. Online Version: http://bit.ly/31QKACr Get-WindowsVersion Winver.exe Invoke-InputBox Invoke InputBox Launch a graphical input box. Use this command as a graphical replacement for Read-Host. The command will write either a string or a secure string to the pipeline. You can customize the prompt, title and background color. This command requires a Windows platform. Invoke-InputBox AsSecureString Use to mask the entry and return a secure string. SwitchParameter False BackgroundColor Set the form background color. You can use a value like 'red' or a '#c0c0c0'. String String White Prompt Enter a prompt. No more than 50 characters. String String "Please enter a value" Title Enter the title for the input box. No more than 25 characters. String String "User Input" AsSecureString Use to mask the entry and return a secure string. SwitchParameter SwitchParameter False BackgroundColor Set the form background color. You can use a value like 'red' or a '#c0c0c0'. String String White Prompt Enter a prompt. No more than 50 characters. String String "Please enter a value" Title Enter the title for the input box. No more than 25 characters. String String "User Input" None System.String System.Security.SecureString Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> $name = Invoke-Inputbox -prompt "Enter a user name" -title "New User" Display an graphical inputbox with a given prompt and title. The entered value will be saved to $name. -------------------------- EXAMPLE 2 -------------------------- PS C:\> $pass = Invoke-Inputbox -prompt "Enter a new password" -title "New User" -asSecureString -background red Get a secure string value from the user. This example also changes the form background to red. Online Version: http://bit.ly/31UtHXQ Read-Host New-WPFMessageBox Join-Hashtable Join Hashtable Combine two hashtables into one. This command will combine two hashtables into a single hashtable. Normally this is as easy as $hash1+$hash2. But if there are duplicate keys, this will fail. Join-Hashtable will test for duplicate keys. If any of the keys from the first, or primary hashtable are found in the secondary hashtable, you will be prompted for which to keep. Or you can use -Force which will always keep the conflicting key from the first hashtable. The original hashtables will not be modified. Join-Hashtable First The primary hashtable. If there are any duplicate keys and you use -Force, values from this hashtable will be kept. Hashtable Hashtable None Second The secondary hashtable. Hashtable Hashtable None Force Do not prompt for conflicts. Always keep the key from the first hashtable. SwitchParameter False First The primary hashtable. If there are any duplicate keys and you use -Force, values from this hashtable will be kept. Hashtable Hashtable None Second The secondary hashtable. Hashtable Hashtable None Force Do not prompt for conflicts. Always keep the key from the first hashtable. SwitchParameter SwitchParameter False hashtable hashtable Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> $a=@{Name="Jeff";Count=3;Color="Green"} PS C:\> $b=@{Computer="HAL";Enabled=$True;Year=2020;Color="Red"} PS C:\> Join-Hashtable $a $b Duplicate key Color A Green B Red Which key do you want to KEEP \[AB\]?: A Name Value ---- ----- Year 2020 Name Jeff Enabled True Color Green Computer HAL Count 3 -------------------------- EXAMPLE 2 -------------------------- PS C:\>$c = Join-Hashtable $a $b -force PS C:\> $c Name Value ---- ----- Year 2020 Name Jeff Enabled True Color Green Computer HAL Count 3 Online Version: http://bit.ly/31QKJ8X About_Hash_Tables New-ANSIBar New ANSIBar Display an ANSI colored bar. You can use this command to create colorful bars using ANSI escape sequences based on a 256 color scheme. The default behavior is to create a gradient bar that goes from first to last values in the range and then back down again. Or you can create a single gradient that runs from the beginning of the range to the end. You can use one of the default characters or specify a custom one. You can learn more about ANSI escape codes at https://en.wikipedia.org/wiki/ANSI_escape_code. New-ANSIBar Character Specify a character to use for the bar. FullBlock LightShade MediumShade DarkShade BlackSquare WhiteSquare String String None Gradient Display as a single gradient from the first value to the last. SwitchParameter False Range Enter a range of 256 color values, e.g. (232..255) Int32[] Int32[] None Spacing How many characters do you want in the bar of each value? This will increase the overall length of the bar. Int32 Int32 None New-ANSIBar Custom Specify a custom character. Char Char None Gradient Display as a single gradient from the first value to the last. SwitchParameter False Range Enter a range of 256 color values, e.g. (232..255) Int32[] Int32[] None Spacing How many characters do you want in the bar of each value? This will increase the overall length of the bar. Int32 Int32 None Character Specify a character to use for the bar. String String None Custom Specify a custom character. Char Char None Gradient Display as a single gradient from the first value to the last. SwitchParameter SwitchParameter False Range Enter a range of 256 color values, e.g. (232..255) Int32[] Int32[] None Spacing How many characters do you want in the bar of each value? This will increase the overall length of the bar. Int32 Int32 None None System.String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> New-ANSIBar -range (232..255) This will create a grayscale gradient bar that goes from dark to light to dark. -------------------------- Example 2 -------------------------- PS C:\> New-ANSIBar -range (46..51) -Character BlackSquare -Spacing 3 -------------------------- Example 3 -------------------------- PS C:\> New-ANSIBar -range (214..219) -Gradient -Spacing 5 -Character DarkShade Online Version: https://bit.ly/33RWeAV New-RedGreenGradient Write-ANSIProgress Show-ANSISequence New-CustomFileName New CustomFileName Create a custom file name based on a template. This command will generate a custom file name based on a template string that you provide. You can create a template string using any of these variables. Most of these should be self-explanatory - %username - %computername - %year - 4 digit year - %yr - 2 digit year - %monthname - The abbreviated month name - %month - The month number - %dayofweek - The full name of the week day - %day - %hour - the hour of the day in 12-hour format to 2 digits - %hour24 - the hour of the day in 24-hour format to 2 digits - %minute - %seconds - %time - A compact string of HourMinuteSecond - %string - A random string - %guid You can also insert a random number using %### with a # character for each digit. If you want a 2 digit random number use %##. If you want 6 digits, use %######. The command will attempt to preserve case for any non-pattern string, but you should separate it from other placeholder patterns with one of these characters: - ( ) [ ] or a . Using an underscore will not work. Another option, is to turn the entire custom name into upper or lower case. New-CustomFileName Template A string that defines the naming pattern based on a set of placeholders. You can create a template string using any of these variables, including the % symbol. - %username - %computername - %year - 4 digit year - %yr - 2 digit year - %monthname - The abbreviated month name - %month - The month number - %dayofweek - The full name of the week day - %day - %hour - the hour of the day in 12-hour format to 2 digits - %hour24 - the hour of the day in 24-hour format to 2 digits - %minute - %seconds - %time - A compact string of HourMinuteSecond - %string - A random string - %guid - %### - a random number matching the number of # characters String String None Case Some values like username or computername might be in a different case than what you want. You can use the default value, or return a value that is all upper or lower case. Lower Upper Default String String None Case Some values like username or computername might be in a different case than what you want. You can use the default value, or return a value that is all upper or lower case. String String None Template A string that defines the naming pattern based on a set of placeholders. You can create a template string using any of these variables, including the % symbol. - %username - %computername - %year - 4 digit year - %yr - 2 digit year - %monthname - The abbreviated month name - %month - The month number - %dayofweek - The full name of the week day - %day - %hour - the hour of the day in 12-hour format to 2 digits - %hour24 - the hour of the day in 24-hour format to 2 digits - %minute - %seconds - %time - A compact string of HourMinuteSecond - %string - A random string - %guid - %### - a random number matching the number of # characters String String None None System.String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> New-CustomFileName %computername_%day%monthname%yr-%time.log COWPC_28Nov20-142138.log -------------------------- EXAMPLE 2 -------------------------- PS C:\> New-CustomFileName %dayofweek-%####.dat Tuesday-3128.dat Create a custom file name using the day of the week and a 4 digit random number. -------------------------- EXAMPLE 3 -------------------------- PS C:\> New-CustomFileName %username-%string.tmp -Case Upper JEFF-Z0XUXMFS.TMP Create an upper case custom file name. The %string placeholder will be replaced with a random 8 character string. -------------------------- EXAMPLE 4 -------------------------- PS C:\> Join-Path c:\work (New-CustomFilename "%Year%Monthname-LOG-%computername[%username].txt" -case lower) c:\work\2020nov-log-bovine320[jeff].txt Create a lower case filename using Join-Path. This command does not create the file, it only generates a name for you to use. -------------------------- EXAMPLE 5 -------------------------- PS C:\> 1..10 | foreach-object { $file = New-Item (Join-Path c:\work\data (New-CustomFileName %string-%####.dat)) $stream =$file.open("OpenOrCreate") $stream.Seek((Get-Random -minimum 250 -Maximum 2KB), "Begin") | Out-Null $stream.WriteByte(0) $stream.Close() $file } Directory: C:\work\data Mode LastWriteTime Length Name ---- ------------- ------ ---- -a---- 3/15/2020 4:46 PM 976 rcphz2nj-6431.dat -a---- 3/15/2020 4:46 PM 1797 viz32er5-0526.dat -a---- 3/15/2020 4:46 PM 1775 k2mukuv4-8267.dat -a---- 3/15/2020 4:46 PM 666 0encqdlt-8753.dat -a---- 3/15/2020 4:46 PM 513 dbswpujf-6314.dat -a---- 3/15/2020 4:46 PM 371 qlkdufp0-0481.dat -a---- 3/15/2020 4:46 PM 2010 5cxq3tb5-5624.dat -a---- 3/15/2020 4:46 PM 2043 mcvoh4n5-8041.dat -a---- 3/15/2020 4:46 PM 1048 4iwibnmf-1584.dat -a---- 3/15/2020 4:46 PM 378 fgsj0rtd-2894.dat Create 10 dummy files with random names and sizes. Online Version: http://bit.ly/31LsDoS New-RandomFileName New-FunctionItem New FunctionItem Create a function item from the console You can use this function to create a quick function definition directly from the console. This command does not write anything to the pipeline unless you use -Passthru. New-FunctionItem Name What is the name of your function? String String None Scriptblock What is your function's scriptblock? ScriptBlock ScriptBlock None Description You can specify an optional description. This only lasts for as long as your function is loaded. String String None Passthru Show the newly created function. SwitchParameter False WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter False Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter False Name What is the name of your function? String String None Scriptblock What is your function's scriptblock? ScriptBlock ScriptBlock None Description You can specify an optional description. This only lasts for as long as your function is loaded. String String None Passthru Show the newly created function. SwitchParameter SwitchParameter False WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter SwitchParameter False Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter SwitchParameter False Scriptbloclk None System.Management.Automation.FunctionInfo Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> New-FunctionItem -name ToTitle -scriptblock {param([string]$Text) (Get-Culture).TextInfo.ToTitleCase($text.toLower())} -passthru CommandType Name Version Source ----------- ---- ------- ------ Function ToTitle -------------------------- EXAMPLE 2 -------------------------- PS C:\> {Get-Date -format g | Set-Clipboard} | New-FunctionItem -name Copy-Date Online Version: https://bit.ly/2UuSKlN Show-FunctionItem New-PSDriveHere New PSDriveHere Create a new PSDrive at the current location. This function will create a new PSDrive at the specified location. The default is the current location, but you can specify any PSPath. The function will take the last word of the path and use it as the name of the new PSDrive. If you prefer to use the first word of the location, use -First. If you prefer to specify a completely different name, then use the -Name parameter. This command will not write anything to the pipeline unless you use -Passthru. New-PSDriveHere Path The path for the new PSDrive. The default is the current location. String String . Name The name for the new PSDrive. The default is the last word in the specified location, unless you use -First. String String None SetLocation Set location to this new drive. This parameter has an alias of CD. SwitchParameter False WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter False Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter False Passthru Pass the new PSDrive object to the pipeline. SwitchParameter False New-PSDriveHere Path The path for the new PSDrive. The default is the current location. String String . First Use the first word of the current location for the new PSDrive. SwitchParameter False SetLocation Set location to this new drive. This parameter has an alias of CD. SwitchParameter False WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter False Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter False Passthru Pass the new PSDrive object to the pipeline. SwitchParameter False Path The path for the new PSDrive. The default is the current location. String String . Name The name for the new PSDrive. The default is the last word in the specified location, unless you use -First. String String None First Use the first word of the current location for the new PSDrive. SwitchParameter SwitchParameter False SetLocation Set location to this new drive. This parameter has an alias of CD. SwitchParameter SwitchParameter False WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter SwitchParameter False Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter SwitchParameter False Passthru Pass the new PSDrive object to the pipeline. SwitchParameter SwitchParameter False None None System.Management.Automation.PSDrive Originally published at http://jdhitsolutions.com/blog/2010/08/New-PSDriveHere/ Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\users\jeff\documents\Enterprise Mgmt Webinar\> New-PSDriveHere This will create a new PSDrive called Webinar rooted to the current location. -------------------------- EXAMPLE 2 -------------------------- PS C:\users\jeff\documents\Enterprise Mgmt Webinar\> New-PSDriveHere -first This will create a new PSDrive called Enterprise rooted to the current location. -------------------------- EXAMPLE 3 -------------------------- PS C:\> New-PSDriveHere HKLM:\software\microsoft -passthru | Select-Object -Expandproperty Name microsoft -------------------------- EXAMPLE 4 -------------------------- PS C:\> New-PSDriveHere -Path "\\NAS\files\powershell" -Name PSFiles Create a new PSDrive called PSFiles rooted to the specified path. -------------------------- EXAMPLE 5 -------------------------- PS C:\Users\Jeff\Documents\DeepDive\> New-PSDriveHere . DeepDive -setlocation PS DeepDive:\> Create a new PSDrive and change location to it. Online Version: http://bit.ly/31SGnOS Get-PSDrive New-PSDrive New-PSDynamicParameter New PSDynamicParameter Create a PowerShell dynamic parameter. This command will create the code for a dynamic parameter that you can insert into your PowerShell script file. You need to specify a parameter name and a condition. The condition value is code that would run inside an If statement. Use a value like $True if you want to add it later in your scripting editor. New-PSDynamicParameter ParameterName Enter the name of your dynamic parameter. This is a required value. String[] String[] None Condition Enter an expression that evaluates to True or False. This is code that will go inside an IF statement. If using variables, wrap this in single quotes. You can also enter a placeholder like '$True' and edit it later. This is a required value. String String None Mandatory Is this dynamic parameter mandatory? SwitchParameter False DefaultValue Enter an optional default value. Object[] Object[] None Alias Enter an optional parameter alias. Specify multiple aliases separated by commas. String[] String[] None ParameterType Enter the parameter value type such as String or Int32. Use a value like string[] to indicate an array. Type Type String HelpMessage Enter an optional help message. String String None ValueFromPipelineByPropertyName Does this dynamic parameter take pipeline input by property name? SwitchParameter False ParameterSetName Enter an optional parameter set name. String String None Comment Enter an optional comment for your dynamic parameter. It will be inserted into your code as a comment. String String None ValidateNotNullOrEmpty Validate that the parameter is not NULL or empty. SwitchParameter False ValidateLength Enter a minimum and maximum string length for this parameter value as an array of comma-separated set values. Int32[] Int32[] None ValidateSet Enter a set of parameter validations values Object[] Object[] None ValidateRange Enter a set of parameter range validations values as a comma-separated list from minimum to maximum Int32[] Int32[] None ValidateCount Enter a set of parameter count validations values as a comma-separated list from minimum to maximum Int32[] Int32[] None ValidatePattern Enter a parameter validation regular expression pattern String String None ValidateScript Enter a parameter validation scriptblock. If using the form, enter the scriptblock text. ScriptBlock ScriptBlock None ParameterName Enter the name of your dynamic parameter. This is a required value. String[] String[] None Condition Enter an expression that evaluates to True or False. This is code that will go inside an IF statement. If using variables, wrap this in single quotes. You can also enter a placeholder like '$True' and edit it later. This is a required value. String String None Mandatory Is this dynamic parameter mandatory? SwitchParameter SwitchParameter False DefaultValue Enter an optional default value. Object[] Object[] None Alias Enter an optional parameter alias. Specify multiple aliases separated by commas. String[] String[] None ParameterType Enter the parameter value type such as String or Int32. Use a value like string[] to indicate an array. Type Type String HelpMessage Enter an optional help message. String String None ValueFromPipelineByPropertyName Does this dynamic parameter take pipeline input by property name? SwitchParameter SwitchParameter False ParameterSetName Enter an optional parameter set name. String String None Comment Enter an optional comment for your dynamic parameter. It will be inserted into your code as a comment. String String None ValidateNotNullOrEmpty Validate that the parameter is not NULL or empty. SwitchParameter SwitchParameter False ValidateLength Enter a minimum and maximum string length for this parameter value as an array of comma-separated set values. Int32[] Int32[] None ValidateSet Enter a set of parameter validations values Object[] Object[] None ValidateRange Enter a set of parameter range validations values as a comma-separated list from minimum to maximum Int32[] Int32[] None ValidateCount Enter a set of parameter count validations values as a comma-separated list from minimum to maximum Int32[] Int32[] None ValidatePattern Enter a parameter validation regular expression pattern String String None ValidateScript Enter a parameter validation scriptblock. If using the form, enter the scriptblock text. ScriptBlock ScriptBlock None System.String[] Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> New-PSDynamicParameter -Condition "$PSEdition -eq 'Core'" -ParameterName ANSI -Alias color -Comment "Create a parameter to use ANSI if running PowerShell 7" -ParameterType switch DynamicParam { # Create a parameter to use ANSI if running PowerShell 7 If (Core -eq 'Core') { $paramDictionary = New-Object -Type System.Management.Automation.RuntimeDefinedParameterDictionary # Defining parameter attributes $attributeCollection = New-Object -Type System.Collections.ObjectModel.Collection[System.Attribute] $attributes = New-Object System.Management.Automation.ParameterAttribute $attributes.ParameterSetName = '__AllParameterSets' $attributeCollection.Add($attributes) # Adding a parameter alias $dynalias = New-Object System.Management.Automation.AliasAttribute -ArgumentList 'color' $attributeCollection.Add($dynalias) # Defining the runtime parameter $dynParam1 = New-Object -Type System.Management.Automation.RuntimeDefinedParameter('ANSI', [Switch], $attributeCollection) $paramDictionary.Add('ANSI', $dynParam1) return $paramDictionary } # end if } #end DynamicParam This creates dynamic parameter code that you can use in a PowerShell function. Normally you would save this output to a file or copy to the clipboard so that you can paste it into scripting editor. Online Version: https://bit.ly/3JX8R0w New-PSDynamicParameterForm about_Functions_Advanced_Parameters New-PSDynamicParameterForm New PSDynamicParameterForm Launch a WPF front-end to New-PSDynamicParameter. This function will launch a WPF form that you can use to enter values for the New-PSDynamicParameter function. The resulting PowerShell code is copied to the clipboard so that you can paste it into your scripting editor. Mandatory settings are indicated with an asterisk. There should be tool tip help for every setting. If you import the PSScriptTools module in the PowerShell ISE, you will get a menu shortcut under Add-Ins. If you import the module in VS Code using the integrated PowerShell terminal, it will a a new command. New-PSDynamicParameterForm None None Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> New-PSDynamicParameterForm Online Version: https://bit.ly/3HNNcpU New-PSDynamicParameter about_Functions_Advanced_Parameters New-PSFormatXML New PSFormatXML Create or modify a format.ps1xml file. When defining custom objects with a new typename, PowerShell by default will display all properties. However, you may wish to have a specific default view, such as a table or list. Or you may want to have different views that display the object differently. Format directives are stored in format.ps1xml files which can be tedious to create. This command simplifies that process. Note that the table and wide views are set to Autosize. However, the table definition will include best guesses for column widths. If you prefer a more granular approach you can delete the Autosize tag and experiment with varying widths. Don't forget to run Update-FormatData to load your new file. You may need to start a new PowerShell session to fully test changes. Pipe an instance of your custom object to this function and it will generate a format.ps1xml file based on either all the properties or a subset that you provide. You can repeat the process to add additional views. When finished, edit the format.ps1xml file and fine-tune it. The file will have notes on how to substitute script blocks. Although, beginning with v2.31.0, you can specify a hashtable as a custom property name just as you can with Select-Object. Even though this command was written to make it easier when writing modules that might use custom objects, you can use this command to define additional views for standard objects such as files and processes. See Examples. If you run this command inside the Visual Studio Code PowerShell Integrated Console and use -Passthru, the new file will automatically be opened in your editor. New-PSFormatXML InputObject Specify an object to analyze and generate or update a ps1xml file. All you need is one instance of the object. Ideally, the object will have values for all properties. Object Object None Properties Enter a set of properties to include. If you don't specify anything then all properties will be used. When creating a Wide view you should only specify a single property. If you specify an invalid property name, the ps1xml file will NOT be created. Ideally, you will specify an instance of the object that contains a value for all the properties you want to use. Object[] Object[] None FormatType Specify whether to create a table, list, or wide view. Table List Wide String String Table ViewName Enter the name of your view. String String default Path Enter full filename and path for the format.ps1xml file. String String None Append Append the new view to an existing format.ps1xml file. You need to make sure that view names are unique. With the exception of default. You can have multiple default views as long as they are different types, such as table and list. SwitchParameter False Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter False Passthru Write the ps1xml file object to the pipeline. If you run this command inside the VS Code PowerShell integrated console, or the PowerShell ISE and use this parameter, the file will be opened in the editor. SwitchParameter False WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter False Typename Specify the object typename. If you don't, then the command will use the detected object type from the InputObject. String String None GroupBy Specify a property name to group objects on. You can edit the file if you need to change how it is displayed and/or calculated. String String None Wrap Wrap long lines. This only applies to Tables. SwitchParameter False Append Append the new view to an existing format.ps1xml file. You need to make sure that view names are unique. With the exception of default. You can have multiple default views as long as they are different types, such as table and list. SwitchParameter SwitchParameter False Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter SwitchParameter False FormatType Specify whether to create a table, list, or wide view. String String Table InputObject Specify an object to analyze and generate or update a ps1xml file. All you need is one instance of the object. Ideally, the object will have values for all properties. Object Object None Passthru Write the ps1xml file object to the pipeline. If you run this command inside the VS Code PowerShell integrated console, or the PowerShell ISE and use this parameter, the file will be opened in the editor. SwitchParameter SwitchParameter False Path Enter full filename and path for the format.ps1xml file. String String None Properties Enter a set of properties to include. If you don't specify anything then all properties will be used. When creating a Wide view you should only specify a single property. If you specify an invalid property name, the ps1xml file will NOT be created. Ideally, you will specify an instance of the object that contains a value for all the properties you want to use. Object[] Object[] None ViewName Enter the name of your view. String String default WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter SwitchParameter False Typename Specify the object typename. If you don't, then the command will use the detected object type from the InputObject. String String None GroupBy Specify a property name to group objects on. You can edit the file if you need to change how it is displayed and/or calculated. String String None Wrap Wrap long lines. This only applies to Tables. SwitchParameter SwitchParameter False System.Object None System.IO.FileInfo Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> $tname = "myThing" PS C:\> $obj = [PSCustomObject]@{ PSTypeName = $tname Name = "Jeff" Date = (Get-Date) Computername = $env:computername OS = (Get-Ciminstance win32_operatingsystem ).caption } PS C:\> $upParams = @{ TypeName = $tname MemberType = "ScriptProperty" MemberName = "Runtime" Value = {(Get-Date) - [datetime]"1/1/2020"} Force = $True } PS C:\> Update-TypeData @upParams PS C:\> $obj Name : Jeff Date : 2/10/2020 8:49:10 AM Computername : BOVINE320 OS : Microsoft Windows 10 Pro Runtime : 40.20:49:43.9205882 This example begins be creating a custom object. You might normally do this in a script or module. -------------------------- Example 2 -------------------------- PS C:\> $fmt = "C:\scripts\$tname.format.ps1xml" PS C:\> $obj | New-PSFormatXML -Prop Name,Date,Computername,OS -path $fmt PS C:\> $obj | New-PSFormatXML -Prop Name,OS,Runtime -view runtime -path $fmt -append PS C:\> $obj | New-PSFormatXML -FormatType List -path $fmt -append The object is then piped to New-PSFormatXML to generate a new format.ps1xml file. Subsequent commands add more formatted views. When the file is completed it can be modified. Note that these examples are using shortened parameter names. -------------------------- Example 3 -------------------------- PS C:\> Update-FormatData -appendpath "C:\work\$tname.format.ps1xml" PS C:\> $obj Name Date Computername Operating System ---- ---- ------------ ---------------- Jeff 2/10/2020 8:49:10 AM BOVINE320 Microsoft Windows 10 Pro PS C:\> $obj | Format-Table -View runtime Name OS Runtime ---- -- ------- Jeff 40.20:56:24.5411481 PS C:\> $obj | Format-List Name : Jeff Date : Sunday, February 10, 2020 Computername : BOVINE320 OperatingSystem : Microsoft Windows 10 Pro Runtime : 40.21:12:01 After the format.ps1xml file is applied, the object can be formatted as designed. -------------------------- Example 4 -------------------------- PS C:\> $obj | New-PSFormatXML -view computer -Group Computername -path "c:\work\$tname.format.ps1xml" -append PS C:\> Update-FormatData -appendpath "C:\work\$tname.format.ps1xml" PS C:\> $obj | Format-Table -View computer Computername: BOVINE320 Name Date OS Runtime ---- ---- -- ------- Jeff 2/10/2020 8:49:10 AM Microsoft Windows 10 Pro 40.20:56:24.5411481 This adds another view called Computer that groups objects on the Computername property. -------------------------- Example 5 -------------------------- PS C:\>$params = @{ Properties = "DisplayName" FormatType = "Wide" Path = "C:\work\svc.format.ps1xml" GroupBy = "Status" ViewName ="Status" } PS C:\> Get-Service bits | New-PSFormatXML @params PS C:\> Update-FormatData $params.path This will create a custom format file for service objects. This will create a wide display using the Displayname property. Once loaded into PowerShell, you can run a command like this: Get-Service | Sort-Object Status | Format-Wide -view Status -------------------------- Example 6 -------------------------- PS C:\> '' | Select-Object -Property Name,Size,Date,Count,Age | New-PSFormatXML -Typename myThing -Path c:\scripts\mything.format.ps1xml This is an example of creating a formatting file from an empty object. Normally, you would first define your object and verify it has all the properties you need, and then you would create the formatting file. But you may want to create the formatting file in parallel using an older technique like this. -------------------------- Example 7 -------------------------- PS C:\> $p = @{ FormatType = "List" ViewName = "run" Path = "c:\scripts\run.ps1xml" Properties = "ID","Name","Path","StartTime", @{Name="Runtime";Expression={(Get-Date) - $_.starttime}} } PS C:\> Get-Process -id $pid | New-PSFormatXML @p Beginning with v2.31.0 of the PSScriptTools module, you can specify a property defined as a scriptblock, just as you do with Select-Object. The XML file will be automatically created using the script block. Online Version: http://bit.ly/31SGo5o Update-FormatData Get-FormatView New-RandomFileName New RandomFileName Create a random file name. Create a new random file name. The default is a completely random name including the extension. But you can also create a filename that includes either the TEMP folder or the user's home folder. In the case of a Windows system, the home folder will be the documents folder. This command does not create the file, it only generates a name for you to use. New-RandomFileName Extension Use a specific extension. Do not include the period. String String None UseHomeFolder Include the user's HOME folder. SwitchParameter False New-RandomFileName Extension Use a specific extension. Do not include the period. String String None UseTempFolder Include the TEMP folder. SwitchParameter False Extension Use a specific extension. Do not include the period. String String None UseHomeFolder Include the user's HOME folder. SwitchParameter SwitchParameter False UseTempFolder Include the TEMP folder. SwitchParameter SwitchParameter False None System.String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> New-RandomFileName fykxecvh.ipw -------------------------- EXAMPLE 2 -------------------------- PS C:\> New-RandomFileName -extension dat emevgq3r.dat Specify a file extension. -------------------------- EXAMPLE 3 -------------------------- PS C:\> New-RandomFileName -extension log -UseHomeFolder C:\Users\Jeff\Documents\kbyw4fda.log Create a random file name using the user's home folder. In Windows, this will be the Documents folder. -------------------------- EXAMPLE 4 -------------------------- PS /mnt/c/scripts> new-randomfilename -home -Extension tmp /home/jhicks/oces0epq.tmp Create a random file name using the user's home folder on a Linux installation. Online Version: http://bit.ly/31Lt56y New-CustomFileName New-RedGreenGradient New RedGreenGradient Create an ANSI gradient from red to green. You can use this command to create an ANSI colored gradient bar running from red to green. By specifying a percentage, you can provide a visual representation. The closer the percent value is to 1 the more green will be displayed. Use the -Step parameter to adjust the bar length. The smaller the step the longer the bar. New-RedGreenGradient Percent Specify a percentage as a decimal value like .35 Double Double None Character Specify a character to use for the gradient bar Char Char [char]0x2588 Step Specify a relative bar length between 2 and 10. The smaller the number the longer the bar. Int32 Int32 5 Character Specify a character to use for the gradient bar Char Char [char]0x2588 Percent Specify a percentage as a decimal value like .35 Double Double None Step Specify a relative bar length between 2 and 10. The smaller the number the longer the bar. Int32 Int32 5 None System.String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> New-RedGreenGradient -Percent .75 This will display a red to green gradient bar. -------------------------- Example 2 -------------------------- PS C:\> Get-Volume | Where {$_.FileSystemType -eq 'NTFS' -AND $_.driveletter -match "[C-Zc-z]"} | Sort-Object -property DriveLetter | Select-Object -property DriveLetter, FileSystemLabel, @{Name="FreeGB";Expression={Format-Value -input $_.SizeRemaining -unit GB}}, @{Name = "PctFree"; Expression = { $pct = Format-Percent -value $_.sizeremaining -total $_.size -decimal 2; "{1} {0}" -f $(New-RedGreenGradient -percent ($pct/100) -step 6),$pct}} DriveLetter FileSystemLabel FreeGB PctFree ----------- --------------- ------ ------- C Windows 92 38.84 █████████████████ D Data 104 21.82 ██████████ The bar graph will be colored from red towards green. This example is using the Format-Percent and Format-Value commands from the PSScriptTools module. Online Version: https://bit.ly/33WapF8 New-ANSIBar Write-ANSIProgress New-WPFMessageBox New WPFMessageBox Display a customizable WPF-based message box. This function creates a Windows Presentation Foundation (WPF) based message box. This is intended to replace the legacy MsgBox function from VBScript and the Windows Forms library. The command uses a set of predefined button sets, each of which will close the form and write a value to the pipeline. OK = 1 Cancel = 0 Yes = $True No = $False You can also create an ordered hashtable of your own buttons and values. See examples. If you prefer to simply display the form, you can use the -Quiet parameter to suppress any output. PowerShell will block until a button is clicked or the form dismissed. This command requires a Windows platform. New-WPFMessageBox Message Enter the text message to display. String String None Background You can specify any console color or any value from https://docs.microsoft.com/en-us/dotnet/api/system.windows.media.brushes?view=netframework-4.7.2. You can use the name or the code. Keep in mind there are no provisions to change the font color. String String White ButtonSet Select a pre-defined set of buttons. Each button will close the form and write a value to the pipeline. This can serve as the "return value" of the form. OK = 1 Cancel = 0 Yes = $True No = $False OK OKCancel YesNo String String OK Icon Select one of the standard system icons. Information Warning Error Question Shield String String Information Quiet Suppress any pipeline output. SwitchParameter False Title Enter the text to be displayed in the title bar. You should keep this brief. String String None New-WPFMessageBox Message Enter the text message to display. String String None Background You can specify any console color or any value from https://docs.microsoft.com/en-us/dotnet/api/system.windows.media.brushes?view=netframework-4.7.2. You can use the name or the code. Keep in mind there are no provisions to change the font color. String String White CustomButtonSet You can specify your own button set defined in an ordered hashtable. Buttons will be displayed in order from left to right. You can display up to 3 buttons. The key should be the text to display and the value should be the value you expect to write to the pipeline. It is recommended that you keep the button text short. The first letter of each key will automatically be formatted as an accelerator so you should make sure each key starts with a different letter. The first key will also be set as the default. OrderedDictionary OrderedDictionary None Icon Select one of the standard system icons. Information Warning Error Question Shield String String Information Quiet Suppress any pipeline output. SwitchParameter False Title Enter the text to be displayed in the title bar. You should keep this brief. String String None Background You can specify any console color or any value from https://docs.microsoft.com/en-us/dotnet/api/system.windows.media.brushes?view=netframework-4.7.2. You can use the name or the code. Keep in mind there are no provisions to change the font color. String String White ButtonSet Select a pre-defined set of buttons. Each button will close the form and write a value to the pipeline. This can serve as the "return value" of the form. OK = 1 Cancel = 0 Yes = $True No = $False String String OK CustomButtonSet You can specify your own button set defined in an ordered hashtable. Buttons will be displayed in order from left to right. You can display up to 3 buttons. The key should be the text to display and the value should be the value you expect to write to the pipeline. It is recommended that you keep the button text short. The first letter of each key will automatically be formatted as an accelerator so you should make sure each key starts with a different letter. The first key will also be set as the default. OrderedDictionary OrderedDictionary None Icon Select one of the standard system icons. String String Information Message Enter the text message to display. String String None Quiet Suppress any pipeline output. SwitchParameter SwitchParameter False Title Enter the text to be displayed in the title bar. You should keep this brief. String String None None System.Int32 System.Boolean System.String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> New-WPFMessageBox -Message "Are you sure you want to do this?" -Title Confirm -Icon Question -ButtonSet YesNo False Display a Yes/No message box. The value of the clicked button will be written to the pipeline. It is assumed you would use this in a script and have logic to determine what to do based on the value. -------------------------- Example 2 -------------------------- PS C:\> New-WPFMessageBox -Message "Press OK when ready to continue." -Title "User Deletion" -Quiet -Background crimson -Icon Shield Display a message box with a crimson background and using the Shield icon. No value will be written to the pipeline and PowerShell will wait until OK is clicked or the form dismissed. -------------------------- Example 3 -------------------------- PS C:\> New-WPFMessageBox -Message "Select a system option from these choices:" -Title "You Decide" -Background cornsilk -Icon Warning -CustomButtonSet ([ordered]@{"Reboot"=1;"Shutdown"=2;"Cancel"=3}) Create a custom message box with a user-defined set of buttons. Online Version: http://bit.ly/31PDbDx Invoke-InputBox Open-PSScriptToolsHelp Open PSScriptToolsHelp Open the PSScriptTools PDF manual. This command will launch a PDF manual for all commands in the PSScriptTools module. It is assumed you have a default application associated with PDF files. Open-PSScriptToolsHelp None None Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Open-PSScriptToolsHelp Online Version: https://bit.ly/2SOrYRh Get-Help Optimize-Text Optimize Text Clean and optimize text input. Use this command to clean and optimize content from text files. Sometimes text files have blank lines or the content has trailing spaces. These sorts of issues can cause problems when passing the content to other commands. This command will strip out any lines that are blank or have nothing by white space, and trim leading and trailing spaces. The optimized text is then written back to the pipeline. Optionally, you can specify a property name. This can be useful when your text file is a list of computer names and you want to take advantage of pipeline binding. See examples. If your text file has commented lines, use the ignore parameter. As long as the character is the first non-whitespace character in the line, the line will be treated as a comment and ignored. Finally, you can use the -Filter parameter to specify a regular expression pattern to further filter what text is written to the pipeline. The filter is applied after leading and trailing spaces have been removed and before any text is converted to upper case. Optimize-Text Text The text to be optimized. Typically read in from a file. String[] String[] None Filter Use a regular expression pattern to filter. The filtering is applied after leading and trailing spaces have been trimmed and before text can be converted to upper case. Regex Regex None Ignore Specify a character that will be interpreted as a comment character. It must be the first-word character in a line. These lines will be ignored. This parameter has an alias of 'comment'. String String None ToUpper Write text output as upper case. SwitchParameter False Optimize-Text Text The text to be optimized. Typically read in from a file. String[] String[] None Filter Use a regular expression pattern to filter. The filtering is applied after leading and trailing spaces have been trimmed and before text can be converted to upper case. Regex Regex None PropertyName Assign each line of text a property name. This has the effect of turning your text file into an array of objects with a single property. String String None Ignore Specify a character that will be interpreted as a comment character. It must be the first-word character in a line. These lines will be ignored. This parameter has an alias of 'comment'. String String None ToUpper Write text output as upper case. SwitchParameter False Text The text to be optimized. Typically read in from a file. String[] String[] None Filter Use a regular expression pattern to filter. The filtering is applied after leading and trailing spaces have been trimmed and before text can be converted to upper case. Regex Regex None PropertyName Assign each line of text a property name. This has the effect of turning your text file into an array of objects with a single property. String String None Ignore Specify a character that will be interpreted as a comment character. It must be the first-word character in a line. These lines will be ignored. This parameter has an alias of 'comment'. String String None ToUpper Write text output as upper case. SwitchParameter SwitchParameter False System.String System.String System.Management.Automation.PSObject Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ This function was originally described at http://jdhitsolutions.com/blog/2014/09/using-optimized-text-files-in-powershell -------------------------- EXAMPLE 1 -------------------------- PS C:\> Get-Content c:\scripts\computers.txt win10-ent-01 srv1 srv2 dc01 app02 PS C:\> Get-Content c:\scripts\computers.txt | Optimize-Text win10-ent-01 srv1 quark dc01 app02 The first example shows a malformed text file. In the second command, it has been optimized or normalized. -------------------------- EXAMPLE 2 -------------------------- PS C:\> Get-Content c:\scripts\computers.txt | Optimize-Text -property computername computername ------------ win10-ent-01 srv1 quark dc01 app02 Using the same text file, the command creates a custom object using the Computername property. -------------------------- EXAMPLE 3 -------------------------- PS C:\> Get-Content computers.txt | Optimize-Text -prop computername | Where-Object {Test-Connection $_.computername -count 1 -ea silentlycontinue} | Get-Service bits | Select-Object Name,Status,Machinename Name Status MachineName ---- ------ ----------- bits Running win10-ent-01 bits Running dc01 bits Running app02 Optimize the computer names in computers.txt and add a Computername property. Test each computer, ignoring those that fail, and get the Bits service on the ones that can be pinged. -------------------------- EXAMPLE 4 -------------------------- PS C:\> Get-Content .\ChicagoServers.txt | Optimize-Text -Ignore "#" -Property ComputerName ComputerName ------------ chi-fp01 chi-fp02 chi-core01 chi-test chi-dc01 chi-dc02 chi-dc04 chi-db01 Optimize the text file ignoring any lines that start with the # character. -------------------------- EXAMPLE 5 -------------------------- PS C:\> Get-Content .\ChicagoServers.txt | Optimize-Text -filter "dc\d{2}" -ToUpper -PropertyName Computername | Test-Connection -count 1 Source Destination IPV4Address IPV6Address Bytes Time(ms) ------ ----------- ----------- ----------- ----- -------- win10-ENT-01 CHI-DC01 172.16.30.200 32 0 win10-ENT-01 CHI-DC02 172.16.30.201 32 0 win10-ENT-01 CHI-DC04 172.16.30.203 32 0 Get names from a text file that match the pattern, turn into an object with a property name, and pipe to Test-Connection. Online Version: http://bit.ly/31SFF48 Get-Content Out-ConditionalColor Out ConditionalColor Display colorized pipelined output. This command is designed to take pipeline input and display it in a colorized format, based on a set of conditions. Unlike Write-Host which doesn't write to the pipeline, this command will write to the pipeline. You can get colorized data and save the output to a variable at the same time, although you'll need to use the common OutVariable parameter (see examples). The default behavior is to use a hash table with a property name and color. The color must be one of the standard console colors used with Write-Host. $c = @{Stopped='Red';Running='Green'} You can then pipe an expression to this command, specifying a property name and the hash table. If the property matches the key name, the output for that object will be colored using the corresponding hash table value. Get-Service -displayname windows* | Out-ConditionalColor $c -property status Or you can do more complex processing with an ordered hash table constructed using this format: [ordered]@{ <comparison scriptblock> = <color>} The comparison scriptblock can use $PSitem. $h=[ordered]@{ {$psitem.ws -gt 500mb}='red' {$psitem.ws -gt 300mb}='yellow' {$psitem.ws -gt 200mb}='cyan' } Get-Process | Out-ConditionalColor $h When doing a complex comparison you must use an [ordered] hashtable as each key will be processed in order using an If/ElseIf statement. This command should be the last part of any pipelined expression. If you pipe to anything else, such as Sort-Object, you will lose your color formatting. Do any other sorting or filtering before piping to this command. This command works best in the PowerShell console. It won't do anything in the PowerShell ISE. LIMITATIONS Due to the nature of PowerShell's formatting system, there are some limitations with this command. If the first item in your output matches one of your conditions, any text before it, such as headers, will also be colorized. This command will have no effect if the incoming object does not have a defined format view. This means you can't pipe custom objects or something using Select-Object that only includes selected properties to this command. Out-ConditionalColor Conditions Use an ordered hashtable for more complex processing. See examples. OrderedDictionary OrderedDictionary None InputObject The output from a PowerShell expression that you want to colorize. PSObject[] PSObject[] None Out-ConditionalColor PropertyConditions Use a simple hashtable for basic processing or an ordered hash table for complex. Hashtable Hashtable None InputObject The output from a PowerShell expression that you want to colorize. PSObject[] PSObject[] None Property When using a simple hash table, specify the property to compare which will be done by using the -eq operator. String String None Conditions Use an ordered hashtable for more complex processing. See examples. OrderedDictionary OrderedDictionary None InputObject The output from a PowerShell expression that you want to colorize. PSObject[] PSObject[] None Property When using a simple hash table, specify the property to compare which will be done by using the -eq operator. String String None PropertyConditions Use a simple hashtable for basic processing or an ordered hash table for complex. Hashtable Hashtable None System.Management.Automation.PSObject[] System.Object Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ Originally published at: http://jdhitsolutions.com/blog/powershell/3462/friday-fun-Out-ConditionalColor/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Get-Service -displayname windows* | Out-ConditionalColor -propertyconditions @{Stopped='Red'} -property Status Get all services where the display name starts with windows and display stopped services in red. -------------------------- EXAMPLE 2 -------------------------- PS C:\> Get-Service -displayname windows* | Out-ConditionalColor @{Stopped='Red'} status -ov winstop Repeat the previous example, but also save the output to the variable winstop. When you look at $Winstop you'll see the services, but they won't be colorized. This example uses the parameters positionally. -------------------------- EXAMPLE 3 -------------------------- PS C:\> Get-EventLog system -newest 50 | Out-ConditionalColor @{error='red';warning='yellow'} Enter a property name: entrytype Get the newest 50 entries from the System event log. Display errors in red and warnings in yellow. If you don't specify a property you will be prompted. -------------------------- EXAMPLE 4 -------------------------- PS C:\> $c =[ordered]@{ {$psitem.length -ge 1mb}='red'; {$psitem.length -ge 500KB}='yellow'; {$psitem.length -ge 100KB}='cyan'} The first command creates an ordered hashtable based on the Length property. -------------------------- EXAMPLE 5 -------------------------- PS C:\> dir c:\scripts\*.doc,c:\scripts\*.pdf,c:\scripts\*.xml | Out-ConditionalColor $c The next command uses it to get certain file types in the scripts folder and display the selected properties in color depending on the file size. Online Version: http://bit.ly/31SFLZy About_Hash_Tables Show-Tree Out-Copy Out Copy Send command output to the pipeline and clipboard. This command is intended for writers and those who need to document with PowerShell. You can pipe any command to this function and you will get the regular output in your PowerShell session. Simultaneously, a copy of the output will be sent to the Windows clipboard. The copied output will include a prompt constructed from the current location unless you use the CommandOnly parameter. NOTE: You can only capture what is written to the Success pipeline. This command will not copy any other streams such as Verbose, Warning, or Error. Out-Copy InputObject This is the piped in command. Object Object None Width Specifies the number of characters in each line of output. Any additional characters are truncated, not wrapped. Int32 Int32 80 CommandOnly Only copy the executed command, without references to Out-Copy, to the Windows clipboard. SwitchParameter False Ansi Include any Ansi formatting. The default behavior is to capture plain text. SwitchParameter False InputObject This is the piped in command. Object Object None Width Specifies the number of characters in each line of output. Any additional characters are truncated, not wrapped. Int32 Int32 80 CommandOnly Only copy the executed command, without references to Out-Copy, to the Windows clipboard. SwitchParameter SwitchParameter False Ansi Include any Ansi formatting. The default behavior is to capture plain text. SwitchParameter SwitchParameter False System.Object System.Object Learn more about PowerShell:http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-Process | Sort WS -Descending | Select-First 5 | Out-Copy This will execute your expression and write the output to the pipeline. The output plus the command except for the pipe to Out-Copy will be copied to the clipboard. This example is using the Select-First function from the PSScriptTools module. -------------------------- Example 2 -------------------------- PS C:\> Get-Childitem *.ps1 | Out-File c:\work\ps.txt | Out-Copy Even if your command doesn't write anything to the pipeline, Out-Copy will still capture a prompt and PowerShell expression. -------------------------- Example 3 -------------------------- PS C:\> Get-CimInstance -class win32_logicaldisk -filter "drivetype = 3" | Out-Copy -commandonly This will run the Get-CimInstance command and write results to the pipeline. But the only text that will be copied to the clipboard is: Get-CimInstance -class win32_logicaldisk -filter "drivetype = 3" -------------------------- Example 4 -------------------------- PS C:\> Get-Process | Sort WS -Descending | Select-Object -first 5 | Out-Copy -ansi Copy the command and output including any ANSI formatting which you might get in PowerShell 7. Online Version: https://bit.ly/2K6oY1D Out-String Set-Clipboard Tee-Object Copy-HistoryCommand Out-More Out More Send "pages" of objects to the pipeline. This function is designed to display groups or "pages" of objects to the PowerShell pipeline. It is modeled after the legacy More.com command-line utility. By default, the command will write objects out to the pipeline in groups of 50. You will be prompted after each grouping. Pressing M or Enter will get the next group. Pressing A will stop paging and display all of the remaining objects. Pressing N will display the next object. Press Q to stop writing anything else to the pipeline. Note that you may encounter an error message when quitting prematurely, especially on non-Windows platforms. You can ignore these errors. Out-More InputObject Object[] Object[] None Count The number of objects to group as a page. Int32 Int32 50 ClearScreen Clear the screen before writing data to the pipeline. SwitchParameter False InputObject Object[] Object[] None Count The number of objects to group as a page. Int32 Int32 50 ClearScreen Clear the screen before writing data to the pipeline. SwitchParameter SwitchParameter False System.Object System.Object Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ This command was first demonstrated at http://jdhitsolutions.com/blog/powershell/4707/a-better-powershell-more/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Get-Process | Out-More -count 10 Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id SI ProcessName ------- ------ ----- ----- ----- ------ -- -- ----------- 103 9 1448 4220 67 0.02 1632 0 BtwRSupportService 80 9 3008 8588 ...27 21.00 5192 1 conhost 40 5 752 2780 ...82 0.00 5248 0 conhost 53 7 972 3808 ...07 0.02 6876 1 conhost 482 17 1932 3692 56 0.91 708 0 csrss 520 30 2488 134628 180 31.67 784 1 csrss 408 18 6496 12436 ...35 0.56 1684 0 dasHost 180 14 3348 6748 66 0.50 4688 0 devmonsrv \[M\]ore \[A\]ll \[N\]ext \[Q\]uit Display processes in groups of 10. -------------------------- EXAMPLE 2 -------------------------- PS C:\> dir c:\work -file -Recurse | Out-More -ClearScreen | tee -Variable work List all files in C:\Work and page them to Out-More using the default count, but after clearing the screen first. The results are then piped to Tee-Object which saves them to a variable. Online Version: http://bit.ly/31OtYvh more Out-VerboseTee Out VerboseTee Write to the Verbose stream and a file. This command is intended to let you see your verbose output and write the verbose messages to a log file. It will only work if the verbose pipeline is enabled, usually when your command is run with -Verbose. This function is designed to be used within your scripts and functions. You either have to hard code a file name or find some other way to define it in your function or control script. You could pass a value as a parameter or set it as a PSDefaultParameterValue. This command has an alias of Tee-Verbose. You might use it like this in a script. Begin { $log = New-RandomFilename -useTemp -extension log Write-Detail "Starting $($myinvocation.mycommand)" -Prefix begin | Tee-Verbose $log Write-Detail "Logging verbose output to $log" -prefix begin | Tee-Verbose -append Write-Detail "Initializing data array" -Prefix begin | Tee-Verbose $log -append $data = @() } #begin When the command is run with -Verbose you will see the verbose output and it will be saved to the specified log file. Out-VerboseTee Path The path for the output file. String String None Append Append to the specified text file. SwitchParameter False Encoding Specify a file encoding. Encoding Encoding None Value The message to be displayed as a verbose message and saved to the file. Object Object None Append Append to the specified text file. SwitchParameter SwitchParameter False Encoding Specify a file encoding. Encoding Encoding None Path The path for the output file. String String None Value The message to be displayed as a verbose message and saved to the file. Object Object None System.Object System.Object Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> $VerbosePreference= "continue" PS C:\> $log = New-CustomFileName ".\VerboseLog_%time.txt" PS C:\> Write-Detail "This is a verbose log test" | Out-VerboseTee -path $log PS C:\> Get-Content $log 11/29/2020 08:21:31:0704 [PROCESS] This is a verbose log test PS C:\> $verbosePreference = "silentlyContinue" Normally you would use this command inside a function or script, but you can run it from the console if you want to understand how it works. Online Version: http://bit.ly/31SKsTe Write-Verbose Write-Detail Tee-Object Remove-MergedBranch Remove MergedBranch Removed merged git branches. When using git you may create multiple branches. Presumably, you merge these branches into the main or master branch. The development or patching branch remains. You can use git to remove branches. Or use this command to remove all merged branches other than master and the current branch. You must be in the root of your project to run this command. Remove-MergedBranch Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter False Force Remove all merged branches except current and master with no prompting. SwitchParameter False WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter False Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter SwitchParameter False Force Remove all merged branches except current and master with no prompting. SwitchParameter SwitchParameter False WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter SwitchParameter False None String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\MyProject> Remove-MergedBranch Remove merged branch from MyProject? 2.1.1 [Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): n Remove merged branch from MyProject? dev1 [Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): y Deleted branch dev1 (was 75f6ab8). Remove merged branch from MyProject? dev2 [Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): y Deleted branch dev2 (was 75f6ab8). Remove merged branch from MyProject? patch-254 [Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): n PS C:\MyProject> By default you will be prompted to remove each branch. -------------------------- Example 2 -------------------------- PS C:\MyProject> Remove-MergedBranch -force Deleted branch 2.1.1 (was 75f6ab8). Deleted branch patch-254 (was 75f6ab8). Remove all branches with no prompting. Online Version: https://bit.ly/3crxxg9 git.exe Get-GitSize Remove-PSAnsiFileEntry Remove PSAnsiFileEntry Remove a PSAnsiFileMap entry. Use this command to remove an entry from the global $PSAnsiFileMap variable. The change will not be persistent unless you export the map to a file. Remove-PSAnsiFileEntry Description Specify the description of the entry to remove. String String None Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter False Passthru Display the updated PSAnsiFileMap. SwitchParameter False WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter False Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter SwitchParameter False Description Specify the description of the entry to remove. String String None Passthru Display the updated PSAnsiFileMap. SwitchParameter SwitchParameter False WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter SwitchParameter False None PSAnsiFileEntry Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Remove-PSAnsiFileEntry Samples Remove a PSAnsiFileMap entry with a description of 'Samples'. The change will not be persistent unless you export the map to a file. Online Version: https://bit.ly/397cVuZ Set-PSAnsiFileMapEntry Get-PSAnsiFileMapEntry Remove-Runspace Remove Runspace Remove a runspace from your session. When working with PowerShell, you may discover that some commands and scripts can leave behind runspaces. You may even deliberately be creating additional runspaces. These runspaces will remain until you exit your PowerShell session. Or use this command to cleanly close and dispose of runspaces. You cannot remove any runspace with an availability of Busy or that is already closing. This command does not write anything to the pipeline. Remove-Runspace ID The runspace ID number. Int32 Int32 None Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter False WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter False Remove-Runspace Runspace A runspace presumably piped into this command using Get-Runspace. Runspace Runspace None Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter False WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter False Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter SwitchParameter False ID The runspace ID number. Int32 Int32 None Runspace A runspace presumably piped into this command using Get-Runspace. Runspace Runspace None WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter SwitchParameter False System.Management.Automation.Runspaces.Runspace None Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Remove-Runspace -id 18 -WhatIf What if: Performing the operation "Remove-Runspace" on target "18 - Runspace18". Show what would have happened to remove runspace with an ID of 18. -------------------------- Example 2 -------------------------- PS C:\> Get-Runspace | where ID -gt 1 | Remove-Runspace Get all runspaces with an ID greater than 1, which is typically your session, and remove the runspace. Online Version: http://bit.ly/31OJxTC Get-Runspace Rename-Hashtable Rename Hashtable Rename a hashtable key. This command will rename a key in an existing hashtable or ordered dictionary. You can either pipe a hashtable object to this command or you can specify a variable name for a pre-defined hashtable. If you use this option, specify the variable name without the $. This command will create a temporary copy of the hashtable, create the new key, and copy the value from the old key, before removing the old key. The temporary hashtable is then set as the new value for your original variable. This command does not write anything to the pipeline when you use a variable name unless you use -Passthru. If you pipe a hashtable to this command, the new hashtable will automatically be written to the pipeline. You might find this command useful when building a hashtable that you intend to use with splatting where you need to align key names with parameter names. Rename-Hashtable Name The variable name of your hash table. DO NOT include the $. String String None Key The name of the existing hashtable key you want to rename. String String None NewKey The new name of the hashtable key. String String None Passthru Write the revised hashtable back to the pipeline. If you pipe a variable to this command, passthru will happen automatically. SwitchParameter False Scope The scope where your variable is defined. The default is the global scope. String String Global WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter False Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter False Rename-Hashtable InputObject A piped in hashtable object Object Object None Key The name of the existing hashtable key you want to rename. String String None NewKey The new name of the hashtable key. String String None Passthru Write the revised hashtable back to the pipeline. If you pipe a variable to this command, passthru will happen automatically. SwitchParameter False Scope The scope where your variable is defined. The default is the global scope. String String Global WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter False Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter False Name The variable name of your hash table. DO NOT include the $. String String None InputObject A piped in hashtable object Object Object None Key The name of the existing hashtable key you want to rename. String String None NewKey The new name of the hashtable key. String String None Passthru Write the revised hashtable back to the pipeline. If you pipe a variable to this command, passthru will happen automatically. SwitchParameter SwitchParameter False Scope The scope where your variable is defined. The default is the global scope. String String Global WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter SwitchParameter False Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter SwitchParameter False hashtable None Hashtable Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ This code was first described at http://jdhitsolutions.com/blog/2013/01/Rename-Hashtable-key-revised -------------------------- EXAMPLE 1 -------------------------- PS C:\> Rename-Hashtable -name MyHash -key Name -newKey Computername -------------------------- EXAMPLE 2 -------------------------- PS C:\> $newhash = Get-Service spooler | ConvertTo-HashTable | Rename-Hashtable -Key Machinename -NewKey Computername This command uses the ConvertTo-Hashtable command from the PSScriptTools module to turn an object into a hashtable. The Machinename key is then renamed to Computername. Online Version: http://bit.ly/2vxGyUP About_hash_tables ConvertTo-Hashtable Join-Hashtable Save-GitSetup Save GitSetup Download the latest 64bit version of Git for Windows. Non-Windows platforms have package management that make it easy to install newer versions of git. This command is for Windows platforms. You can run this command to download the latest 64bit version of Git for Windows. You will need to manually install it. Save-GitSetup Path Specify the location to store the downloaded file. String String $env:TEMP Passthru Show the downloaded file. SwitchParameter False Passthru Show the downloaded file. SwitchParameter SwitchParameter False Path Specify the location to store the downloaded file. String String $env:TEMP None None System.IO.FileInfo Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- C:\> Save-GitSetup -Path c:\work -Passthru Directory: C:\work Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 12/28/2020 7:29 PM 48578904 Git-2.29.2.3-64-bit.exe Online Version: http://bit.ly/2O8y50B git.exe Select-After Select After Select objects after a given datetime. Select-After is a simplified version of Select-Object. The premise is that you can pipe a collection of objects to this command and select objects after a given datetime, based on a property, like LastWriteTime, which is the default. Select-After After Enter the cutoff date. DateTime DateTime None InputObject A piped in object. PSObject PSObject None Property Enter the property name to use for the datetime sort. It needs to be a datetime object. String String LastWriteTime After Enter the cutoff date. DateTime DateTime None InputObject A piped in object. PSObject PSObject None Property Enter the property name to use for the datetime sort. It needs to be a datetime object. String String LastWriteTime System.Management.Automation.PSObject System.Object Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-Childitem c:\work -file | Select-After "11/1/2020" Directory: C:\work Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 11/4/2020 11:36 AM 5008 ipperf.csv Select all objects that have been modified after 11/1/2020. This example is using the default -Property value of LastWriteTime. -------------------------- Example 2 -------------------------- PS C:\> Get-Process | After (Get-Date).AddMinutes(-10) -Property StartTime NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName ------ ----- ----- ------ -- -- ----------- 8 1.49 7.17 0.00 33248 0 SearchFilterHost 12 2.46 12.99 0.02 15328 0 SearchProtocolHost 8 2.60 8.58 0.03 9756 0 svchost 76 20.27 39.93 2.14 22976 0 svchost 8 1.53 7.29 0.00 29752 0 svchost Get all processes where the StartTime property value is within the last 10 minutes. This example is using the "after" alias. Online Version: http://bit.ly/3phhAAm Select-Before Select-Object Select-Before Select Before Select objects before a given datetime. Select-Before is a simplified version of Select-Object. The premise is that you can pipe a collection of objects to this command and select objects before a given datetime, based on a property, like LastWriteTime, which is the default. Select-Before Before Enter the cutoff date. DateTime DateTime None InputObject A piped in object. PSObject PSObject None Property Enter the property name to use for the datetime sort. It needs to be a datetime object. String String LastWritetime Before Enter the cutoff date. DateTime DateTime None InputObject A piped in object. PSObject PSObject None Property Enter the property name to use for the datetime sort. It needs to be a datetime object. String String LastWritetime System.Management.Automation.PSObject System.Object Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-Childitem c:\work -file | Select-Before "11/1/2020" Directory: C:\work Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 10/10/2020 2:09 PM 8862 Book1.xlsx -a--- 10/30/2020 10:48 AM 0 dummy.dat -a--- 10/13/2020 9:35 AM 447743 key1013.pdf -a--- 10/6/2020 4:03 PM 2986 labsummary.format.ps1xml -a--- 10/11/2020 12:33 PM 1678 prun.format.ps1xml -a--- 10/10/2020 6:49 PM 1511 w.format.ps1xml Select all objects that have been modified before 11/1/2020. This example is using the default -Property value of LastWriteTime. -------------------------- Example 2 -------------------------- PS C:\> Get-Process | before (Get-Date).AddMinutes(-10) -Property StartTime NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName ------ ----- ----- ------ -- -- ----------- 33 30.21 46.19 0.81 9952 2 ApplicationFrameHost 75 102.42 126.08 4.89 16048 2 Box 23 25.27 33.83 0.33 5320 0 Box.Desktop.UpdateService 30 46.92 60.98 0.91 17384 2 BoxUI 31 39.82 4.34 0.56 26992 2 Calculator ... Get all processes where the StartTime property value is before the last 10 minutes. This example is using the "before" alias. Online Version: https://bit.ly/3nkqnjm Select-After Select-Object Select-First Select First Select the first X number of objects. This command is intended to take pipelined input and select the first specified number of objects which are then written to the pipeline. You also have the option to sort on a specified property. When using this command, there is a trade-off of convenience for performance. For a very large number of processed objects, use Select-Object. Select-First First How many items do you want to select? Int32 Int32 0 Property Sort first on this property then select the specified number of items. String String None InputObject Pipelined input to be selected. PSObject PSObject None Skip Skip or omit the first X number of items. Int32 Int32 0 Descending Sort the property in descending order. SwitchParameter False InputObject Pipelined input to be selected. PSObject PSObject None First How many items do you want to select? Int32 Int32 0 Property Sort first on this property then select the specified number of items. String String None Skip Skip or omit the first X number of items. Int32 Int32 0 Descending Sort the property in descending order. SwitchParameter SwitchParameter False Object[] Object[] Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Get-Process | Select-First 3 -property WS -descending Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id SI ProcessName ------- ------ ----- ----- ----- ------ -- -- ----------- 1118 66 419952 392396 ...12 107.33 7312 1 powershell 343 43 237928 235508 1237 3,905.22 6424 1 slack 1051 88 231216 234728 1175 61.88 8324 1 powershell_ise -------------------------- EXAMPLE 2 -------------------------- PS C:\> 1..10 | Select-First 3 -Skip 2 3 4 5 Select the first 3 objects after skipping 2. Online Version: http://bit.ly/31VhYb9 Select-Object Select-Last Select-Last Select Last Select the last X number of objects. This is a modified version of Select-Object designed to select the last X number of objects. The command takes pipelined input and selects the last specified number of objects which are then written to the pipeline. You have an option to first sort on the specified property. When using this command, there is a trade-off of convenience for performance. For a very large number of processed objects, use Select-Object. Select-Last Last How many items do you want to select? Int32 Int32 0 Property Sort first on this property then select the specified number of items. String String None InputObject Pipelined input to be selected. PSObject PSObject None Skip Skip or omit the last X number of items. Int32 Int32 0 Descending Sort on the specified property in descending order. SwitchParameter False InputObject Pipelined input to be selected. PSObject PSObject None Last How many items do you want to select? Int32 Int32 0 Property Sort first on this property then select the specified number of items. String String None Skip Skip or omit the last X number of items. Int32 Int32 0 Descending Sort on the specified property in descending order. SwitchParameter SwitchParameter False Object[] Object[] Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> dir c:\scripts\*.ps1 | last 5 -property lastwritetime Directory: C:\scripts Mode LastWriteTime Length Name ---- ------------- ------ ---- -a---- 1/11/2020 7:18 PM 1818 demo-v5Classes.ps1 -a---- 1/11/2020 7:20 PM 1255 demo-v5DSCClassResource.ps1 -a---- 1/14/2020 12:58 PM 1967 Demo-ParamTest.ps1 -a---- 1/15/2020 9:23 AM 971 Get-WorkflowVariable.ps1 -a---- 1/15/2020 12:08 PM 1555 Cost.ps1 Get the last 5 ps1 files sorted on the LastWritetime property. This example is using the alias 'last' for Select-Last. -------------------------- EXAMPLE 2 -------------------------- PS C:\> 1..10 | Select-Last 3 -skip 1 7 8 9 Select the last 3 items, skipping the last 1. Online Version: http://bit.ly/31SGKce Select-Object Select-First Select-Newest Select Newest Select the newest X number of objects after a given datetime. Select-Newest is a variation on Select-Object. It is designed to make it easier to select X number of objects based on a datetime property. The default property value is LastWriteTime. Select-Newest Newest Enter the number of newest items to select. Int32 Int32 None InputObject A piped in object. PSObject PSObject None Property Enter the property name to select on. It must be a datetime object. String String LastWriteTime InputObject A piped in object. PSObject PSObject None Newest Enter the number of newest items to select. Int32 Int32 None Property Enter the property name to select on. It must be a datetime object. String String LastWriteTime System.Management.Automation.PSObject System.Object Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-ChildItem c:\work -file | Select-Newest 1 Directory: C:\work Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 11/4/2020 11:36 AM 5008 ipperf.csv Get the newest file in the Work folder. This example is using the default -Property parameter value of LastWriteTime. -------------------------- Example 2 -------------------------- PS C:\> Get-Process | newest 10 -Property starttime NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName ------ ----- ----- ------ -- -- ----------- 15 5.34 12.85 0.09 25208 0 WmiPrvSE 7 1.31 5.95 0.02 10552 0 svchost 35 128.28 136.05 8.62 3376 0 esrv_svc 98 47.31 40.01 0.48 24496 2 firefox 99 48.46 46.07 0.53 22064 2 firefox 13 3.41 16.19 0.77 33136 2 notepad 14 6.78 10.96 0.06 31784 0 svchost 69 110.45 150.37 4.28 8848 2 pwsh 5 2.52 4.52 0.02 34024 2 cmd 10 2.06 9.00 0.12 25384 2 OpenConsole Get the 10 most recent processes based on the StartTime property. This example is using the "newest" alias. Online Version: http://bit.ly/36x3YIG Select-Oldest Select-Object Select-Oldest Select Oldest Select the oldest X number of objects before a given datetime. Select-Oldest is a variation on Select-Object. It is designed to make it easier to select X number of objects based on a datetime property. The default property value is LastWriteTime. Select-Oldest Oldest Enter the number of Oldest items to select. Int32 Int32 None InputObject A piped in object. PSObject PSObject None Property Enter the property name to select on. It must be a datetime object. String String None InputObject A piped in object. PSObject PSObject None Oldest Enter the number of Oldest items to select. Int32 Int32 None Property Enter the property name to select on. It must be a datetime object. String String None System.Management.Automation.PSObject System.Object Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Get-ChildItem c:\work -file | Select-oldest 1 Directory: C:\work Mode LastWriteTime Length Name ---- ------------- ------ ---- -a--- 10/6/2020 4:03 PM 2986 labsummary.format.ps1xml Get the oldest file in the Work folder. This example is using the default -Property parameter value of LastWriteTime. -------------------------- Example 2 -------------------------- PS C:\> Get-Process | where-object name -notmatch "idle|System" | oldest 10 -Property starttime NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName ------ ----- ----- ------ -- -- ----------- 16 8.43 99.83 2.27 204 0 Registry 3 1.03 1.12 0.44 712 0 smss 30 2.23 5.67 4.23 816 0 csrss 11 1.52 6.65 0.02 1592 0 wininit 11 6.55 11.63 25.33 1676 0 services 7 1.10 3.27 0.09 1696 0 LsaIso 28 9.81 24.70 29.61 1704 0 lsass 4 0.81 3.31 0.00 1824 0 svchost 26 13.48 30.38 22.62 1852 0 svchost 6 1.91 4.15 0.11 1876 0 fontdrvhost Get the oldest 10 processes that don't include Idle or System. This example is using the "oldest" alias. Online Version: https://bit.ly/2IyQPqx Select-Newest Select-Object Set-ConsoleColor Set ConsoleColor Set the PowerShell console color. You can use this command to modify the PowerShell console's foreground and/or background color. If you are running the PSReadline module, that module has its own commands, like Set-PSReadLineOption, that you can use to modify your console. Set-ConsoleColor is designed for use in a traditional PowerShell console. It will not work in consoles that are part of the PowerShell ISE or Visual Studio Code. Set-ConsoleColor Foreground Specify a foreground console color. Black DarkBlue DarkGreen DarkCyan DarkRed DarkMagenta DarkYellow Gray DarkGray Blue Green Cyan Red Magenta Yellow White ConsoleColor ConsoleColor None Background Specify a background console color Black DarkBlue DarkGreen DarkCyan DarkRed DarkMagenta DarkYellow Gray DarkGray Blue Green Cyan Red Magenta Yellow White ConsoleColor ConsoleColor None ClearScreen Clear the console host screen. SwitchParameter False Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter False Passthru Display the foreground and background color values. SwitchParameter False WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter False Background Specify a background console color ConsoleColor ConsoleColor None ClearScreen Clear the console host screen. SwitchParameter SwitchParameter False Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter SwitchParameter False Foreground Specify a foreground console color. ConsoleColor ConsoleColor None Passthru Display the foreground and background color values. SwitchParameter SwitchParameter False WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter SwitchParameter False None None Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Set-ConsoleColor -foreground Yellow -background DarkGray -clear Set the console color to yellow text and on a dark gray background. Online Version: http://bit.ly/31SMpPn Set-ConsoleTitle Set-ConsoleTitle Set ConsoleTitle Set the console title text. Use this command to modify the text displayed in the title bar of your PowerShell console window. This command is intended for use in a traditional PowerShell console. It will not work in consoles that are part of the PowerShell ISE or Visual Studio Code. It should work in a PowerShell session running in Windows Terminal. Set-ConsoleTitle Title Enter the title for the console window. String String None Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter False WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter False Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter SwitchParameter False Title Enter the title for the console window. String String None WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter SwitchParameter False None None Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Set-ConsoleTitle $env:computername Set the console title to the computer name. -------------------------- Example 2 -------------------------- PS C:\> if (Test-IsAdministrator) { Set-ConsoleTitle "Admin: PS $($PSVersionTable.PSVersion)" } Modify the console title if running as Administrator Online Version: http://bit.ly/31SHb6m Set-ConsoleColor Set-LocationToFile Set LocationToFile Change script editor terminal location. This command will only be available if you import the PSScriptTools module into an integrated PowerShell terminal in Visual Studio Code or the PowerShell ISE. It is designed to set the location of the terminal to the same directory as the active file. Run the command or its aliases in the integrated terminal. Use the aliases sd or jmp. Set-LocationToFile None None -------------------------- Example 1 -------------------------- PS D:\> sd PS C:\Scripts\Foo\> Use the sd alias in the integrated terminal window to change location to the directory of the active file in Visual Studio Code or the PowerShell ISE. This will also clear the host. Online Version: https://bit.ly/3zE4LFO Set-Location Set-PSAnsiFileMap Set PSAnsiFileMap Modify or add a PSAnsiFileEntry Use this command to modify an existing entry in the global $PSAnsiFileMap variable or add a new entry. If modifying, you must specify a regular expression pattern or an ANSI escape sequence. If you are adding a new entry, you need to supply both values. Set-PSAnsiFileMap Description Specify the file map entry. If it is a new entry it will be added. String String None Ansi Specify an ANSI escape sequence. You only need to define the opening sequence. String String None Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter False Passthru Display the updated map. SwitchParameter False Pattern Specify a regular expression pattern for the file name. String String None WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter False Ansi Specify an ANSI escape sequence. You only need to define the opening sequence. String String None Confirm Prompts you for confirmation before running the cmdlet. SwitchParameter SwitchParameter False Description Specify the file map entry. If it is a new entry it will be added. String String None Passthru Display the updated map. SwitchParameter SwitchParameter False Pattern Specify a regular expression pattern for the file name. String String None WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. SwitchParameter SwitchParameter False None PSAnsiFileEntry Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Set-PSAnsiFileMap Temporary -Ansi "`e[38;5;190m" Update the ANSI pattern for temporary files. This change will not persist unless you export the map. -------------------------- Example 2 -------------------------- PS C:\> Set-PSAnsiFileMap -Description "Config" -Pattern "\.(yml)$" -Ansi "`e[38;5;25m"ge Add a new PSAnsiFileMap entry. This change will not persist unless you export the map. Online Version: https://bit.ly/394kL8m Get-PSAnsiFileMap Remove-PSAnsiFileEntry Export-PSAnsiFileMap Show-ANSISequence Show ANSISequence Display ANSI escape sequences This script is designed to make it easy to see ANSI escape sequences and how they will display in your PowerShell session. Use the -AsString parameter to write simple strings to the pipeline which makes it easier to copy items to the clipboard. The escape character will depend on whether you are running Windows PowerShell or PowerShell 7.x. For best results, you need to run this command in a PowerShell session and host that supports ANSI escape sequences. Show-ANSISequence Basic Display basic ANSI settings. This is the default output. SwitchParameter False AsString Show the value as an unformatted string. SwitchParameter False Show-ANSISequence Foreground Display foreground ANSI format settings. If you use -Type without specifying -Foreground or -Background, -Foreground will be used by default. SwitchParameter False Background Display background ANSI format settings. SwitchParameter False Type You can display simple ANSI, 8-bit, or all sequences. Valid values are All,Simple and 8bit. String String All AsString Show the value as an unformatted string. SwitchParameter False Show-ANSISequence RGB Display an RGB ANSI sequence. You must pass an array of values for Red,Blue, and Green. Each value must be between 0 and 255. Int32[] Int32[] None AsString Show the value as an unformatted string. SwitchParameter False Basic Display basic ANSI settings. This is the default output. SwitchParameter SwitchParameter False Foreground Display foreground ANSI format settings. If you use -Type without specifying -Foreground or -Background, -Foreground will be used by default. SwitchParameter SwitchParameter False Background Display background ANSI format settings. SwitchParameter SwitchParameter False Type You can display simple ANSI, 8-bit, or all sequences. Valid values are All,Simple and 8bit. String String All RGB Display an RGB ANSI sequence. You must pass an array of values for Red,Blue, and Green. Each value must be between 0 and 255. Int32[] Int32[] None AsString Show the value as an unformatted string. SwitchParameter SwitchParameter False None System.String Learn more about ANSI sequences at https://en.wikipedia.org/wiki/ANSI_escape_code Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Show-ANSISequence ******************* * Basic Sequences * ******************* `e[9mCrossedOut`e[0m `e[7mReverse`e[0m `e[6mRapidBlink`e[0m `e[5mSlowBlink`e[0m `e[4mUnderline`e[0m `e[3mItalic`e[0m `e[2mFaint`e[0m `e[1mBold`e[0m The output will be formatted using the corresponding ANSI escape sequence as seen in PowerShell 7.x. -------------------------- EXAMPLE 2 -------------------------- PS C:\> Show-ANSISequence -Foreground -Type simple ************** * Foreground * ************** `e[30mHello`e[0m `e[31mHello`e[0m `e[32mHello`e[0m `e[34mHello`e[0m `e[35mHello`e[0m `e[36mHello`e[0m `e[90mHello`e[0m `e[91mHello`e[0m `e[92mHello`e[0m `e[94mHello`e[0m `e[95mHello`e[0m `e[96mHello`e[0m -------------------------- EXAMPLE 3 -------------------------- PS C:\> Show-ANSISequence -RGB 225,100,50 `e[38;2;225;100;50m256 Color (R:225)(G:100)(B:50)`e[0m Show an RGB ANSI sequence. The output will be formatted using the sequence. -------------------------- EXAMPLE 4 -------------------------- PS C:\> Show-ANSISequence -RGB 225,100,50 -AsString | Set-Clipboard Repeat the previous example but write the output as a plain string and copy it to the clipboard. Online Version: https://bit.ly/3Ix5s77 Write-ANSIProgress New-ANSIBar Show-FunctionItem Show FunctionItem Show a function in written form. This command will display a loaded function as it might look in a code editor. You could use this command to export a loaded function to a file. Show-FunctionItem Name What is the name of your function? String String None Name What is the name of your function? String String None String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Show-FunctionItem prompt Function Prompt { "PS $($executionContext.SessionState.Path.CurrentLocation)$('\>' * ($nestedPromptLevel + 1)) "; # .Link # https://go.microsoft.com/fwlink/?LinkID=225750 # .ExternalHelp System.Management.Automation.dll-help.xml } #close prompt -------------------------- EXAMPLE 2 -------------------------- PS C:\> Show-FunctionItem Copy-Zip | Out-File c:\Scripts\copy-zip.ps1 Here's how you can save or export a function you might have created on-the-fly to a file. Online Version: https://bit.ly/3qqnX5p New-FunctionItem Show-Tree Show Tree Shows the specified path as a tree. Shows the specified path as a graphical tree in the console. Show-Tree is intended as a PowerShell alternative to the tree DOS command. This function should work for any type of PowerShell provider and can be used to explore providers used for configuration like the WSMan provider or the registry. Currently, this will not work with any PSDrives created with the Certificate provider. It should work cross-platform. By default, the output will only show directory or equivalent structures. But you can opt to include items well as item details by using the ShowProperty parameter. Specify a comma-separated list of properties or use * to view them all. If the Path is a FileSystem path there is a dynamic parameter, -InColor, that will write ANSI-colored output to the pipeline. This parameter has an alias of ansi. Note: This is an update to an older function in my library. I seem to recall I found the original code somewhere online, perhaps from someone like Lee Holmes. Sadly, I neglected to record the source. Show-Tree Path The path to the root of the tree that will be shown. String[] String[] current location Depth Specifies how many levels of the specified path are recursed and shown. Int32 Int32 2147483647 IndentSize The size of the indent per level. The default is 3. The minimum value is 1. You shouldn't have to modify this parameter. Int32 Int32 3 ShowItem Shows the items in each container or folder. SwitchParameter False ShowProperty Shows the properties on containers and items. Use * to display all properties otherwise specify a comma separated list. String[] String[] False InColor Show tree and item colorized. Values are from the $PSAnsiMap variable. SwitchParameter False Show-Tree LiteralPath Use a literal path value. String[] String[] None Depth Specifies how many levels of the specified path are recursed and shown. Int32 Int32 2147483647 IndentSize The size of the indent per level. The default is 3. The minimum value is 1. You shouldn't have to modify this parameter. Int32 Int32 3 ShowItem Shows the items in each container or folder. SwitchParameter False ShowProperty Shows the properties on containers and items. Use * to display all properties otherwise specify a comma separated list. String[] String[] False InColor Show tree and item colorized. Values are from the $PSAnsiMap variable. SwitchParameter False Path The path to the root of the tree that will be shown. String[] String[] current location LiteralPath Use a literal path value. String[] String[] None Depth Specifies how many levels of the specified path are recursed and shown. Int32 Int32 2147483647 IndentSize The size of the indent per level. The default is 3. The minimum value is 1. You shouldn't have to modify this parameter. Int32 Int32 3 ShowItem Shows the items in each container or folder. SwitchParameter SwitchParameter False ShowProperty Shows the properties on containers and items. Use * to display all properties otherwise specify a comma separated list. String[] String[] False InColor Show tree and item colorized. Values are from the $PSAnsiMap variable. SwitchParameter SwitchParameter False System.String System.String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Show-Tree C:\Work -Depth 2 C:\work +--A | \--B +--dnssuffix | +--docs | +--en-us | \--images +--gpo | +--{65D9E940-AAD4-4508-A199-86EAE4E9E535} | \--{7E7F01CE-6889-44B0-9D03-818F8284EDE0} +--installers +--remoteop | \--archive +--test files \--tryme +--.vscode +--docs +--en-us \--test Shows the directory tree structure, recursing down two levels. -------------------------- EXAMPLE 2 -------------------------- PS C:\>Show-Tree HKLM:\SOFTWARE\Microsoft\.NETFramework -Depth 2 -ShowProp * HKLM:\SOFTWARE\Microsoft\.NETFramework +-- Enable64Bit = 1 +-- InstallRoot = C:\Windows\Microsoft.NET\Framework64\ +-- UseRyuJIT = 1 +--Advertised | +--Policy | \--v2.0.50727 +--AssemblyFolders | +--ADOMD.Client 14.0 | | \-- (default) = C:\Program Files\Microsoft.NET\ADOMD.NET\140\ | +--Microsoft .NET Framework 3.5 Reference Assemblies | | \-- (default) = C:\Program Files\Reference Assemblies\Microsoft\Framew... | +--SQL Server Assemblies 140 | | \-- (default) = C:\Program Files\Microsoft SQL Server\140\SDK\Assemblies\ | +--v3.0 | | +-- <IncludeDotNet2Assemblies> = 1 | | \-- All Assemblies In = C:\Program Files\Reference Assemblies\Microsof... | \--v3.5 | +-- <IncludeDotNet2Assemblies> = 1 | \-- All Assemblies In = C:\Program Files\Reference Assemblies\Microsof... ... Shows the hierarchy of registry keys and values (-ShowProperty), recursing down two levels. -------------------------- EXAMPLE 3 -------------------------- PS C:\> Show-Tree WSMan: -ShowItem WSMan:\ \--localhost +--MaxEnvelopeSizekb +--MaxTimeoutms +--MaxBatchItems +--MaxProviderRequests +--Client | +--NetworkDelayms | +--URLPrefix | +--AllowUnencrypted | +--Auth | | +--Basic | | +--Digest | | +--Kerberos | | +--Negotiate ... Shows all the containers and items in the WSMan: drive. -------------------------- Example 4 -------------------------- PS C:\> pstree c:\work\alpha -files -properties LastWriteTime,Length -ansi C:\work\Alpha\ +-- LastWriteTime = 02/28/2020 11:19:32 +--bravo | +-- LastWriteTime = 02/28/2020 11:20:30 | +--delta | | +-- LastWriteTime = 02/28/2020 11:17:35 | | +--FunctionDemo.ps1 | | | +-- Length = 888 | | | \-- LastWriteTime = 06/01/2009 15:50:47 | | +--function-form.ps1 | | | +-- Length = 1117 | | | \-- LastWriteTime = 04/17/2019 17:18:28 | | +--function-logstamp.ps1 | | | +-- Length = 598 | | | \-- LastWriteTime = 05/23/2007 11:39:55 | | +--FunctionNotes.ps1 | | | +-- Length = 617 | | | \-- LastWriteTime = 02/24/2016 08:59:03 | | \--Function-SwitchTest.ps1 | | +-- Length = 242 | | \-- LastWriteTime = 06/09/2008 15:55:44 | +--gamma ... Show a tree listing with files including a few user-specified properties in color. This example is using parameter and command aliases. Online Version: http://bit.ly/31RilUa tree.com Get-ChildItem Test-EmptyFolder Test EmptyFolder Test if a folder is empty of files. This command will test if a given folder path is empty of all files anywhere in the path. This includes hidden files. The command will return True even if there are empty sub-folders. The default output is True or False but you can use -Passthru to get more information. See examples. Test-EmptyFolder Path Enter a file system path like C:\Scripts. String[] String[] None Passthru Write a test object to the pipeline. SwitchParameter False Passthru Write a test object to the pipeline. SwitchParameter SwitchParameter False Path Enter a file system path like C:\Scripts. String[] String[] None System.String[] Boolean EmptyFolder Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Test-EmptyFolder c:\work False Test a single folder from a parameter. -------------------------- Example 2 -------------------------- PS C:\> Get-ChildItem c:\work -Directory | Test-EmptyFolder -passthru Path Name IsEmpty Computername ---- ---- ------- ------------ C:\work\A A False DESK10 C:\work\alpha alpha False DESK10 C:\work\B B True DESK10 C:\work\data data False DESK10 C:\work\demo3 demo3 True DESK10 C:\work\demos demos False DESK10 ... Test child folders under C:\work. -------------------------- Example 3 -------------------------- PS C:\> Get-ChildItem c:\work -Directory | Test-EmptyFolder -passthru | Where-object {$_.Isempty} | Foreach-Object { Remove-Item -LiteralPath $_.path -Recurse -force -whatif} What if: Performing the operation "Remove Directory" on target "C:\work\demo3". What if: Performing the operation "Remove Directory" on target "C:\work\installers". What if: Performing the operation "Remove Directory" on target "C:\work\new". What if: Performing the operation "Remove Directory" on target "C:\work\sqlback". What if: Performing the operation "Remove Directory" on target "C:\work\todd". What if: Performing the operation "Remove Directory" on target "C:\work\[data]". Find all empty sub-folders under C:\Work and pipe them to Remove-Item. This is one way to remove empty folders. The example is piping objects to ForEach-Object so that Remove-Item can use the -LiteralPath parameter, because C:\work[data] is a non-standard path. Online Version: http://bit.ly/2Vtk3ew Get-FolderSizeInfo Test-Expression Test Expression Test a PowerShell expression over a period of time. This command will test a PowerShell expression or scriptblock for a specified number of times and calculate the average runtime, in milliseconds, over all the tests. The output will also show the median and trimmed values. The median is calculated by sorting the values in ascending order and selecting the value in the center of the array. If the array has an even number of elements then the median is the average of the two values in the center. The trimmed value will toss out the lowest and highest values and average the remaining values. This may be the most accurate indication as it will eliminate any small values which might come from caching and any large values which may come a temporary shortage of resources. You will only get a value if you run more than 1 test. Test-Expression Expression The scriptblock you want to test. ScriptBlock ScriptBlock None ArgumentList An array of parameters to pass to the test scriptblock. Arguments are positional. If passing an array for a value enter with @(). Object[] Object[] None AsJob Run the tests as a background job. SwitchParameter False Count The number of times to test the scriptblock. Int32 Int32 1 IncludeExpression Include the test scriptblock in the output. SwitchParameter False Interval How much time to sleep in seconds between each test. The maximum value is 60. You may want to use a sleep interval to mitigate possible caching effects. Double Double 0.5 Test-Expression Expression The scriptblock you want to test. ScriptBlock ScriptBlock None ArgumentList An array of parameters to pass to the test scriptblock. Arguments are positional. If passing an array for a value enter with @(). Object[] Object[] None AsJob Run the tests as a background job. SwitchParameter False Count The number of times to test the scriptblock. Int32 Int32 1 IncludeExpression Include the test scriptblock in the output. SwitchParameter False RandomMaximum You can also specify a random interval by providing random minimum and maximum values in seconds. Double Double 0 RandomMinimum You can also specify a random interval by providing random minimum and maximum values in seconds. Double Double 0 ArgumentList An array of parameters to pass to the test scriptblock. Arguments are positional. If passing an array for a value enter with @(). Object[] Object[] None AsJob Run the tests as a background job. SwitchParameter SwitchParameter False Count The number of times to test the scriptblock. Int32 Int32 1 Expression The scriptblock you want to test. ScriptBlock ScriptBlock None IncludeExpression Include the test scriptblock in the output. SwitchParameter SwitchParameter False Interval How much time to sleep in seconds between each test. The maximum value is 60. You may want to use a sleep interval to mitigate possible caching effects. Double Double 0.5 RandomMaximum You can also specify a random interval by providing random minimum and maximum values in seconds. Double Double 0 RandomMinimum You can also specify a random interval by providing random minimum and maximum values in seconds. Double Double 0 scriptblock TestResult Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ This command was first described at https://github.com/jdhitsolutions/Test-Expression/blob/master/docs/Test-Expression.md) -------------------------- Example 1 -------------------------- PS C:\> $cred = Get-credential globomantics\administrator PS C:\> $c = "chi-dc01","chi-dc04" PS C:\> Test-Expression { param ([string[]]$computer,$cred) get-wmiobject win32_logicaldisk -computername $computer -credential $cred } -argumentList $c,$cred Tests : 1 TestInterval : 0.5 AverageMS : 1990.6779 MinimumMS : 1990.6779 MaximumMS : 1990.6779 MedianMS : 1990.6779 TrimmedMS : PSVersion : 5.1.19041.1 OS : Microsoft Windows 10 Pro Test a command once passing an argument to the scriptblock. There is no TrimmedMS value because there was only one test. -------------------------- Example 2 -------------------------- PS C:\> $sb = {1..1000 | Foreach-Object {$_*2}} PS C:\> Test-Expression $sb -count 10 -interval 2 Tests : 10 TestInterval : 2 AverageMS : 72.78199 MinimumMS : 29.4449 MaximumMS : 110.6553 MedianMS : 90.3509 TrimmedMS : 73.4649625 PSVersion : 5.1.19041.1 OS : Microsoft Windows 10 Pro PS C:\> $sb2 = { foreach ($i in (1..1000)) {$_*2}} PS C:\> Test-Expression $sb2 -Count 10 -interval 2 Tests : 10 TestInterval : 2 AverageMS : 6.40283 MinimumMS : 0.7466 MaximumMS : 22.968 MedianMS : 2.781 TrimmedMS : 5.0392125 PSVersion : 5.1.19041.1 OS : Microsoft Windows 10 Pro These examples are testing two different approaches that yield the same results over a span of 10 test runs, pausing for 2 seconds between each test. The values for Average, Minimum, and Maximum are in milliseconds. -------------------------- Example 3 -------------------------- PS C:\> Test-Expression { Param([string]$computer) Get-Service bits,wuauserv,winrm -computername $computer } -count 5 -IncludeExpression -argumentList chi-hvr2 Tests : 5 TestInterval : 500 AverageMS : 15.53376 MinimumMS : 11.6745 MaximumMS : 24.9331 MedianMS : 13.8928 TrimmedMS : 13.6870666666667 PSVersion : 5.1.19041.1 OS : Microsoft Windows 10 Pro Expression : Param([string]$computer) get-service bits,wuauserv,winrm -com... Arguments : {chi-hvr2} Include the tested expression in the output. -------------------------- Example 4 -------------------------- PS C:\> $j=Test-Expression { get-eventlog -list } -count 10 -Interval 5 -AsJob PS C:\> $j | Receive-Job -keep Tests : 10 TestInterval : 5 AverageMS : 2.80256 MinimumMS : 0.7967 MaximumMS : 14.911 MedianMS : 1.4469 TrimmedMS : 1.5397375 PSVersion : 5.1.19041.1 OS : Microsoft Windows 10 Pro RunspaceId : f30eb879-fe8f-4ad0-8d70-d4c8b6b4eccc Run the test as a background job. When the job is complete, get the results. -------------------------- Example 5 -------------------------- PS C:\>{1..1000} | Test-Expression -count 10 -RandomMinimum 1 -RandomMaximum 10 Tests : 10 TestInterval : Random AverageMS : 0.63899 MinimumMS : 0.2253 MaximumMS : 3.9062 MedianMS : 0.24475 TrimmedMS : 0.2823 PSVersion : 5.1.19041.1 OS : Microsoft Windows 10 Pro Pipe a scriptblock to be tested. Online Version: http://bit.ly/31Vi0zN Measure-Command Test-ExpressionForm Test-ExpressionForm Test ExpressionForm Display a graphical test form for Test-Expression. This command will display a WPF-based form that you can use to enter in testing information. Testing intervals are in seconds. All of the values are then passed to the Test-Expression command. Results will be displayed in the form. The results only show you how long the tests took, regardless of whether or not there were errors. When you close the form, the last result object will be passed to the pipeline, including all metadata, the scriptblock, and arguments. This command requires a Windows platform that supports WPF. Test-ExpressionForm None System.Object Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ This command was first explained at https://github.com/jdhitsolutions/Test-Expression/blob/master/docs/Test-ExpressionForm.md -------------------------- Example 1 -------------------------- PS C:\> test-expressionform Launch the form. Online Version: http://bit.ly/31TAilb Test-Expression Measure-Command Test-IsElevated Test IsElevated Test if the current user is running elevated. This command will test if the current session is running elevated, or as Administrator. On Windows platforms, the command uses the NET Framework to determine if the user is running as Administrator. On non-Windows systems, the command is checking the user's UID value. Test-IsElevated None Boolean Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Test-IsElevated True Online Version: https://bit.ly/2Uy3Vu5 Get-PSWho Test-IsPSWindows Test IsPSWindows Test if running PowerShell on a Windows platform. PowerShell Core introduced the $IsWindows variable. However, it is not available on Windows PowerShell. Use this command to perform a simple test if the computer is either running Windows or using the Desktop PSEdition. Test-IsPSWindows None System.Boolean Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Test-IsPSWindows True Online Version: http://bit.ly/2GBPriA Test-WithCulture Test WithCulture Test your PowerShell code using a different culture. When writing PowerShell commands, sometimes the culture you are running under becomes critical. For example, European countries use a different datetime format than North Americans which might present a problem with your script or command. Unless you have a separate computer running under the foreign culture, it is difficult to test. This command will allow you to test a scriptblock or even a file under a different culture, such as DE-DE for German. Note that this command is not an absolute test. There may be commands that fail to produce the alternate culture results you expect. Test-WithCulture Culture Enter a new culture like de-de CultureInfo CultureInfo None ArgumentList Specify an array of positional arguments to pass to the scriptblock for file. Object[] Object[] None FilePath Enter the path to a PowerShell script file to execute using the specified culture. ScriptBlock ScriptBlock None Test-WithCulture Culture Enter a new culture like de-de CultureInfo CultureInfo None Scriptblock Enter a scriptblock to execute using the specified culture. Be aware that long or complex pipelined expressions might not give you the culture-specific results you expect. ScriptBlock ScriptBlock None ArgumentList Specify an array of positional arguments to pass to the scriptblock for file. Object[] Object[] None ArgumentList Specify an array of positional arguments to pass to the scriptblock for file. Object[] Object[] None Culture Enter a new culture like de-de CultureInfo CultureInfo None FilePath Enter the path to a PowerShell script file to execute using the specified culture. ScriptBlock ScriptBlock None Scriptblock Enter a scriptblock to execute using the specified culture. Be aware that long or complex pipelined expressions might not give you the culture-specific results you expect. ScriptBlock ScriptBlock None None System.Object Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Test-WithCulture de-de -Scriptblock {(Get-Date).addDays(90)} Montag, 14. Oktober 2020 08:59:01 --------------------------- Example2 --------------------------- PS C\> Test-WithCulture fr-fr -Scriptblock { Get-winEvent -log system -max 500 | Select-Object -Property TimeCreated,ID,OpCodeDisplayname,Message | Sort-Object -property TimeCreated | Group-Object {$_.timecreated.toshortdatestring()} -noelement } Count Name ----- ---- 165 10/07/2020 249 11/07/2020 17 12/07/2020 16 13/07/2020 20 14/07/2020 26 15/07/2020 7 16/07/2020 Online Version: http://bit.ly/31TyFnk Get-Culture Get-UICulture Trace-Message Trace Message Create a graphical trace window. Trace-Message is designed to be used with script or function. Its purpose is to create a graphical trace window using Windows Presentation Foundation. Inside the function or script, you can use this command to send messages to the window. When finished, you have an option to save the output to a text file. There are 3 steps to using this function. First, in your code, you need to create a boolean global variable called TraceEnabled. When the value is $True, the Trace-Message command will run. When set to false, the command will be ignored. Second, you need to initialize a form, specifying the title and dimensions. The form will automatically include some pre-defined metadata. Finally, you can send trace messages to the window. All messages are prepended with a timestamp. This command is not optimized for performance and is intended for development purposes. When your code is finished, you can set $TraceEnabled to $False. If you need to troubleshoot, you can set it to $True. Trace-Message BackgroundColor Specify a background color for the trace window. You can use console colors like "Cyan" or HTML color codes. String String "#FFFFF8DC", Height Specify the Width of the trace window. Int32 Int32 500 Title Specify a title for the trace window. String String "Trace Messages" Width Specify the Width of the trace window. Int32 Int32 800 Trace-Message Message Specify a message to write to the trace window. String String None BackgroundColor Specify a background color for the trace window. You can use console colors like "Cyan" or HTML color codes. String String "#FFFFF8DC", Height Specify the Width of the trace window. Int32 Int32 500 Message Specify a message to write to the trace window. String String None Title Specify a title for the trace window. String String "Trace Messages" Width Specify the Width of the trace window. Int32 Int32 800 System.String None Look at $PSSamplePath\Get-Status.ps1 for a demonstration of this command in a function. The buttons have key acclerators of Q and S. Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> Trace-Message -title "Troubleshooting Log" -width 600 This command will initialize a trace window with the given title and width. It is assumed you have set $TraceEnabled to $True. This is a command you would normally run in your code and not from the console. -------------------------- Example 2 -------------------------- PS C:\> Trace-Message -message "Starting MyCommand" This example is a continuation of the previous example. The message text will be appended to the graphical form, prepended with a timestamp. Online Version: https://bit.ly/3nb3b74 Write-Verbose Write-ANSIProgress Write ANSIProgress Display an ANSI progress bar. You can use this command to write an ANSI colored progress bar to the console. The output will be an array of strings. The item may be a blank line. See examples. NOTE: If you are using the Windows Terminal and are at the bottom of the screen, you may get improperly formatted results. Clear the host and try again. Write-ANSIProgress PercentComplete Enter a percentage in decimal value like .25 up to 1. Double Double None BarSymbol Specify what shape to use for the progress bar. Box Block Circle String String Box Position Specify the cursor position or where you want to place the progress bar. Coordinates Coordinates Current position ProgressColor Specify an ANSI escape sequence for the progress bar color. String String None BarSymbol Specify what shape to use for the progress bar. String String Box PercentComplete Enter a percentage in decimal value like .25 up to 1. Double Double None Position Specify the cursor position or where you want to place the progress bar. Coordinates Coordinates Current position ProgressColor Specify an ANSI escape sequence for the progress bar color. String String None System.Double System.String This command will not work in the PowerShell ISE. The verbose output should only be used when troubleshooting a display problem. Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- Example 1 -------------------------- PS C:\> $pct = @(.10, .12, .19, .25, .43, .55, .66, .78, .90, .95,1) PS C:\> $pct | Write-ANSIProgress -BarSymbol Block This will build a progress bar using a block symbol and the default ANSI color escape. -------------------------- Example 2 -------------------------- PS C:\> $params = @{ PercentComplete = .78 BarSymbol = "Circle" "ProgressColor" = "$([char]0x1b)[92m" } PS C:\> Write-ANSIProgress @params Create a single progress bar for 78% using the Circle symbol and a custom color. -------------------------- Example 3 -------------------------- PS C:\> Get-CimInstance -ClassName win32_operatingsystem | Select-Object -property @{N="Computername";E={$_.CSName}}, @{N="TotalMemGB";E={Format-Value $_.TotalVisibleMemorySize -unit MB}}, @{N="FreeMemGB";E={Format-Value $_.FreePhysicalMemory -unit MB}}, @{N="PctFree"; E={ $pct=Format-Percent $_.freephysicalmemory $_.totalVisiblememorySize Write-ANSIProgress -PercentComplete ($pct/100) | Select-Last 1 }} Computername TotalMemGB FreeMemGB PctFree ------------ ---------- --------- ------- BOVINE320 32 12 37.87% ■■■■■■■■■■■■■■■■■■■ Note that this example is using abbreviations in the Select-Object hashtables. -------------------------- Example 4 -------------------------- PS C:\> $sb = { Clear-Host $top = Get-ChildItem c:\scripts -Directory $i = 0 $out=@() $pos = $host.ui.RawUI.CursorPosition Foreach ($item in $top) { $i++ $pct = [math]::round($i/$top.count,2) Write-ANSIProgress -PercentComplete $pct -position $pos Write-Host " Processing $(($item.fullname).padright(80))" -NoNewline $out+= Get-ChildItem -path $item -Recurse -file | Measure-Object -property length -sum | Select-Object @{Name="Path";Expression={$item.fullname}},Count, @{Name="Size";Expression={$_.Sum}} } Write-Host "" $out | Sort-Object -property Size -Descending } PS C:\> Invoke-Command -scriptblock $sb You are most likely to use this command in a function or script. This example demonstrates using a script block. Online Version: https://bit.ly/2SSgQCM New-ANSIBar New-RedGreenGradient Show-ANSISequence Write-Detail Write Detail Write a detailed message string. This command is designed to be used within your functions and scripts to make it easier to write a detailed message that you can use as verbose output. The assumption is that you are using an advanced function with Begin, Process, and End scriptblocks. You can create a detailed message to indicate what part of the code is being executed. The output can include a full-time stamp, or a time string which includes a millisecond value. In a script you might use it like this in a Begin block: $pfx = "BEGIN" Write-Detail "Starting $($MyInvocation.MyCommand)" -Prefix $pfx | Write-Verbose Write-Detail "PS $($PSVersiontable.PSVersion)" -Prefix $pfx | Write-Verbose If you don't specify a prefix, it will default to PROCESS. Write-Detail Message The message to display after the time stamp and prefix. String String None Prefix Indicate whether you are in the BEGIN, PROCESS, or END script block. Although you can specify any text. It will be displayed in upper case. String String PROCESS Date Display a date value like 9/15/2020 11:36:41. SwitchParameter False Write-Detail Message The message to display after the time stamp and prefix. String String None Prefix Indicate whether you are in the BEGIN, PROCESS, or END script block. Although you can specify any text. It will be displayed in upper case. String String PROCESS Time Display a time value with milliseconds like 11:37:01:4029. SwitchParameter False Message The message to display after the time stamp and prefix. String String None Prefix Indicate whether you are in the BEGIN, PROCESS, or END script block. Although you can specify any text. It will be displayed in upper case. String String PROCESS Date Display a date value like 9/15/2020 11:36:41. SwitchParameter SwitchParameter False Time Display a time value with milliseconds like 11:37:01:4029. SwitchParameter SwitchParameter False None System.String Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ -------------------------- EXAMPLE 1 -------------------------- PS C:\> Write-Detail "Getting file information" -Prefix Process [PROCESS] Getting file information Normally you would use this command in a function, but here is an example from the console so that you can see what to expect. Online Version: http://bit.ly/31UuI26 Write-Verbose