Scripts Personalizados

O Sonar RMM oferece um sistema robusto de automação através de scripts personalizados, permitindo que administradores de TI executem tarefas complexas de forma automatizada e consistente em toda sua infraestrutura.

Benefícios dos Scripts no Sonar

• Automação de tarefas repetitivas: Reduza tempo e esforço manual

• Consistência: Execute tarefas idênticas em múltiplos dispositivos

• Escalabilidade: Gerencie centenas ou milhares de dispositivos simultaneamente

• Flexibilidade: Suporte a múltiplas linguagens de script

Tipos de Scripts no Sonar

• Manutenção do sistema: Limpeza de arquivos temporários, desfragmentação

• Monitoramento: Verificação de saúde do sistema, coleta de métricas

• Configuração: Ajustes de registro, configurações de rede

• Instalação de aplicativos: Deploy automatizado de software

• Configuração pós-instalação: Definição de preferências e políticas

• Backup e restore: Operações de proteção de dados

Estrutura e Anatomia de Scripts

# 1. Cabeçalho e documentação
<#
.SYNOPSIS
    Breve descrição do que o script faz
.DESCRIPTION
    Descrição detalhada incluindo parâmetros e comportamento esperado
.PARAMETER ParameterName
    Descrição dos parâmetros aceitos
.EXAMPLE
    Exemplo de uso do script
#>

# 2. Definição de parâmetros
param(
    [string]$Parameter1,
    [switch]$Verbose
)

# 3. Inicialização e variáveis
$ErrorActionPreference = "Stop"
$LogPath = "C:\Temp\ScriptLog.txt"

# 4. Funções auxiliares
function Write-Log {
    param([string]$Message)
    "$((Get-Date).ToString('yyyy-MM-dd HH:mm:ss')) - $Message" | Out-File -FilePath $LogPath -Append
}

# 5. Lógica principal
try {
    Write-Log "Iniciando execução do script"
    
    # Sua lógica aqui
    
    Write-Log "Script executado com sucesso"
    exit 0
}
catch {
    Write-Log "Erro: $_"
    exit 1
}

Linguagens Suportadas

• PowerShell: Recomendado para Windows

• Batch/CMD: Scripts simples Windows

• Python: Multiplataforma, ideal para lógica complexa

• Shell/Bash: Sistemas Linux e macOS

---

Criando Scripts no Sonar

Acessando o Gerenciador de Scripts

1. Faça login no painel do Sonar

2. Navegue até Policies no menu a esquerda

3. Clique no botão [+] e em New Policy para criar um novo script

Configuração Básica

Informações Gerais

• Nome: Use nomenclatura descritiva e consistente

  • Exemplo: "Sistema - Limpeza de Arquivos Temporários"

• Descrição: Detalhe o propósito, requisitos e comportamento esperado

• Categoria: Organize scripts por função (Sistema, Segurança, Aplicativos)

Configurações Técnicas

• Shell Type: Selecione a linguagem apropriada

• Supported Platforms: Especifique SO compatíveis

• Timeout: Configure tempo limite adequado (recomendado: 300+ segundos para scripts complexos)

Parâmetros e Argumentos

Script Arguments

Configure argumentos que o script aceita:

-ConfigFile "C:\Config\app.conf" -Verbose -Force

Environment Variables

Defina variáveis de ambiente necessárias:

TEMP_DIR=C:\Temp
LOG_LEVEL=INFO

Syntax Description

Documente a sintaxe para outros usuários:

Usage: Script-Name [-Parameter1 <value>] [-Switch1] [-Switch2]
Parameters:
  -Parameter1: Descrição do parâmetro
  -Switch1: Descrição do switch

Configurações Avançadas

Privilégios de Execução

Run As User

• Marcado: Executa no contexto do usuário logado

• Desmarcado: Executa como SYSTEM (recomendado para a maioria dos casos)

---

Métodos de Execução

Execução Individual

Via Interface Web

1. Na tabela de agentes, clique com botão direito no agente desejado

2. Selecione Run Script

3. Configure parâmetros:

   • Script: Selecione o script desejado

   • Arguments: Insira argumentos necessários

   • Environment vars: Configure variáveis de ambiente

   • Timeout: Ajuste tempo limite se necessário

   • Run As User: Executa no contexto do usuário logado

Opções de Saída

• Wait for Output: Monitora execução em tempo real

• Fire and Forget: Execução assíncrona

• Email results: Envio de resultados por email

• Save to Custom Field: Armazenamento em campo personalizado

• Save to Agent Notes: Adição às notas do agente

Execução em Massa

Configuração de Alvos

1. Acesse Tools > Bulk Script

2. Configure o escopo:

   • Client: Todos agentes de um cliente

   • Site: Todos agentes de um site

   • Selected Agents: Agentes específicos

   • All: Todos os agentes

Filtros de Plataforma

• Agent OS: Windows, Linux, macOS ou All

• Agent Type: Servers, Workstations ou All

Execução via automação

Associe scripts a automações

Triggers automáticos

Execute scripts como resposta a execução de checagens de disco, memória, serviços, dentre outras.

---

Monitoramento e Logs

Acompanhamento via Interface

Histórico de Execução

1. Selecione um agente na tabela

2. Acesse a aba Histórico

3. Analise resultados e códigos de saída