Collection of Useful PowerShell Scripts (CUPS) ============================================== This repository contains useful cross-platform PowerShell scripts - to be used on the command-line (CLI), by voice control or by automation software like Jenkins. List of Scripts --------------- The following PowerShell scripts can be found in the `Scripts/` subfolder: * [download.ps1](Scripts/download.ps1) - downloads the file/directory from the given URL * [empty-dir.ps1](Scripts/empty-dir.ps1) - empties the given directory * [exe_info.ps1](Scripts/exe_info.ps1) - prints basic information of the given executable file * [init-git.ps1](Scripts/init-git.ps1) - initializes the Git configuration * [latlong.ps1](Scripts/latlong.ps1) - prints the lat/long coordinates of the given city * [list-empty-dirs.ps1](Scripts/list-empty-dirs.ps1) - lists empty subfolders in a directory tree * [list-unused-files.ps1](Scripts/list-unused-files.ps1) - lists unused files in a directory tree * [list-cmdlets.ps1](Scripts/list-cmdlets.ps1) - lists the PowerShell cmdlets * [list-modules.ps1](Scripts/list-modules.ps1) - lists the PowerShell modules * [list-processes.ps1](Scripts/list-processes.ps1) - lists the local computer processes * [MD5.ps1](Scripts/MD5.ps1) - prints the MD5 checksum of the given file * [make-install.ps1](Scripts/make-install.ps1) - installs built executables and libs to the installation directory * [moon.ps1](Scripts/moon.ps1) - prints the current moon phase * [password.ps1](Scripts/password.ps1) - generates and prints a single new password * [passwords.ps1](Scripts/passwords.ps1) - generates and prints a list of new passwords * [poweroff.ps1](Scripts/poweroff.ps1) - halts the local computer, administrator rights might be needed * [news.ps1](Scripts/news.ps1) - prints the latest news * [reboot.ps1](Scripts/reboot.ps1) - reboots the local computer, administrator rights might be needed * [scan-ports.ps1](Scripts/scan-ports.ps1) - scans the network for open/closed ports * [send-email.ps1](Scripts/send-email.ps1) - sends an email message * [send-udp.ps1](Scripts/send-udp.ps1) - sends a UDP datagram message to the given IP address and port * [SHA1.ps1](Scripts/SHA1.ps1) - prints the SHA1 checksum of the given file * [SHA256.ps1](Scripts/SHA256.ps1) - prints the SHA256 checksum of the given file * [simulate-presence.ps1](Scripts/simulate-presence.ps1) - simulates the human presence against burglars * [speak.ps1](Scripts/speak.ps1) - speaks the given text by text-to-speech (TTS) * [take-screenshot.ps1](Scripts/take-screenshot.ps1) - takes a single screenshot * [take-screenshots.ps1](Scripts/take-screenshots.ps1) - takes multiple screenshots * [test.ps1](Scripts/test.ps1) - simple test script * [train-dns-cache.ps1](Scripts/train-dns-cache.ps1) - trains the DNS cache with frequently used domain names * [translate.ps1](Scripts/translate.ps1) - translates the given text * [txt2wav.ps1](Scripts/txt2wav.ps1) - converts text into a audio .WAV file * [validate-xml.ps1](Scripts/validate-xml.ps1) - validates the given XML file * [weather.ps1](Scripts/weather.ps1) - prints the current weather forecast * [weather-alert.ps1](Scripts/weather-alert.ps1) - checks the current weather for critical values * [weather-report.ps1](Scripts/weather-report.ps1) - prints the local weather report * [weather-worldwide.ps1](Scripts/weather-worldwide.ps1) - prints the current weather of cities world-wide * [wakeup.ps1](Scripts/wakeup.ps1) - sends a magic packet to the given computer, waking him up * [zip-dir.ps1](Scripts/zip-dir.ps1) - creates a zip archive of the given folder What is PowerShell? ------------------- PowerShell is a task automation and configuration management framework from Microsoft, consisting of a command-line shell and associated scripting language. * it's **cross-platform**: available for Linux, Mac OS and Windows * it's **powerful**: fully control your computer * it's **open-source**: see the Github repository at https://github.com/PowerShell/PowerShell * it's **easy to learn**: see the tutorial at https://www.guru99.com/powershell-tutorial.html * it's **fully documented**: see the official docs at https://docs.microsoft.com/en-us/powershell/ How to get PowerShell? ---------------------- Windows 7 and newer do provide PowerShell by default. It's recommended to use it via **Windows Terminal** (see the Microsoft Store at https://www.aka.ms/terminal). For installation on alternative platforms (CentOS, Debian, Docker, Fedora, macOS, openSUSE, Red Hat, Ubuntu) visit https://github.com/PowerShell/PowerShell. Afterward, install the scripts by clicking on the green "Code" button or execute: ``` $ git clone https://github.com/fleschutz/PowerShell ``` How to configure PowerShell as default shell on Linux? ------------------------------------------------------ Make sure PowerShell is installed, then use the `chsh` commmand as follows: * `chsh -s /bin/powershell ` How to add the subfolder Scripts/ to the search path for command-line usage? ---------------------------------------------------------------------------- * **Windows:** open the environment variables dialogue and add the full path to Scripts/ to the system environment variable "Path" * **Bash or sh:** edit .profile in your home directory and add the line: PATH="$PATH:/path/to/PowerShell/Scripts" Script Standards ---------------- Each script should support the following rules: * **Rule 1:** to support PowerShell on Linux the first line reads: #!/snap/bin/powershell * **Rule 2:** to support PowerShell on Linux the script has execute file permissions (chmod a+rx ) * **Rule 3:** add a metadata header containing the syntax, description, author, source, and license * **Rule 4:** prefer command-line options, but may ask the user in case no option is given * **Rule 5:** the encoding of the script is in UTF-8 with BOM to support Unicode characters * **Rule 6:** exit 0 for success, otherwise exit with the error code (mostly 1) Feedback -------- Send your email feedback to: markus [at] fleschutz [dot] de License & Copyright ------------------- This open source release is licensed under the CC0 license. All trademarks are the property of their respective owners.