Agente Esegui
Funzione | Esecuzione di un programma sul sistema di destinazione (solo Windows) |
---|---|
Allarme | Codice di uscita, tempo di esecuzione |
Dettaglio esecuzione agente
Parametri dell'esecuzione agente
Parametri | Descrizione |
---|---|
Percorso del programma | Programma eseguibile, compreso il suo percorso assoluto. Questo percorso o l'eseguibile specifico devono essere consentiti nella sezione Programmi di esecuzione della configurazione di WinAgent remoto. |
Argomenti della riga di comando | Argomenti della riga di comando per l'eseguibile. |
Timeout | L'eseguibile verrà terminato dopo il periodo di timeout, se ancora in esecuzione. Se impostato, questo timeout sovrascrive quello predefinito nella configurazione di WinAgent remoto(Default process timeout). |
Esegui una sola istanza | Se si seleziona questa opzione, è possibile eseguire solo un'istanza dell'eseguibile. Se l'eseguibile è già presente nell'elenco dei programmi in esecuzione del sistema di destinazione, non verrà avviato nuovamente. |
Nascondi finestra durante l'esecuzione | Se questa casella di controllo è impostata, WinAgent nasconde le finestre dell'applicazione eseguita. |
Sopprimi tempo di esecuzione | Se questa casella di controllo è impostata, il tempo di esecuzione di ogni controllo non viene salvato nel database e il suo valore non è più visibile nella sezione dei valori. Il suo valore non è più disponibile per essere utilizzato nelle specifiche dei limiti di allarme. |
L'elenco a discesa Tag consente di inserire variabili predefinite nei campi precedenti, ad esempio $NAME$ per il nome del lavoro.
Valori di esecuzione dell'agente e limiti di allarme
Valore / Limite di allarme | Descrizione |
---|---|
Codice di uscita | Il codice di uscita restituito dall'eseguibile. Di solito un codice di uscita pari a 0 significa che non ci sono stati errori durante l'esecuzione, tuttavia il codice di uscita dipende dall'eseguibile. |
Tempo di esecuzione | La durata dell'esecuzione del programma remoto (in s). Questo valore e il limite di allarme sono disponibili solo se il parametro Sopprimi tempo di esecuzione non è abilitato. |
Codice di errore | Codice di errore generico del lavoro (vedere la sezione Codici di errore del lavoro). |
Esempi di esecuzione dell'agente
Esempio 1 - Emettere un riavvio da remoto
Questo esempio utilizza il comando di sistema shutdown.exe con l'argomento /r per eseguire un riavvio del computer remoto.
Ciò richiede che il comando o la sua directory madre siano consentiti nella configurazione del WinAgent remoto nella scheda Programmi di esecuzione:
Uscita 1
Esempio 2 - Verificare se il servizio w32time è in esecuzione utilizzando il comando wmic sul computer remoto
Esegue il seguente comando e verifica se il servizio w32time è in esecuzione sul computer remoto:
Percorso del programma | C:\Windows\system32\cmd.exe |
---|---|
Riga di comando arg. | /C FOR /F %G IN ('wmic service w32time get state /value ^| findstr "State=Running"') Do exit /B 0 |
L'eseguibile cmd.exe deve essere consentito anche nella configurazione del WinAgent remoto nella scheda Programmi di esecuzione (vedere sopra).
Ciò consente di controllare lo stato di un servizio su macchine remote che eseguono, ad esempio, Windows 2000, che non è supportato dal plugin Agent Service.
Uscita 2
Se il servizio è in esecuzione, il codice di uscita è = 0, se è fermo o non disponibile il codice di uscita è = 1.
Esempio 3 - Ping di un server dall'host Windows utilizzando PowerShell
Questo job eseguirà il ping del server server1 dal sistema Windows e restituirà il codice di uscita 0 in caso di successo o 1 in caso di fallimento.
Percorso del programma | %SystemRoot%\system32\WindowsPowerShell\v1.0\powershell.exe |
---|---|
Argomento della riga di comando. | if (test-connection server1 -Count 2 -Quiet) {exit 0} else {exit 1} |
PowerShell.exe deve essere consentito anche nella configurazione del WinAgent remoto nella scheda Programmi di esecuzione (vedere sopra).