Guida in linea di DMM Studio › DMM Studio › Struttura del linguaggio › Comandi Apply

Comandi Apply

I comandi Apply utilizzati negli script CA DMM sono i seguenti:

ApplyDirectory

Applica il contenuto di una directory dal computer di origine a quello di destinazione. Questo comando utilizza due o tre parametri. Il primo parametro è il percorso della directory e un valore di stringa. Il secondo parametro è una delle costanti di sovrascrittura illustrate di seguito o un nuovo percorso di directory. Esistono tre costanti che indicano il metodo di sovrascrittura: SEMPRE, PIÙ RECENTE o MAI. Se la costante di sovrascrittura viene omessa, viene applicato il predefinito PIÙ RECENTE o il metodo di sovrascrittura selezionato dall'utente. Se il secondo parametro è un nuovo percorso di directory, il contenuto della directory <nome directory> è applicato al <nuovo nome directory>. È consentito un metodo di sovrascrittura facoltativo. Possono essere applicate solo le directory che sono state archiviate. Quando si effettua uno spostamento, se il percorso di archiviazione contiene un carattere jolly, non includere tale carattere nel percorso di spostamento.

Primo parametro:

Il nome della directory (valore stringa)

Secondo parametro:

Il nuovo nome della directory (valore stringa).

Terzo parametro:

Il metodo di sovrascrittura (valore di stringa).

Uso:

ApplyDirectory(<Directory name>, [overwrite method]); or

ApplyDirectory(<Directory name>, <new Directory name>, [overwrite method]);

Esempio:

ApplyDirectory("c:\\My Documents");
ApplyDirectory("c:\\My Documents", NEWER);
ApplyDirectory("c:\\My Documents", "c:\\Word Documents");
ApplyDirectory("c:\\My Documents", "c:\\Word Documents", ALWAYS);
/*Wildcard example*/
ApplyDirectory("c:\\My Documents\\*.fol", "c:\\New Path\\Word Documents", ALWAYS);

ApplyFile

Applica un file dal computer di origine a quello di destinazione. Questo comando utilizza due o tre parametri. Il primo parametro è il nome del file ed è un valore di stringa. Il secondo parametro è una delle costanti di sovrascrittura illustrate di seguito o un nuovo percorso di file. Esistono tre costanti che indicano il metodo di sovrascrittura: SEMPRE, PIÙ RECENTE o MAI. Se la costante di sovrascrittura viene omessa, viene applicato il predefinito PIÙ RECENTE o il metodo di sovrascrittura selezionato dall'utente. Se il secondo parametro è un nuovo percorso di file, il <nome file> viene applicato a <nuovo nome file>. È consentito anche un metodo di sovrascrittura facoltativo. Questo comando riconosce l'asterisco (*) come carattere jolly. Si possono applicare solo i file che sono stati archiviati. Quando si effettua uno spostamento, se il percorso di archiviazione contiene un carattere jolly, non includere tale carattere nel percorso di spostamento.

Primo parametro:

Il nome di file (valore stringa)

Secondo parametro:

Il nuovo nome di file (valore stringa).

Terzo parametro:

Il metodo di sovrascrittura (valore di stringa).

Uso:

ApplyFile(<File name>, [overwrite method]); or

ApplyFile(<File name>, <new File name>, [overwrite method]);

Esempio:

ApplyFile("c:\\temp\\file.txt");
/*Wildcard example*/
ApplyFile("c:\\My Documents\\*.txt", "c:\\New Path\\Word Documents", ALWAYS);

ApplyKey

Applica una chiave di registro, inclusi tutti i relativi valori o una sezione di file ini con i relativi valori dal computer di origine a quello di destinazione. Questo comando può utilizzare due parametri. Si possono applicare solo le chiavi che sono state archiviate.

Primo parametro:

Il percorso della chiave (valore stringa)

Secondo parametro:

Il nuovo percorso della chiave (valore stringa)

Uso:

ApplyKey(<Key path>, [new Key path]);

Esempio

ApplyKey("HKLM\\Software\\Microsoft\\Office\\8.0\\Word\\Data\\Toolbar");

ApplyMappedFile

Applica un file dal computer di origine a quello di destinazione. Se ci sono dei dati del file che specificano un percorso di directory, questi dati vengono associati al percorso appropriato.

Primo parametro:

Il percorso del file (valore di stringa)

Secondo parametro:

Il nuovo nome di file (valore stringa).

Terzo parametro:

Il metodo di sovrascrittura (valore di stringa).

Uso:

ApplyMappedFile(<File name>, [overwrite method]); or

ApplyMappedFile(<File name>, <new File name>, [overwrite method]);

Esempi:

ApplyMappedFile("c:\\temp\\file.txt");

ApplyMappedFile("c:\\My Documents\\file.txt", "c:\\New Path\\Word Documents\\file.txt", ALWAYS);

ApplyMappedKey

Applica una chiave di registro e i relativi valori oppure una sezione di file INI e i relativi valori dal computer di origine a quello di destinazione. Quando i nomi dei valori o i dati dei valori sono percorsi di directory, vengono associati ai percorsi appropriati. Questo comando può utilizzare due parametri. Si possono applicare solo le chiavi che sono state archiviate.

Primo parametro:

Il percorso della chiave (valore stringa)

Secondo parametro:

Il nuovo percorso della chiave (valore stringa)

Uso:

ApplyMappedKey(<Key path>, [new Key path]);

Esempio:

ApplyMappedKey("HKLM\\Software\\Microsoft\\Office\\8.0\\Word\\Data\\Toolbar");

ApplyMappedSubKeys

Applica una chiave di registro e tutti i relativi valori e sottochiavi, oppure una sezione di file INI e i relativi valori dal computer di origine a quello di destinazione. Quando i nomi dei valori o i dati dei valori sono percorsi di directory, vengono associati ai percorsi appropriati. Questo comando può utilizzare due parametri. Si possono applicare solo le chiavi che sono state archiviate.

Primo parametro:

Il percorso della chiave (valore stringa)

Secondo parametro:

Il nuovo percorso della chiave (valore stringa)

Uso:

ApplyMappedSubKeys(<Key path>, [new Key path]);

Esempio:

ApplyMappedSubKeys("HKLM\\Software\\Microsoft\\Office\\8.0\\Word\\Data\\Toolbar");

ApplyMappedValue

Applica un valore della chiave di registro o un valore di file .ini dal computer di origine a quello di destinazione. Se il nome del valore o il valore è un percorso di directory, viene associato al percorso appropriato. Il comando può utilizzare sei parametri. Solo i valori che sono stati archiviati come associati possono essere applicati come associati.

Primo parametro:

Il percorso della chiave (valore stringa)

Secondo parametro:

Il nome del valore (valore stringa)

Nota: se il valore è predefinito, il secondo parametro dovrebbe essere NULL ("")

Terzo parametro:

Il nuovo percorso della chiave (valore stringa)

Nota: se non si sposta il valore nella nuova posizione, il terzo parametro dovrebbe essere NULL ("")

Quarto parametro:

Il delimitatore (valore stringa)

Quinto parametro:

Indicatore Shortpaths (valore booleano)

Sesto parametro:

Se si effettua lo spostamento, il nuovo nome del valore (valore stringa)

Uso:

ApplyMappedValue(<Key path>, <Value name>, [new Key path], [delimiter], [shortpaths], [new Value name]);

Esempi:

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips");

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips","HKLM\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar");

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips", "HKLM\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", ";");

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips", "", ";");

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\", "Tooltips", "", ";", true);

ApplySubKeys

Applica una chiave di registro e tutti i relativi valori e sottochiavi dal computer di origine a quello di destinazione. Questo comando può utilizzare due parametri. Si possono applicare solo le chiavi che sono state archiviate.

Primo parametro:

Il percorso della chiave (valore stringa)

Secondo parametro:

Il nuovo percorso della chiave (valore stringa)

Uso:

ApplySubKeys(<Key path>, [new Key path]);

Esempio:

ApplySubKeys("HKCU\\Software\\Microsoft\\Office\\8.0\\Word");

ApplyValue

Applica un valore della chiave di registro dal computer di origine a quello di destinazione. Questo comando utilizza quattro parametri. Si possono applicare solo i valori che sono stati archiviati.

Primo parametro:

Il percorso della chiave (valore stringa)

Secondo parametro:

Il nome del valore (valore stringa)

Terzo parametro:

Il nuovo percorso della chiave (valore stringa)

Quarto parametro:

Il nuovo nome del valore (valore stringa)

Uso:

ApplyValue(<Key path>, <Value name>, [new Key path], [new Value name]);

Esempio:

ApplyValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips");

DeleteKey

Cancella una chiave e tutti i relativi valori e chiavi secondarie dal registro o dai file ini. Se si verificano problemi relativi alla cancellazione della chiave, restituisce Falso. Se la chiave non esiste, restituisce Vero. Se il percorso è per un file ini, vengono cancellate tutte le sezioni contenute nel file ini.

Primo parametro:

Il percorso della chiave (valore stringa)

Esempio:

DeleteKey( "HKCU\\Software\\MyApp");
DeleteKey( "c:\\windows\\test.ini\\Keyname");
/* all keys deleted */
DeleteKey( "c:\\windows\\test.ini");

DeleteValue

Cancella un valore dal registro o dai file ini. Se si verificano problemi relativi alla cancellazione del valore, restituisce Falso. Se il valore non esiste, restituisce Vero.

Primo parametro:

Il percorso della chiave (valore stringa)

Secondo parametro:

Il nome del valore (valore stringa)

Esempio:

DeleteValue( "HKCU\\Software\\MyApp", "SomeValue");

DeleteValue( "c:\\windows\\win.ini\", "SomeValue");

SetKey

Crea o imposta una chiave.

Primo parametro:

Il percorso della chiave (valore stringa)

Esempio:

SetKey("HKLM\\New Key");

SetValue

Il comando SetValue crea o imposta un valore chiave. Se la chiave non esiste, questo comando la crea.

Il comando presenta il seguente formato:

SetValue(<FilePath>, <ValueName>, <Dati>, <Tipo>)

Filepath

(Per registro) Rappresenta il percorso chiave (valore stringa).

(Per XML) Rappresenta il percorso file completo.

ValueName

(Per registro) Rappresenta il nome valore (valore stringa).

(Per XML) Rappresenta la query XPath valida.

Dati

Rappresenta il valore.

Tipo

Rappresenta il tipo valore.

Di seguito sono elencati i valori del registro accettati:

Esempio: imposta un valore chiave

• Questo esempio imposta un valore chiave per il registro:

  SetValue("HKLM\\Destination", "String Value", "This is a string value", STRING);
  

• Questo esempio imposta un valore chiave in caso di XML:

  SetValue("C:\\abc.xml", "/docnode/node1/node2", "It is a node", "");