extern/PowerShell
1
0
Fork 0
mirror of https://github.com/fleschutz/PowerShell.git synced 2025-04-13 13:38:17 +02:00
Code Issues Packages Projects Releases Wiki Activity

Update FAQ.md

Browse Source
This commit is contained in:
Markus Fleschutz 2021-08-30 09:19:10 +02:00 committed by GitHub
parent e8269232b2
commit 6ecd682764
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 13 additions and 4 deletions

17
Docs/FAQ.md
View File

@ -29,7 +29,7 @@ How to get PowerShell?
How to get the PowerShell Scripts? How to get the PowerShell Scripts?
---------------------------------- ----------------------------------
* Git users execute: `$ git clone https://github.com/fleschutz/PowerShell` * Git users execute: `$ git clone https://github.com/fleschutz/PowerShell`
* otherwise download it from: https://github.com/fleschutz/PowerShell/archive/master.zip * otherwise download & unzip: https://github.com/fleschutz/PowerShell/archive/master.zip
Why do some Scripts show gibberish characters? Why do some Scripts show gibberish characters?
@ -56,18 +56,19 @@ How to use PowerShell in Context Menus?
* to disable this execute `Remove_ps1_from_New_context_menu.reg` in subfolder [Data/](../Data) * to disable this execute `Remove_ps1_from_New_context_menu.reg` in subfolder [Data/](../Data)
How to edit the PowerShell Scripts? Which editor for PowerShell Scripts is recommended?
----------------------------------- ---------------------------------------------------
* use *PowerShell ISE* (Integrated Scripting Environment) to write, test and debug scripts (available for free on Windows only). * use *PowerShell ISE* (Integrated Scripting Environment) to write, test and debug scripts (available for free on Windows only).
* use *Visual Studio Code* supporting syntax highlighting, on-the-fly problem checking and an integrated PowerShell Console (available for free on Linux, Mac OS and Windows). * use *Visual Studio Code* supporting syntax highlighting, on-the-fly problem checking and an integrated PowerShell Console (available for free on Linux, Mac OS and Windows).
* or simply use your *favorite text editor* * or simply use your *favorite text editor*
How to write good PowerShell Scripts? How to write good PowerShell Scripts?
------------------------------------- -------------------------------------
Good PowerShell scripts are user-friendly and platform-independant. As a guideline follow these rules, please: Good PowerShell scripts are user-friendly and platform-independant. As a guideline follow these rules, please:
1. the filename is named using the `<verb>-<object>.ps1` scheme 1. the filename is named using the `<verb>-<object>.ps1` scheme
2. the encoding is UTF-8-BOM to support and use Unicode characters (including emojis where appropriate) 2. the encoding is UTF-8-BOM to support and use Unicode characters
3. the script has execute file permissions: chmod a+rx <file> (for Linux support) 3. the script has execute file permissions: chmod a+rx <file> (for Linux support)
4. provide a comment-based help with syntax, description, link, author, and license 4. provide a comment-based help with syntax, description, link, author, and license
5. check the requirements (e.g. #Requires -RunAsAdministrator, or #Requires -Version 3) 5. check the requirements (e.g. #Requires -RunAsAdministrator, or #Requires -Version 3)
@ -77,6 +78,14 @@ Good PowerShell scripts are user-friendly and platform-independant. As a guideli
9. on error call write-error with keyword "ERROR:" (to support log parsers) and exit the error code (mostly 1) 9. on error call write-error with keyword "ERROR:" (to support log parsers) and exit the error code (mostly 1)
10. on success exit with error code 0 (exit 0) 10. on success exit with error code 0 (exit 0)
Found a bug or Issue?
---------------------
If you find something bad (like a bug, error, or any issue), please report it here by open an Issue.
Or even better: Fork the Repository, fix it and submit a pull request, so others can participate too
Your Question is not answered here? Your Question is not answered here?
----------------------------------- -----------------------------------
Send your question to: markus [at] fleschutz [dot] de Send your question to: markus [at] fleschutz [dot] de