La sous-commande getmasterproperty permet d'extraire les propriétés
maître relatives à l'ensemble de bases de données spécifié par la sous-commande setmasterproperty.
Applicabilité
Plateforme : Windows (la
valeur de installutil est honorée par tous les clients sur toutes les plateformes, mais elle ne peut être lancée que depuis une plateforme Windows.)
Type de commande : sous-commande d'installutil
Syntaxe
- installutil getmasterproperty
- nom_ensemble_bases_de_données [ -user_db_name nom_base_de_données_utilisateur] connexion_cq mot_de_passe_cq propriété_maître | -all
Description
La sous-commande getmasterproperty extrait les propriétés
maître relatives à l'ensemble de bases de données spécifié par la sous-commande setmasterproperty.
Utilisez la sous-commande getmasterproperty avec les fonctions
de propriété maître suivantes :
- HOOKS_SEE_ALL_RECORDS. Spécifie si les requêtes exécutées par les points
d'ancrage doivent ignorer les contextes de sécurité pour filtrer les ensembles de résultats. Lorsque la valeur de cette propriété est TRUE, les enregistrements sont inclus dans l'ensemble de résultats même si leur contexte de sécurité aurait normalement empêché l'utilisateur d'y accéder. Lorsque cette valeur est FALSE, les requêtes exécutées par les points d'ancrage ont le même effet que si elles avaient été exécutées par l'utilisateur en cours. Résultat : les enregistrements que l'utilisateur ne serait pas normalement autorisé à voir n'apparaissent pas dans l'ensemble de résultats.
Remarque : Le schéma du niveau de fonction 5 définit par défaut cette valeur sur TRUE. Le schéma du niveau de fonction 6 définit par défaut cette valeur sur FALSE.
- HOOKS_SEE_ALL_USERS. Spécifie si les requêtes d'utilisateur et de groupe exécutées par les points
d'ancrage doivent ignorer l'appartenance au groupe pour filtrer les ensembles de résultats. Lorsque la valeur de cette propriété est TRUE, les informations de groupe ou d'utilisateur (en fonction du type de la requête) sont incluses dans l'ensemble de résultats même si l'utilisateur en cours n'est pas un membre. Lorsque cette valeur est FALSE, les requêtes d'utilisateur et de groupe exécutées par les points d'ancrage ont le même effet que si elles avaient été exécutées par l'utilisateur en cours.
Remarque : Le schéma du niveau de fonction 5 définit par défaut cette valeur sur TRUE. Le schéma du niveau de fonction 6 définit par défaut cette valeur sur FALSE.
- REMEMBER_PASSWORD. Indique la propriété maître Retenir le mot de passe
pour l'ensemble de bases de données. Cette propriété maître détermine si un client Rational ClearQuest Eclipse
se connectant à une base de données utilisateur de cet ensemble peut retenir
le mot de passe.
- SOFT_QUERY_LIMIT. Indique le nombre de lignes correspondant à la limite maximale
que les requêtes doivent renvoyer. Si la valeur de la propriété indique une limite maximale de 0,
la requête l'interprétera comme une autorisation à renvoyer un nombre illimité de lignes.
- HARD_QUERY_LIMIT. Indique le nombre absolu de lignes correspondant à la limite absolue
que les requêtes doivent renvoyer. Si la valeur de la propriété indique une limite maximale de 0,
la requête l'interprétera comme une autorisation à renvoyer un nombre illimité de lignes.
Options et arguments
- nom_ensembledb
- Nom de l'ensemble de bases de données ou connexion contenant la base de données à activer pour
l'authentification LDAP.
- -user_db_namenom_base_de_données_utilisateur
- Indique la base de données utilisateur à laquelle s'applique la propriété. Par défaut, la propriété s'applique à toutes les bases de données utilisateur.
- connexion_cq
- Nom de connexion Rational ClearQuest de l'administrateur. Cet utilisateur doit avoir des droits utilisateur de super-utilisateur et être marqué pour l'authentification Rational ClearQuest.
- mot_de_passe_cq
- Mot de passe Rational ClearQuest de l'administrateur. Pour indiquer un mot de passe vide, entrez simplement deux guillemets.
- propriété_maître
- Indique le nom de la propriété maître à extraire.
- nouvelle_valeur
- Indique la valeur de la propriété maître.
Exemple
Dans l'exemple suivant, la sous-commande
getmasterproperty
renvoie la propriété REMEMBER_PASSWORD pour l'ensemble de bases de données
mydbset.
Cette propriété maître détermine si un client
Rational ClearQuest Eclipse
se connectant à une base de données utilisateur de cet ensemble peut retenir
le mot de passe.
installutil getmasterproperty mydbset admin "" REMEMBER_PASSWORD
Starting test getmasterproperty
REMEMBER_PASSWORD="TRUE"
Exit code 0 for test getmasterproperty
A chaque connexion, le client Rational ClearQuest Eclipse
vérifie la propriété REMEMBER_PASSWORD. Si elle est fausse, le client efface
tous les mots de passe du disque et définit sur zéro tous les mots de passe présents dans la mémoire qui sont associés
à cet ensemble de base de données.
Le client peut placer cette valeur en cache avec les reste des informations de connexion. Il utilise ensuite cet indicateur sauvegardé
pour déterminer si les utilisateurs sont autorisés à enregistrer les mots de passe.