Скриптове

Библиотеката

Страницата Scripts показва скриптовете на вашия тенант и глобалните скриптове (само за четене, споделени от глобалните администратори). Техниците могат да изпълняват скриптове; администраторите на тенанта освен това ги създават и редактират.

Един скрипт има:

Поле	Значение
Name, description	Показват се в библиотеката.
Language	PowerShell (Windows PowerShell 5.1), PowerShell 7 (pwsh.exe, трябва да е инсталиран на устройството) или cmd.
Run as	System или the logged-on user (влезлият потребител).
Timeout	Колко дълго може да работи; след това дървото от процеси се прекратява.
Parameters	Типизирани входни данни, които се показват като формуляр при изпълнение на скрипта.
Script	Съдържанието, редактирано в редактор за код.

Параметри

Всеки параметър има име, тип (string, integer, number или boolean), заглавие, незадължителна стойност по подразбиране и по избор списък с разрешени стойности, минимум/максимум или максимална дължина, както и дали е задължителен. Сървърът проверява стойностите спрямо тези правила преди изпълнение.

Скриптът получава всеки параметър два пъти:

• като променлива на средата RMM_PARAM_<NAME> (булевите стойности са true / false);

• при PowerShell и като именуван параметър, така че скриптът може да декларира:

  param([string]$Name, [int]$Days, [switch]$Force)

Стойностите никога не се вмъкват в текста на скрипта.

Скриптове cmd

При скриптовете cmd текстовите стойности не могат да съдържат & | < > ^ % ! ", защото пакетният файл би ги третирал като команди.

Версии

Всяка промяна в съдържанието или параметрите създава нова версия. Разделът History ги показва заедно с разликите (diff). Всяко изпълнение записва коя версия е използвало. Изтриването на скрипт го премахва от библиотеката, но запазва изпълненията му.

Изпълнение на скрипт

Отворете скрипт, изберете Run, попълнете параметрите, изберете устройствата (избрани устройства, филтър или всички устройства) и стартирайте. За всяко устройство се създава по едно изпълнение.

Изпълнения на скриптове

Страницата Script runs показва всяко изпълнение с неговото устройство, скрипт, състояние (queued, running, succeeded, failed, timeout, cancelled) и код на изход. Страницата на едно изпълнение показва:

• изхода, предаван в реално време, докато скриптът работи (stdout и stderr по реда на извеждане);
• кода на изход и грешката;
• при дълъг изход — целия файл с изхода: агентът качва всичко над 64 KiB (до 10 MiB; над това изпълнението се маркира като truncated).

Изпълнение на опашката или в ход може да бъде отменено.