Commande addUserToDestinationRole
La commande addUserToDestinationRole permet d'ajouter un utilisateur aux rôles de destination d'un bus local ou externe.
Pour exécuter la commande, utilisez l'objet AdminTask du client de scriptage wsadmin.
Le client de scriptage wsadmin est exécuté à partir de Qshell.
Pour plus d'informations, voir Configuration de Qshell pour exécuter des scripts WebSphere à l'aide de l'outil de scriptage wsadmin.
- Pour obtenir une liste des commandes de sécurité de bus d'intégration de services
disponibles dans Jython et une brève description de chacune d'elles, entrez la commande suivante
à l'invite wsadmin :
print AdminTask.help('SIBAdminBusSecurityCommands')
- Pour obtenir une aide générale sur une commande donnée,
entrez la commande suivante à l'invite wsadmin :
print AdminTask.help('nom_commande')
AdminConfig.save()
Rôle
La commande addUserToDestinationRole permet d'octroyer à un utilisateur l'accès aux destinations de bus local pour les rôles spécifiés. Les rôles que vous pouvez spécifier dépendent du type de destination.
Objet cible
Aucun.
Paramètres requis
- -type typeDestination
- Vous pouvez spécifier l'un des types de destination suivants :
- File d'attente
- Port
- espaceSujet
- destinationExterne
- Alias
Les rôles autorisés pour une destination dépendent du type de destination, tel qu'il est défini dans Administration des rôles de destination.
Si vous spécifiez comme paramètre typedestination une destination externe ou un alias, le nom du bus externe que vous spécifiez doit correspondre au nom du bus externe qui héberge la destination.
Si la valeur du paramètre typeDestination est file d'attente ou sujet, le nom du bus externe est ignoré. L'autorisation est accordée par rapport à la destination du bus local.
- -bus nomBus
- Nom du bus local. Vous pouvez utiliser la commande listSIBuses pour afficher la liste des noms des bus existants.
- -role typeRôle
- Vous pouvez spécifier l'un des types de rôle ci-après, en fonction du paramètre -type que vous avez spécifié.
- Expéditeur
- Ce type de rôle est autorisé à envoyer des messages à des destinations du bus local.
- Récepteur
- Ce type de rôle est autorisé à recevoir des messages des destinations du bus local.
- Navigateur
- Ce type de rôle est autorisé à consulter les messages sur les destinations du bus local.
- -user nomUtilisateur
- Nom de l'utilisateur à ajouter au rôle de type destination du bus local.
Paramètres conditionnels
Aucun.
Paramètres optionnels
- -foreignBus nomBusExterne
- Spécifiez le nom du bus externe. Si vous ajoutez un utilisateur à une destination sur un alias ou une destination externe, vous devez spécifier le nom du bus externe qui héberge l'alias ou la destination externe.
- -uniqueName nomUnique
- Ce paramètre est valide uniquement lorsqu'il est utilisé avec des serveurs d'applications WebSphere Application Server Version 7.0 ou ultérieures. Ne l'utilisez pas avec des versions antérieures. Spécifiez le nom qui définit de manière unique l'utilisateur dans le registre d'utilisateurs. Si un registre d'utilisateurs LDAP est en cours d'utilisation, le nom unique correspond au nom distinctif de l'utilisateur. Vous pouvez spécifier des valeurs à la fois pour -uniqueName et -user, mais vous devez vous assurer qu'ils identifient le même utilisateur. La commande ne vérifie pas que les valeurs correspondent.
Exemples
L'exemple ci-après ajoute l'utilisateur User1 au rôle d'expéditeur sur la destination de type file d'attente Queue1, sur le bus local Bus1.
Admintask.addUserToDestinationRole ('[-type queue -bus Bus1
-destination Queue1 -role Sender -user User1]')
L'exemple ci-après ajoute l'utilisateur User2 au rôle de récepteur de la destination de type file d'attente Queue2, sur le bus local Bus1.
Admintask.addUserToDestinationRole ('[-type queue -bus Bus1
-destination Queue2 -role Receiver -user User2]')