docs tweaks

This commit is contained in:
silversword411 2021-04-20 05:12:58 +00:00
parent a5c6ea7ffc
commit 845b9e4568
2 changed files with 15 additions and 12 deletions

View File

@ -40,11 +40,13 @@ Consider they are viewed in 3 different locations:
Script Manager
- List View (sortable by any column)
- List View (sortable by any column)
- Folder View (Grouped by Categories)
- Folder View (Grouped by Categories)
Running scripts manually or adding tasks (or adding in Automation Manager)
Run or Add script
- Running scripts manually or adding tasks (or adding in Automation Manager)
!!!info
A good max length is 50-60 chars or less for display in these 3 locations
@ -59,15 +61,15 @@ Category or Function - What It Does
![json_name_examples](images/community_scripts_name_field_example1.png)
## Script Files
## Making Script Files
### Good Habits
Try and make them fully self-contained.
- Try and make them fully self-contained.
If they pull data from elsewhere, create comment notes at the top with references for others to audit/validate
- If they pull data from elsewhere, create comment notes at the top with references for others to audit/validate
Good folder locations
- Good folder locations
```
c:\ProgramData\TacticalRMM\
c:\ProgramData\TacticalRMM\scripts
@ -77,18 +79,18 @@ c:\ProgramData\TacticalRMM\temp
c:\ProgramData\TacticalRMM\
```
Command Parameters are good. Optional command parameters for extra functions are better
- Command Parameters are good. Optional command parameters for extra functions are better
### Bad Habits
Assumes non-standard configurations
- Assumes non-standard configurations
Doesn't play well with other community scripts (reused names etc.)
- Doesn't play well with other community scripts (reused names etc.)
## Useful Reference Script Examples
RunAsUser
RunAsUser (since Tactical RMM runs as system)
[https://github.com/wh1te909/tacticalrmm/blob/develop/scripts/Win_Display_Message_To_User.ps1](https://github.com/wh1te909/tacticalrmm/blob/develop/scripts/Win_Display_Message_To_User.ps1)
Command Paramater Ninja

View File

@ -7,7 +7,8 @@
The provided install script assumes a fresh server with no software installed on it. Attempting to run it on an existing server with other services **will** break things and the install will fail.<br/><br/>
The install script has been tested on the following public cloud providers: DigitalOcean, Linode, Vultr, BuyVM (highly recommended), Hetzner, AWS, Google Cloud and Azure, as well as behind NAT on Hyper-V, Proxmox and ESXi.
- A real domain is needed to generate a Let's Encrypt wildcard cert. <br/>If you cannot afford to purchase a domain ($12 a year) then you can get one for free at [freenom.com](https://www.freenom.com/)<br/><br/>
- A real (internet resolvable) domain is needed to generate a Let's Encrypt wildcard cert. <br/>If you cannot afford to purchase a domain ($12 a year) then you can get one for free at [freenom.com](https://www.freenom.com/)
- example.local is NOT a real domain. No you [don't have to expose your server](faq.md#can-i-run-tactical-rmm-locally-behind-nat-without-exposing-anything-to-the-internet) to the internet<br/><br/>
- A TOTP based authenticator app. Some popular ones are Google Authenticator, Authy and Microsoft Authenticator.<br/><br/>