Table Environment
La table Environment est utilisée pour définir les valeurs des variables d’environnement.
La table Environment présente les colonnes suivantes.
| Colonne | Type | Clé | Nullable |
|---|---|---|---|
| Environnement | Identificateur | O | N |
| Nom | Texte | N | N |
| Valeur | Formatted | N | O |
| Component_ | Identificateur | N | N |
Colonnes
-
Environnement
-
Il s’agit de la clé primaire de la table et d’un jeton non localisé.
-
Nom
-
Cette colonne est le nom localisable de la variable d’environnement. Les valeurs de clé sont écrites ou supprimées en fonction des caractères du tableau suivant préfixés au nom. L’ordre des symboles utilisés dans un préfixe n’a pas d’influence.
Préfixe Description = Créer la variable d’environnement si elle n’existe pas, puis la définir lors de l’installation. Si la variable d’environnement existe, définissez-la pendant l’installation. + Créer la variable d’environnement si elle n’existe pas, puis la définir lors de l’installation. Cela n’a aucun effet sur la valeur de la variable d’environnement si elle existe déjà. - Supprimer la variable d’environnement lorsque le composant est supprimé. Ce symbole peut être combiné avec n’importe quel préfixe. ! Supprimer la variable d’environnement pendant une installation. Le programme d’installation supprime une variable d’environnement lors d’une installation uniquement si le nom et la valeur de la variable correspondent aux entrées des champs Name et Value de la table Environment. Si vous souhaitez supprimer une variable d’environnement, quelle que soit sa valeur, utilisez la syntaxe « ! » et laissez le champ Value vide. * Ce préfixe est utilisé avec Windows 2000 pour indiquer que le nom fait référence à une variable d’environnement système. Si aucun astérisque n’est présent, le programme d’installation écrit la variable dans l’environnement de l’utilisateur. Ce symbole peut être combiné avec n’importe quel préfixe. Un package utilisé pour l’installation dans le contexte d’installation par ordinateur doit écrire des variables d’environnement dans l’environnement de l’ordinateur en incluant * dans la colonne Name. Pour plus d'informations, consultez la section Notes. =- La variable d’environnement est définie lors de l’installation et supprimée lors de la désinstallation. Il s’agit du comportement habituel. !- Supprime une variable d’environnement lors d’une installation ou d’une désinstallation. =+ !+
!=Il ne s’agit pas d’un préfixe valide Si le champ Value dans la table inclut un [~], les caractères de préfixe s’appliquent uniquement à la partie spécifiée de la chaîne. L’utilisation de [~] est décrite ci-dessous dans la section colonne Value.
La variable d’environnement est supprimée si le champ Value de la table est vide. Par conséquent, avec un vide dans le champ Value, un préfixe « = » supprime la variable d’environnement lors de l’installation, et un préfixe « - » supprime toutes les valeurs actuelles lors de la désinstallation.
-
Valeur
-
Cette colonne contient la valeur localisable qui doit être définie en tant que chaîne mise en forme. Consultez Mise en forme. Si ce champ est laissé vide, la variable est supprimée. Si le champ est vide et que la chaîne du champ Name est précédée du symbole « - », la variable est supprimée uniquement lorsque le composant est supprimé.
Pour ajouter une valeur à la fin d’une variable existante, préfixez la chaîne de ce champ par le caractère Null [~] et le caractère séparateur. Par exemple, si le point-virgule est le séparateur choisi : [~];Valeur.
Pour préfixer une valeur au début d’une variable existante, ajoutez la chaîne dans ce champ par le caractère de séparateur et le caractère Null [~]. Par exemple, si le point-virgule est le séparateur choisi : Valeur;[~].
Si aucun [~] n’est présent dans le champ, la chaîne représente la valeur entière à définir ou à supprimer.
Chaque ligne ne peut contenir qu’une seule valeur. Par exemple, l’entrée Valeur;Valeur;[~] représente plusieurs valeurs et ne doit pas être utilisée, car cela provoquerait des résultats imprévisibles. L’entrée Value;[~] n’est qu’une seule valeur.
Si Name est précédé de +, [~] ne doit pas être utilisé dans la colonne Value. Cela est dû au fait que les significations de « + » et « [~] » sont clairement mutuellement exclusives.
-
Component_
-
Clé externe de la première colonne de la table Component. Cette colonne fait référence au composant qui contrôle l’installation des valeurs d’environnement.
Notes
Pour que le programme d’installation définisse des variables d’environnement, les actions WriteEnvironmentStrings et RemoveEnvironmentStrings doivent être répertoriées dans la table InstallExecuteSequence.
Notez que les variables d’environnement ne changent pas pour l’installation en cours lorsque l’action WriteEnvironmentStrings ou RemoveEnvironmentStrings est exécutée. Sur Windows 2000, ces informations sont stockées dans le Registre, et un message informe le système des modifications à la fin de l’installation. Un nouveau processus, ou un autre processus qui recherche ces messages, utilise les nouvelles variables d’environnement.
Lorsque vous modifiez la variable d’environnement de chemin d’accès avec la table Environment, n’essayez pas d’entrer explicitement l’intégralité du nouveau chemin d’accès dans le champ Value. Au lieu de cela, étendez le chemin existant en préfixant ou en ajoutant une valeur et un délimiteur (;) à [~]. Si [~] n’est pas présent dans le champ Value, les informations de chemin d’accès existantes sont perdues, et l’installation du fichier .msi peut empêcher le démarrage de l’ordinateur. La variable de chemin d’accès est généralement définie à l’aide de la syntaxe suivante : [~];Valeur.
Lorsque vous effectuez des installations par ordinateur à partir d’un serveur Terminal, le programme d’installation écrit des variables d’environnement par utilisateur dans HKU\.Default\Environment. Étant donné que les services Terminal ne répliquent pas cette section du Registre, l’installation ne définit pas les variables d’environnement par utilisateur. Un package utilisé pour les installations par ordinateur doit écrire des variables d’environnement dans l’environnement de l’ordinateur en incluant * dans la colonne Name. Si le package peut être installé par utilisateur ou par machine, créez deux composants : (1) un composant par utilisateur avec les entrées de table Environment créées pour les paramètres utilisateur, et (2) un composant par ordinateur avec la table Environment créée pour les paramètres de l’ordinateur. Conditionner l’installation de ce composant à l’aide de la propriété Privileged.