Commandes Apply

Aide en ligne de Studio DMM › Studio DMM › Structure du langage › Commandes Apply

Commandes Apply

Les lignes suivantes répertorient les commandes Apply utilisées dans les scripts CA DMM.

ApplyDirectory

Applique le contenu d'un répertoire de l'ordinateur source à l'ordinateur de destination. Cette commande utilise deux ou trois paramètres. Le premier paramètre, de type chaîne, est le chemin d'accès au répertoire. Le deuxième paramètre correspond au nouveau chemin d'accès au répertoire ou à l'une des constantes de remplacement décrites ci-dessous. Trois constantes indiquent la méthode d'écrasement : ALWAYS (toujours), NEWER (plus récent) et NEVER (jamais). Si la constante de remplacement est omise, la constante par défaut (NEWER, plus récent) ou la méthode de remplacement sélectionnée par l'utilisateur est appliquée. Si le deuxième paramètre est un nouveau chemin d'accès au répertoire, le contenu du répertoire <nom du répertoire> est appliqué au répertoire <nouveau nom du répertoire>. Il est possible de spécifier une méthode de remplacement optionnelle. Seuls les répertoires qui ont été stockés peuvent être appliqués. Lors du déplacement, si le chemin de stockage contient une chaîne de caractères génériques, n'incluez pas les caractères génériques dans le chemin de déplacement.

Premier paramètre :

Nom du répertoire (valeur de type chaîne)

Deuxième paramètre :

Nouveau nom du répertoire (valeur de type chaîne)

Troisième paramètre :

Méthode de remplacement (valeur de type chaîne)

Syntaxe :

ApplyDirectory(<nom du répertoire>, [méthode de remplacement]); ou

ApplyDirectory(<nom du répertoire>, <nouveau nom répertoire>, [méthode de remplacement]);

Exemple :

ApplyDirectory("c:\\Mes documents");
ApplyDirectory("c:\\Mes documents", NEWER);
ApplyDirectory("c:\\Mes documents", "c:\\Documents Word");
ApplyDirectory("c:\\Mes Documents", "c:\\Documents Word", ALWAYS);
/*Wildcard example*/
ApplyDirectory("c:\\Mes documents\\*.fol", "c:\\Nouveau chemin\\Documents Word", ALWAYS);

ApplyFile

Applique un fichier de l'ordinateur source à l'ordinateur de destination. Cette commande utilise deux ou trois paramètres. Le premier paramètre, de type chaîne, est le nom du fichier. Le deuxième paramètre correspond au nouveau chemin d'accès au fichier ou à l'une des constantes de remplacement décrites ci-dessous. Trois constantes indiquent la méthode d'écrasement : ALWAYS (toujours), NEWER (plus récent) et NEVER (jamais). Si la constante de remplacement est omise, la constante par défaut (NEWER, plus récent) ou la méthode de remplacement sélectionnée par l'utilisateur est appliquée. Si le deuxième paramètre est un nouveau chemin d'accès au fichier, le fichier <nom du fichier> est appliqué au fichier <nouveau nom de fichier>. Il est également possible de spécifier une méthode de remplacement optionnelle. Cette commande reconnaît l'astérisque (*) comme un caractère générique. Seuls les fichiers qui ont été stockés peuvent être appliqués. Lors du déplacement, si le chemin de stockage contient une chaîne de caractères génériques, n'incluez pas les caractères génériques dans le chemin de déplacement.

Premier paramètre :

Nom du fichier (valeur de type chaîne)

Deuxième paramètre :

Nouveau nom du fichier (valeur de type chaîne)

Troisième paramètre :

Méthode de remplacement (valeur de type chaîne)

Syntaxe :

ApplyFile(<Nom fichier>, [méthode de remplacement]); ou

ApplyFile(<Nom fichier>, <nouveau nom fichier>, [méthode de remplacement]);

Exemple :

ApplyFile("c:\\temp\\file.txt");
/*Wildcard example*/
ApplyFile("c:\\Mes documents\\*.txt", "c:\\Nouveau chemin\\Word Documents", ALWAYS);

ApplyKey

Applique une clé de registre et l'ensemble de ses valeurs ou une section de fichier ini et l'ensemble de ses valeurs de l'ordinateur source vers l'ordinateur de destination. Cette commande accepte deux paramètres. Seules les clés stockées peuvent être appliquées.

Premier paramètre :

Chemin d'accès à la clé (valeur de type chaîne)

Deuxième paramètre :

Nouveau chemin d'accès à la clé (valeur de type chaîne)

Syntaxe :

ApplyKey(<chemin de la clé>, [nouveau chemin de la clé]);

Exemple

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

ApplyMappedFile

Applique un fichier de l'ordinateur source à l'ordinateur de destination. Si une donnée quelconque du fichier indique un chemin d'accès au répertoire, celui-ci est mappé en fonction du chemin approprié.

Premier paramètre :

Chemin d'accès (valeur de type chaîne)

Deuxième paramètre :

Nouveau nom du fichier (valeur de type chaîne)

Troisième paramètre :

Méthode de remplacement (valeur de type chaîne)

Syntaxe :

ApplyMappedFile(<nom fichier>, [méthode de remplacement]) ; ou

ApplyMappedFile(<nom fichier>, <nouveau nom fichier>, [méthode de remplacement]);

Exemples :

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

ApplyMappedFile("c:\\Mes documents\\fichier.txt", "c:\\Nouveau chemin\\Documents Word\\fichier.txt", ALWAYS);

ApplyMappedKey

Applique une clé de registre et l'ensemble de ses valeurs, ou une section de fichier .ini et l'ensemble de ses valeurs, de l'ordinateur source vers l'ordinateur de destination. Si le nom ou les données de l'une des valeurs correspond à un chemin d'accès à un répertoire, ce nom ou ces données sont mappés en fonction du chemin d'accès approprié. Cette commande accepte deux paramètres. Seules les clés stockées peuvent être appliquées.

Premier paramètre :: Chemin d'accès à la clé (valeur de type chaîne)
Deuxième paramètre :

Nouveau chemin d'accès à la clé (valeur de type chaîne)

Syntaxe :

ApplyMappedKey(<chemin de la clé>, [nouveau chemin de la clé]);

Exemple :

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

ApplyMappedSubKeys

Applique une clé de registre, ainsi que l'ensemble de ses valeurs et de ses sous-clés, ou une section de fichier .ini et l'ensemble de ses valeurs, de l'ordinateur source vers l'ordinateur de destination. Si le nom ou les données de l'une des valeurs correspond à un chemin d'accès à un répertoire, ce nom ou ces données sont mappés en fonction du chemin d'accès approprié. Cette commande accepte deux paramètres. Seules les clés stockées peuvent être appliquées.

Premier paramètre :

Chemin d'accès à la clé (valeur de type chaîne)

Deuxième paramètre :

Nouveau chemin d'accès à la clé (valeur de type chaîne)

Syntaxe :

ApplyMappedSubKeys(<chemin de la clé>, [nouveau chemin de la clé]);

Exemple :

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

ApplyMappedValue

Applique une valeur de clé de registre ou une valeur de fichier .ini de l'ordinateur source vers l'ordinateur de destination. Si le nom de la valeur ou la valeur correspond à un chemin d'accès à un répertoire, il ou elle est mappé en fonction du chemin d'accès approprié. Cette commande accepte six paramètres. Seules les valeurs stockées en tant que valeurs mappées peuvent être appliquées sous leur forme mappée.

Premier paramètre :: Chemin d'accès à la clé (valeur de type chaîne)
Deuxième paramètre :: Nom de valeur (valeur de type chaîne)

Remarque : Si la valeur correspond à la valeur par défaut, le deuxième paramètre doit être NULL ("")

Troisième paramètre :: Nouveau chemin d'accès à la clé (valeur de type chaîne)

Remarque : Si la valeur n'est pas déplacée vers un nouvel emplacement, le troisième paramètre doit être NULL ("")

Quatrième paramètre :

Le délimiteur (valeur de type chaîne)

Cinquième paramètre :

Indicateur Shortpaths (valeur de type booléen)

Sixième paramètre :

En cas de déplacement, correspond au nouveau nom de la valeur (valeur de type chaîne)

Syntaxe :

ApplyMappedValue(<chemin de la clé>, <nom valeur>, [nouveau chemin de la clé], [délimiteur], [chemins courts], [nouveau nom valeur]);

Exemples :

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

Applique une clé de registre, ainsi que l'ensemble de ses valeurs et de ses sous-clés, de l'ordinateur source vers l'ordinateur de destination. Cette commande accepte deux paramètres. Seules les clés stockées peuvent être appliquées.

Premier paramètre :

Chemin d'accès à la clé (valeur de type chaîne)

Deuxième paramètre :

Nouveau chemin d'accès à la clé (valeur de type chaîne)

Syntaxe :

ApplySubKeys(<chemin de la clé>, [nouveau chemin de la clé]);

Exemple :

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

ApplyValue

Applique une valeur de clé de registre de l'ordinateur source vers l'ordinateur de destination. Cette commande accepte quatre paramètres. Seules les valeurs stockées peuvent être appliquées.

Premier paramètre :

Chemin d'accès à la clé (valeur de type chaîne)

Deuxième paramètre :

Nom de valeur (valeur de type chaîne)

Troisième paramètre :

Nouveau chemin d'accès à la clé (valeur de type chaîne)

Quatrième paramètre :

Nouveau nom de la valeur (valeur de type chaîne)

Syntaxe :

ApplyValue(<chemin de la clé>, <nom valeur>, [nouveau chemin de la clé], [nouveau nom valeur]);

Exemple :

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

DeleteKey

Supprime une clé et toutes ses valeurs et sous-clés du registre ou des fichiers ini. Renvoie False en cas de problèmes pour supprimer la clé. Renvoie True, si la clé n'existe pas. Si le chemin d'accès conduit à un fichier ini, toutes les sections de ce fichier sont supprimées.

Premier paramètre :

Chemin d'accès à la clé (valeur de type chaîne)

Exemple :

DeleteKey( "HKCU\\Software\\MyApp");
DeleteKey( "c:\\windows\\test.ini\\nom de la clé");
/* supprimer toutes les clés*/
DeleteKey( "c:\\windows\\test.ini");

DeleteValue

Supprime une valeur du registre ou des fichiers ini. Renvoie False en cas de problèmes pour supprimer la valeur. Renvoie True si la valeur n'existe pas.

Premier paramètre :: Chemin d'accès à la clé (valeur de type chaîne)
Deuxième paramètre :

Nom de la valeur (valeur de chaîne)

Exemple :

DeleteValue( "HKCU\\Software\\MyApp", "une valeur");

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

SetKey

Crée ou définit une clé.

Premier paramètre :

Chemin d'accès à la clé (valeur de type chaîne)

Exemple :

SetKey("HKLM\\Nouvelle clé");

SetValue

La commande SetValue permet de créer ou de définir une valeur de clé. Si la clé n'existe pas, cette fonction la crée.

Cette commande a le format suivant :

SetValue(<FilePath>, <ValueName>, <Data>, <Type>)

FilePath

Pour le registre, cette variable représente le chemin d'accès à la clé (valeur de chaîne).

Pour un fichier XML, cette variable représente le chemin d'accès complet au fichier.

ValueName

Pour le registre, cette variable représente le nom de la valeur (valeur de chaîne).

Pour un fichier XML, cette variable représente la requête XPath valide.

Données

Représente la valeur.

Type

Représente le type de valeur.

Les valeurs de registre suivantes sont acceptées :

Valeur	Format	Exemple
STRING	string	"Brian"
DWORD	number	"1999"
BINARY	binaire	"af 45 99 31"
DWORD_LITTLE_ENDIAN	number	"1234"
DWORD_BIG_ENDIAN	number	"1234"
SYMBOLIC_LINK	binaire	"af 45 99 31"
MULTI_STRING	binaire	"af 45 99 31"
RESOURCE_LIST	binaire	"af 45 99 31"
EXPAND_STRING	string	"Brian"
FULL_RESOURCE_DESCRIPTOR	binaire	"af 45 99 31"
RESOURCE_REQUIREMENTS_LIST	binaire	"af 45 99 31"

Exemple : Définition d'une valeur de clé

Cet exemple illustre la définition d'une valeur de clé pour le registre :

SetValue("HKLM\\Destination", "valeur de chaîne", "il s'agit d'une valeur de chaîne", STRING);

Cet exemple illustre la définition d'une valeur de clé pour un fichier XML :

SetValue("C:\\abc.xml", "/docnode/node1/node2", "Il s'agit d'un noeud", "");