DEFINE CLIENTACTION (Definizione di un'azione client singola)

Classe di privilegi

Per immettere questo comando, è necessario avere il privilegio di sistema, il privilegio della politica senza limitazioni o il privilegio limitato al dominio della politica a cui appartiene la pianificazione.

Parametri

nome_nodo (Obbligatorio)

Specifica il nome del nodo client che elaborerà la pianificazione associata all'azione. Se si specificano più nomi nodo, separare i nomi con virgole; non utilizzare spazi intermedi. È possibile utilizzare il carattere asterisco per specificare più nomi.

DOmain

Specifica l'elenco di domini delle politiche utilizzati per limitare l'elenco di nodi client. Viene eseguita la pianificazione solo dei nodi client assegnati ad uno dei domini delle politiche specificati. Sarà eseguita la pianificazione di tutti i client associati ad un dominio corrispondente. Separare più nomi di dominio con virgole, non con gli spazi. Se non si specifica un valore, vengono inclusi nell'elenco tutti i domini delle politiche.

ACTion

Specifica l'azione che si verifica quando viene eseguita questa pianificazione. I valori possibili sono:

Incremental

Specifica che la pianificazione esegue un backup di tutti i file nuovi o che sono stati modificati dall'ultimo backup incrementale. Incremental, inoltre, esegue un backup di ogni file per cui tutti i backup esistenti potrebbero essere scaduti.

Selective

Specifica che la pianificazione esegue il backup solo dei file specificati con il parametro OBJECTS.

Archive

Specifica che la pianificazione archivia i file specificati con il parametro OBJECTS.

Backup

Specifica che la pianificazione esegue il backup dei file specificati con il parametro OBJECTS.

REStore

Specifica che la pianificazione ripristina i file specificati con il parametro OBJECTS.

Quando si specifica ACTION=RESTORE per un'operazione pianificata e l'opzione REPLACE è impostata su PROMPT, non avviene alcuna richiesta. Se l'opzione viene impostata su PROMPT, i file vengono ignorati.

Se si specifica una nuova specifica file, tale specifica agisce come destinazione di ripristino. Se è necessario ripristinare più gruppi di file, pianificarne uno per ogni specifica file da ripristinare.

RETrieve

Indica che la pianificazione richiama i file specificati con il parametro OBJECTS.

Nota: un secondo file specificato agisce come destinazione di richiamo. Se è necessario richiamare più gruppi di file, creare una pianificazione separata per ogni gruppo di file.

IMAGEBACkup

Specifica che la pianificazione esegue il backup dei volumi logici specificati con il parametro OBJECTS.

IMAGEREStore

Specifica che la pianificazione ripristina i volumi logici specificati con il parametro OBJECTS.

Command

Specifica che la pianificazione elabora un comando del sistema operativo client che viene specificato con il parametro OBJECTS.

Macro

Specifica che un client esegue una macro il cui nome file è specificato con il parametro OBJECTS.

SUBACTion

È possibile specificare uno dei seguenti valori:

""

Quando viene specificata una stringa null (due virgolette doppie) con ACTION=BACKUP il backup è incrementale.

FASTBAck

Specifica che un'operazione client FastBack identificata dal parametro ACTION deve essere pianificata per l'elaborazione. Il parametro ACTION deve essere ARCHIVE o BACKUP.

SYSTEMSTate

Specifica che è stato pianificato il backup Systemstate di un client.

VApp

Specifica che è stato pianificato un backup vApp di un client. vApp è una raccolta di macchine virtuali pre-distribuiti.

VM

Specifica che è stata pianificata un'operazione di backup VMware di un client.

OPTions

Specifica le opzioni client specificate nel comando pianificato al momento dell'esecuzione della pianificazione. Questo parametro è facoltativo.

Per questo parametro possono essere specificate solo le opzioni valide nel comando di pianificazione. Consultare il manuale del client appropriato per informazioni sulle opzioni valide dalla riga comandi. Tutte le opzioni descritte come valide solo nella riga comandi iniziale causano un errore o vengono ignorate quando la pianificazione viene eseguita dal server. Ad esempio, non includere le seguenti opzioni poiché non hanno effetto quando il client esegue il comando pianificato:

• MAXCMDRETRIES
• OPTFILE
• QUERYSCHEDPERIOD
• RETRYPERIOD
• SCHEDLOGNAME
• SCHEDMODE
• SERVERNAME
• TCPCLIENTADDRESS
• TCPCLIENTPORT

Quando si definisce un servizio scheduler utilizzando il comando DSMCUTIL o la procedura guidata della GUI del client di backup - archivio, si specifica un file di opzioni. Non è possibile sostituire le opzioni presenti nel file delle opzioni eseguendo il comando pianificato. È necessario modificare le opzioni nel servizio di pianificazione.

Se la stringa di opzioni contiene più opzioni o opzioni con spazi incorporati, racchiudere l'intera stringa di opzioni in una coppia di apostrofi. Racchiudere tra virgolette opzioni singole contenenti spazi. Davanti all'opzione deve essere presente un segno meno, come guida. Si possono verificare degli errori se la stringa di opzioni contiene degli spazi che non sono racchiusi in maniera corretta.

I successivi esempi mostrano come specificare alcune opzioni di client:

• Per specificare subdir=yes e domain all-local -systemobject, immettere:
  • options='-subdir=yes -domain="all-local -c: -systemobject"'
• Per specificare domain all-local -c: -d:, immettere:
  • options='-domain="all-local -c: -d:"'

Suggerimento:

Per i client Windows in esecuzione in modalità batch, se è necessario utilizzare le virgolette, utilizzare la modalità interattiva o i caratteri di escape del sistema operativo. Per ulteriori informazioni, consultare i seguenti argomenti:

• t_cmdline_adclient.html #t_cmdline_adclient__process_series_cmd
• t_cmdline_adclient.html #t_cmdline_adclient__process_indivi_cmd

OBJects

Specifica gli oggetti per cui è eseguita l'azione specificata. Utilizzare un singolo spazio tra un oggetto e l'altro. Questo parametro è obbligatorio eccetto quando ACTION=INCREMENTAL. Se l'azione è un'operazione di backup, archivio, richiamo o ripristino, gli oggetti sono spazi file, directory o volumi logici. Se l'azione consiste nell'esecuzione di un comando o una macro, l'oggetto è il nome del comando o della macro da eseguire.

Quando si specifica ACTION=INCREMENTAL senza specificare un valore per questo parametro, il comando pianificato viene richiamato senza oggetti specificati e tenta di elaborare gli oggetti come definito nel file delle opzioni client. Per selezionare tutti gli spazi file o directory per un'azione, elencarli esplicitamente nella stringa oggetti. L'immissione di un solo asterisco nella stringa di oggetti determinerà l'esecuzione del backup solo per la directory in cui è stato avviato il programma di pianificazione.

Importante:

• Se si specifica una nuova specifica file che non rappresenta una destinazione valida, si riceve il seguente messaggio di errore:

  ANS1082E Invalid destination file specification <filespec> entered.

• Se si specificano più di due specifiche file, si riceve il seguente messaggio di errore:

  ANS1102E Excessive number of command line arguments passed to the 
  program!

Quando si specifica ACTION=ARCHIVE, INCREMENTAL o SELECTIVE per questo parametro, è possibile elencare un massimo di venti (20) specifiche di file.

Racchiudere la stringa di oggetti tra le doppie virgolette se contiene spazi e, quindi, racchiudere le doppie virgolette tra le singole virgolette. Se la stringa di oggetti contiene più nomi di file, racchiudere ciascun nome file con un paio di virgolette, quindi racchiudere la stringa in un paio di singole virgolette. E ' possibile che si verifichi un errore se i nomi file contengono spazi non racchiusi correttamente tra virgolette.

Se si utilizzano caratteri che hanno un significato speciale per gli utenti Windows, come le virgole, racchiudere l'intero argomento tra due coppie di virgolette doppie, quindi racchiudere l'intera stringa tra virgolette singole. I seguenti esempi mostrano in che modo specificare alcuni nomi file:

• Per specificare C:\FILE 2, D:\GIF FILES e E:\MY TEST FILE, immettere:
  • OBJECTS='"C:\FILE 2" "D:\GIF FILES" "E:\MY TEST FILE"'
• Per specificare D:\TEST FILE, immettere:
  • OBJECTS='"D:\TEST FILE"'
• Per specificare D:TEST,FILE:
  • OBJECTS='""D:\TEST,FILE""'

Gli esempi seguenti mostrano come specificare alcuni nomi di file:

• Per specificare /home/file 2, /home/gif files e /home/my test file, immettere:
  • OBJECTS='"/home/file 2" "/home/gif files" "/home/my test file"'
• Per specificare /home/test file, immettere:
  • OBJECTS='"/home/test file"'

Suggerimento:

Per i client Windows in esecuzione in modalità batch, se è necessario utilizzare le virgolette, utilizzare la modalità interattiva o i caratteri escape del sistema operativo. Per ulteriori informazioni, consultare i seguenti argomenti:

• Elaborazione di comandi singoli dal client di gestione
• Elaborazione di comandi singoli dal client di gestione

Wait

Specifica se attendere il completamento di un'operazione client pianificata. Questo parametro è utile quando si definiscono azioni client da uno script di comando o da una macro. Questo parametro è facoltativo. Il valore predefinito è NO. I valori possibili sono:

No

Specifica di non attendere il completamento di un'operazione client pianificata. Se viene specificato questo valore e il valore del parametro ACTION è COMMAND, il codice di ritorno indica se è stata definita l'azione client.

Yes

Specifica di attendere il completamento di un'operazione client pianificata. Se viene specificato questo valore e il valore del parametro ACTION è COMMAND, il codice di ritorno indica lo stato dell'operazione del client.

Non è possibile immettere il comando DEFINE CLIENTACTION con WAIT = YES dalla console del server. Tuttavia, dalla console del server, è possibile:

• Specificare WAIT=YES con DEFINE CLIENTACTION come riga di comando di un comando DEFINE SCRIPT.
• Specificare WAIT=YES con DEFINE CLIENTACTION come riga di comando di un file il cui contenuto verrà letto nello script definito da un comando DEFINE SCRIPT.

Limitazione: se si specifica il comando DEFINE CLIENTACTION con WAIT = YES in una macro, le pianificazioni immediate definite dal comando non eseguiranno il rollback se la macro non viene completata correttamente.

Comandi correlati