Agente Esegui

Funzione

Eseguire un programma sul sistema di destinazione (solo Windows)

Allarme

Codice di uscita, tempo di esecuzione

Dettagli di esecuzione dell'agente

Parametri di esecuzione dell'agente

Parametro

Descrizione

Percorso del programma

Programma eseguibile compreso il suo percorso assoluto. Questo percorso o eseguibile specifico deve essere consentito nella sezione Esegui programmi della configurazione WinAgent remota.

Argomento 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 sostituisce il timeout predefinito nella configurazione remota di WinAgent (Timeout processo predefinito).

Esegui solo un'istanza

Se selezionato, è consentita una sola 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 è selezionata, WinAgent nasconde le finestre dell'applicazione eseguita.

Sopprimere il tempo di esecuzione

Se questa casella di controllo è selezionata, 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 l'uso nelle specifiche dei limiti di allarme.

L'elenco a discesa Tag consente di inserire variabili predefinite nei campi sopra indicati, 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 indica che non si sono verificati 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 - Eseguire un riavvio in 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 principale siano consentiti nella configurazione WinAgent remota nella scheda Esegui programmi:

Output 1

Esempio 2 - Verifica dell'esecuzione del servizio w32time utilizzando il comando wmic sul computer remoto

Questo comando esegue il seguente comando e verifica se il servizio w32time è in esecuzione sul computer remoto:

Percorso del programma

C:\Windows\system32\cmd.exe

Argomento della riga di comando.

/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 WinAgent remota nella scheda Esegui programmi (vedi sopra).

Ciò consente di verificare lo stato di un servizio su macchine remote che eseguono ad esempio Windows 2000, che non è supportato per il plugin Agent Service job.

Output 2

Se il servizio è in esecuzione, il codice di uscita è = 0, se è arrestato o non disponibile il codice di uscita è = 1.

Esempio 3 - Eseguire il 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 errore.


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 remota di WinAgent nella scheda Esegui programmi (vedi sopra).