Gestire l'applicazione dalla riga di comando

Kaspersky Endpoint Security può essere gestito dalla riga di comando.

Nota: al termine dell'installazione degli aggiornamenti dei moduli di Kaspersky Endpoint Security, la versione del client dell'applicazione nella riga di comando potrebbe essere diversa dalla versione installata dell'applicazione.

Sintassi della riga di comando:

kav <comando> <parametri>

Ogni comando dispone di una gamma specifica di parametri supportati.

Visualizzare la guida della riga di comando

Questo comando consente di visualizzare la sintassi della riga di comando dell'applicazione:

kav -? | help

Utilizzare uno dei seguenti comandi per visualizzare la guida sulla sintassi di un comando specifico:

kav <comando> -?

kav help <comando>

Eseguire una scansione virus

Sintassi del comando:

kav scan <ambito della scansione> <azione> <tipi di file> <esclusioni> <parametri rapporti> <parametri avanzati>

Nota: per eseguire una scansione virus, è inoltre possibile utilizzare le attività create nell'applicazione avviando quella desiderata dalla riga di comando. L'attività viene avviata con i parametri specificati nell'interfaccia di Kaspersky Endpoint Security.

Descrizioni dei parametri

<ambito della scansione> – questo parametro specifica un elenco di oggetti da esaminare per rilevare eventuale codice dannoso. È possibile includere diversi parametri separandoli con uno spazio.

Sono disponibili i seguenti valori:

• <file> - elenco di percorsi dei file e/o delle cartelle da esaminare. È possibile specificare i percorsi assoluti o relativi dei file. Gli elementi dell'elenco devono essere separati da uno spazio.

  Nota: se il nome di un oggetto o il relativo percorso include uno spazio o caratteri speciali (come $, &, o @), il nome deve essere racchiuso tra virgolette singole (' ') oppure ciascuno dei caratteri speciali deve essere preceduto da una barra rovesciata (\). Se viene fatto riferimento a una cartella specifica, verranno esaminati tutti i file e le cartelle in essa contenuti.

• -all – Scansione completa del computer.
• -remdrives – Tutte le unità rimovibili.
• -fixdrives – Tutte le unità interne.
• -netdrives – Tutte le unità di rete.
• -@:<elencofile.lst> – Percorso del file contenente un elenco di oggetti e cartelle all'interno dell'ambito di scansione. Il file deve essere in formato testo e ogni oggetto della scansione deve essere elencato in una riga separata. È possibile immettere solo un percorso assoluto del file.

<azione> – Questo parametro determina l'azione da eseguire sugli oggetti dannosi rilevati durante la scansione. Se il parametro non è definito, l'azione predefinita è quella che corrisponde al valore -i8.

Sono disponibili i seguenti valori:

• -i0 – Nessuna azione sull'oggetto, esclusivamente il salvataggio delle informazioni sull'oggetto in un rapporto.
• -i1 – Gli oggetti infetti vengono disinfettati e, se la disinfezione è impossibile, vengono ignorati.
• -i2 – Gli oggetti infetti vengono disinfettati e se la disinfezione è impossibile, vengono eliminati; non vengono eliminati i contenitori, tranne quelli con intestazioni eseguibili (archivi sfx).
• -i3 – Gli oggetti infetti vengono disinfettati e se la disinfezione è impossibile, vengono eliminati; vengono eliminati completamente i contenitori se è impossibile eliminare i file infetti al loro interno.
• -i4 – Gli oggetti infetti vengono eliminati; vengono eliminati completamente i contenitori se è impossibile eliminare i file infetti contenuti.
• -i8 – Viene richiesto l'intervento dell'utente se viene rilevato un oggetto infetto (utilizzato per impostazione predefinita).
• -i9 – Viene richiesto l'intervento dell'utente al termine della scansione.

<tipi di file> – Questo parametro definisce i tipi di file che sono sottoposti a scansione virus. Per impostazione predefinita, se questo parametro non è definito vengono esaminati solo i file potenzialmente infettabili (in base ai contenuti dei file).

Sono disponibili i seguenti valori:

• -fe – Vengono esaminati solo i file potenzialmente infettabili (in base all'estensione dei file).
• -fi – Vengono esaminati solo i file potenzialmente infettabili (in base ai contenuti dei file). Questo parametro viene utilizzato per impostazione predefinita.
• -fa – Vengono esaminati tutti i file.

<esclusioni> – Questo parametro definisce gli oggetti da escludere dalla scansione. È possibile includere diversi parametri separandoli con uno spazio.

Sono disponibili i seguenti valori:

• -e:a – Non esaminare gli archivi.
• -e:b – Non esaminare i database e-mail.
• -e:m – Non esaminare i messaggi di posta in formato testo.
• -e:<maschera> – Non esaminare gli oggetti in base alla maschera.
• -e:<secondi> – Ignora gli oggetti la cui scansione richiede un intervallo di tempo superiore alla durata specificata (in secondi).
• -es:<formato> – Ignora gli oggetti la cui scansione supera il valore specificato (in megabyte).

<parametri rapporti> – Questi parametri determinano il formato del rapporto contenente i risultati della scansione. È possibile specificare un percorso assoluto o relativo del file del rapporto. Se questo parametro non è definito, vengono visualizzati i risultati della scansione e tutti gli eventi.

Sono disponibili i seguenti valori:

• -r:<file rapporto> – Registra solo gli eventi importanti nel file di rapporto specificato.
• -ra:<file rapporto> – Registra tutti gli eventi nel file di rapporto specificato.

<parametri avanzati> – Parametri che definiscono l'utilizzo delle tecnologie di scansione virus e i file di configurazione:

• -iSwift=<on|off> – Consente di abilitare o disabilitare l'utilizzo di iSwift.
• -c:<file di configurazione> – Definire il percorso del file di configurazione che contiene le preferenze dell'applicazione per le attività di scansione virus. È possibile indicare un percorso assoluto o relativo del file. Se questo parametro non è specificato, i valori impostati nell'interfaccia dell'applicazione sono usati insieme ai valori già specificati nella riga di comando.

Aggiornare l'applicazione

Sintassi del comando:

kav update <sorgente aggiornamenti> <parametri rapporti> <parametri avanzati>

Descrizioni dei parametri

<sorgente aggiornamenti> – Un server HTTP o una cartella di rete o locale da cui vengono scaricati gli aggiornamenti. Se non viene selezionato alcun percorso, sarà utilizzata la sorgente degli aggiornamenti definita nelle preferenze di aggiornamento dell'applicazione.

<parametri rapporti> – Questi parametri determinano il formato del rapporto sui risultati della scansione. È possibile specificare un percorso assoluto o relativo del file del rapporto. Se questo parametro non è definito, vengono visualizzati i risultati dell'aggiornamento e tutti gli eventi.

Sono disponibili i seguenti valori:

• -r:<file rapporto> – Registra solo gli eventi importanti nel file di rapporto specificato.
• -ra:<file rapporto> – Registra tutti gli eventi nel file di rapporto specificato.

<parametri avanzati> – Un parametro che definisce l'utilizzo di un file di configurazione.

-c:<file di configurazione> – Definisce il percorso di un file di configurazione che contiene le preferenze dell'applicazione per l'aggiornamento dell'applicazione. È possibile indicare un percorso assoluto o relativo del file. Se questo parametro non è definito, vengono utilizzati i valori impostati nell'interfaccia dell'applicazione.

Eseguire il rollback dell'ultimo aggiornamento

Sintassi del comando:

kav rollback <parametri rapporti>

Importante: sono necessari i diritti di amministratore per l'esecuzione di questo comando.

Descrizioni dei parametri

<parametri rapporti> – Questo parametro definisce il formato del rapporto contenente i risultati del rollback dell'aggiornamento. È possibile specificare un percorso assoluto o relativo del file del rapporto. Se il parametro non è definito, vengono visualizzati i risultati del rollback e tutti gli eventi.

Sono disponibili i seguenti valori:

• -r:<file rapporto> – Registra solo gli eventi importanti nel file di rapporto specificato.
• -ra:<file rapporto> – Registra tutti gli eventi nel file di rapporto specificato.

Avviare/interrompere un'attività o un componente

La sintassi del comando di avvio:

kav start <nome componente o attività> <parametri rapporto>

La sintassi del comando di interruzione:

kav stop <nome componente o attività>

Importante: sono necessari i diritti di amministratore per l'esecuzione del comando di arresto.

Descrizioni dei parametri

<nome componente o attività> – Specificare uno dei seguenti valori:

• fm o file_monitoring – Protezione Minacce File
• wm o web_monitoring – Protezione Minacce Web
• ids – Protezione Minacce di Rete
• full o scan_my_computer – Attività Scansione completa
• scan_objects – Attività Scansione personalizzata
• quick o scan_critical_areas – Attività Scansione rapida
• updater – Attività di aggiornamento
• rollback – Attività di rollback

<parametri rapporti> – Questi parametri determinano il formato del rapporto sui risultati dell'attività o del componente. È possibile specificare un percorso assoluto o relativo del file del rapporto. Se questo parametro non è definito, Kaspersky Endpoint Security consente di visualizzare i risultati secondo i parametri configurati nell'interfaccia utente.

Nota: <parametri rapporti> è disponibile solo per scan_objects, updater e valori di rollback.

Sono disponibili i seguenti valori:

• -r:<file_rapporto> – Kaspersky Endpoint Security registra solo gli eventi importanti nel file di rapporto specificato.
• -ra:<file rapporto> – Kaspersky Endpoint Security registra tutti gli eventi nel file di rapporto specificato.

Nota: i componenti e le attività avviati dal prompt dei comandi vengono eseguiti con i parametri configurati nell'interfaccia utente.

Visualizzare lo stato e le statistiche di un componente o un'attività

Sintassi del comando status:

kav status <nome componente o attività>

Sintassi del comando statistics:

kav statistics <nome componente o attività>

Descrizioni dei parametri

<nome componente o attività> – Specificare uno dei seguenti valori:

• fm o file_monitoring – Protezione Minacce File
• wm o web_monitoring – Protezione Minacce Web
• ids – Protezione Minacce di Rete
• full o scan_my_computer – Attività Scansione completa
• scan_objects – Attività Scansione personalizzata
• quick o scan_critical_areas – Attività Scansione rapida
• updater – Attività di aggiornamento
• rollback – Attività di rollback

Nota: se il comando status è eseguito senza specificare alcun valore per il parametro <nome componente o attività>, sarà visualizzato lo stato di tutte le attività e i componenti dell'applicazione. Per il comando statistics, è necessario specificare un valore per il parametro <nome componente o attività>.

Esportare le preferenze di protezione

Sintassi del comando:

kav export <nome componente o attività> <file di esportazione>

Descrizioni dei parametri

<nome componente o attività> – Specificare uno dei seguenti valori:

• fm o file_monitoring – Protezione Minacce File
• wm o web_monitoring – Protezione Minacce Web
• ids – Protezione Minacce di Rete
• full o scan_my_computer – Attività Scansione completa
• scan_objects – Attività Scansione personalizzata
• quick o scan_critical_areas – Attività Scansione rapida
• updater – Attività di aggiornamento
• rollback – Attività di rollback

<file di esportazione> – Percorso del file in cui sono esportate le preferenze dell'applicazione. È possibile indicare un percorso assoluto o relativo del file.

Attivare l'applicazione

È possibile attivare Kaspersky Endpoint Security applicando un file chiave.

Sintassi del comando:

kav license /add <file chiave o codice di attivazione della chiave>

Descrizioni dei parametri

<file chiave> – File chiave dell'applicazione con estensione key.

<codice di attivazione della chiave> – Codice di attivazione in formato XXXX-XXXX-XXXX-XXXX.

Rimuovere le chiavi di licenza

È possibile rimuovere tutte le chiavi di licenza attualmente aggiunte all'applicazione.

Sintassi del comando:

kav license /del

Importante: sono necessari i diritti di amministratore per l'esecuzione di questo comando.

Codici restituiti della riga di comando

I codici generali possono essere restituiti da qualsiasi comando dalla riga di comando. I codici restituiti comprendono i codici generali nonché quelli relativi a un'attività specifica.

Sintassi del comando per la ricezione del codice restituito:

echo $?

Codici restituiti generali:

• 0 – Operazione completata con successo
• 1 – Valore non valido per il parametro
• 2 – Errore sconosciuto
• 3 – Errore di completamento dell'attività
• 4 – Attività annullata

Codici restituiti dall'attività di scansione virus:

• 101 – Tutti gli oggetti dannosi sono stati elaborati
• 102 – Rilevati oggetti dannosi

Chiudere l'applicazione

Sintassi del comando:

kav exit

Importante: sono necessari i diritti di amministratore per l'esecuzione di questo comando.