Documentação

Referência de Scripts

O módulo de scripts permite criar, versionar e executar scripts em PowerShell, Bash e Python em qualquer conjunto de endpoints.

Linguagens suportadas

PowerShell

.ps1

Windows + Linux/macOS (pwsh)

Bash / Shell

.sh

Linux + macOS

Python 3

.py

Qualquer plataforma

CMD (Batch)

.bat / .cmd

Windows apenas

Criando um script

No painel, acesse Scripts → Novo script. O editor Monaco suporta syntax highlighting, autocomplete e histórico de versões.

Parâmetros de script

Defina parâmetros que o técnico precisará preencher antes da execução:

# PowerShell com parâmetros
param(
    [Parameter(Mandatory=$true)]
    [string]$ComputerName,

    [Parameter(Mandatory=$false)]
    [int]$TimeoutSeconds = 30
)

Write-Output "Verificando $ComputerName..."
Test-Connection -ComputerName $ComputerName -Count 3

Executando scripts

Em um dispositivo específico

Na página do dispositivo, clique em Executar ação → Executar scripte selecione o script desejado.

Em múltiplos dispositivos

Na página do script, clique em Executar e selecione: dispositivo individual, grupo de dispositivos ou organização inteira.

Via API

# POST /api/v1/scripts/{scriptId}/execute
curl -X POST https://api.cs-command.com/api/v1/scripts/scr_abc123/execute \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "targetType": "device",
    "targetId": "dev_xyz789",
    "params": { "ComputerName": "server01" }
  }'

Scripts do sistema

O CS Command inclui scripts pré-configurados prontos para uso:

ID	Nome	Plataforma	Descrição
sys-001	Diagnóstico de sistema	Windows	CPU, memória, disco, processos
sys-002	Limpeza de disco	Windows	Temp, prefetch, cache
sys-003	Listar processos	All	Top 20 por CPU/memória
sys-004	Restart serviço	Windows	Reinicia serviço pelo nome
sys-005	Verificar conectividade	All	Ping + traceroute
sys-009	Instalar Bitdefender	Windows	Deploy do AV endpoint
sys-010	Instalar ClamAV	Linux	AV open-source via apt/yum

Versionamento

Cada salvamento cria uma nova versão do script. O histórico completo de versões está disponível no editor. Scripts podem ser revertidos para qualquer versão anterior.

Limites e segurança

Timeout padrão: 5 minutos por execução (configurável até 30min)
Output máximo: 512 KB por execução
Execuções paralelas: até 100 dispositivos simultaneamente
Auditoria: todas as execuções são registradas com usuário, timestamp e resultado