PowerShell/docs/write-help.md

68 lines
3.7 KiB
Markdown
Raw Normal View History

2024-11-08 12:38:20 +01:00
The *write-help.ps1* Script
===========================
2024-11-08 12:35:11 +01:00
write-help.ps1
Parameters
----------
```powershell
[<CommonParameters>]
This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction,
WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
```
Script Content
--------------
```powershell
<#
.SYNOPSIS
Writes a help page
.DESCRIPTION
This PowerShell script writes a PowerShell help page.
.EXAMPLE
PS> ./write-help.ps1
.LINK
https://github.com/fleschutz/PowerShell
.NOTES
Author: Markus Fleschutz | License: CC0
#>
function White([string]$line) {
Write-Host $line -foregroundColor white -backgroundColor black -noNewline
}
function Blue([string]$line) {
Write-Host $line -foregroundColor blue -backgroundColor black -noNewline
}
try {
White "█████████████████████████████████████`n"
White "█████████████████████████████████████ 👋 Welcome to POWERSHELL $($PSVersionTable.PSVersion) $($PSVersionTable.PSEdition) edition`n"
White "████ ▄▄▄▄▄ █▀ █▀▀█▀▀ ▄▄██ ▄▄▄▄▄ ████`n"
White "████ █ █ █▀ ▄ █▀ ▀ ▀▄█ █ █ █ ████ Documentation: "; Blue "https://docs.microsoft.com/en-us/powershell`n"
White "████ █▄▄▄█ █▀█ █▄▀▄▀ ▀ ▄▄█ █▄▄▄█ ████`n"
White "████▄▄▄▄▄▄▄█▄█▄█ █▄█ █▄▀ █▄▄▄▄▄▄▄████ Tutorial: "; Blue "https://www.guru99.com/powershell-tutorial.html`n"
White "████▄▄ ▄█▄▄ ▄█▄▄ █▀ ▀▀▀ ▀▄▀▄█▄▀████`n"
White "████▀▄▄█▀█▄██ ▀ ▄▄▀ █▄█▀ ▀ ▄▀▀█▀█████ Video tutorials: "; Blue "https://www.youtube.com/results?search_query=PowerShell`n"
White "█████ ▄▄█▄▄▀▄ ▀▄▀ ▄▄ ▀ ▀▀▀ ▀▄▄█▀████`n"
White "████▄ ▀ ▄ ▄▄█ █▀██▄ ██▀▄█▄▄▀▄▄▀█████ Execute: 'Get-Help <NAME>' to display information about <NAME>`n"
White "████ ████▄▄ ▄█▄▄▄██ ▀ ▀▀▀▀▄ █▀████`n"
White "████ ███▄ ▄▀▀██ ▄█ ▄▄▄█▀ ▄▄ ██▄▀█████ FAQ's: "; Blue "https://github.com/fleschutz/PowerShell/blob/main/docs/FAQ.md`n"
White "████▄█▄███▄▄▀▄▄▄▀ ▄▄ ▄▀▄ ▄▄▄ ▀ ████`n"
White "████ ▄▄▄▄▄ █▄▄▄█▀█▄ ██ █▄█ ▄▄█▀████ 500+ sample scripts: "; Blue "https://github.com/fleschutz/PowerShell`n"
White "████ █ █ █ ▀▄█▄ ▄▄ ▀█ ▄▄▄▄▀ ████`n"
White "████ █▄▄▄█ █ ██ ▄█▄ ▄▀▀▀ ▄▄ ▄ █████ Cheat sheet: "; Blue "https://github.com/fleschutz/PowerShell/blob/main/docs/cheat-sheet.md`n"
White "████▄▄▄▄▄▄▄█▄▄█▄▄████▄▄▄██▄▄▄█▄██████`n"
White "█████████████████████████████████████ NOTE: use <Ctrl> + <Click> to open the links in your browser.`n"
White "█████████████████████████████████████`n"
exit 0 # success
} catch {
"⚠️ Error in line $($_.InvocationInfo.ScriptWhiteNumber): $($Error[0])"
exit 1
}
```
2024-11-08 12:40:31 +01:00
*(generated by convert-ps2md.ps1 as of 11/08/2024 12:40:23)*