Mandato addUserToDestinationRole
Utilice el mandato addUserToDestinationRole para añadir un usuario a los roles de destino para un bus local o foráneo.
Para ejecutar el mandato, utilice el objeto AdminTask del cliente de scripts wsadmin.
El cliente de scripts wsadmin
se ejecuta desde Qshell.
Para obtener más información, consulte Configuración de Qshell para ejecutar scripts de WebSphere mediante el script wsadmin.
- Si desea una lista de los mandatos de seguridad disponibles del bus de integración de servicios en Jyton y una breve descripción de cada mandato, especifique el mandato siguiente en el indicador de wsadmin:
print AdminTask.help('SIBAdminBusSecurityCommands')
- Si desea ayuda general sobre un mandato determinado,
especifique el mandato siguiente en el indicador de wsadmin:
print AdminTask.help('nombre_mandato')
AdminConfig.save()
Finalidad
Utilice el mandato addUserToDestinationRole para otorgar a un usuario acceso a destinos de bus local para los roles especificados. Los roles que puede especificar dependen del tipo de destino.
Objeto de destino
Ninguna.
Parámetros necesarios
- -type tipoDestino
- Puede especificar uno de los siguientes tipos de destino:
- Cola
- Puerto
- TopicSpace
- ForeignDestination
- Alias
Los roles permitidos para un destino dependen del tipo de destino que se ha definido en Administración de roles de destino.
Si va a especificar un destinationType que es un foreignDestination o un alias, el nombre del bus foráneo que especifique debe ser el nombre del bus foráneo que aloja el destino.
Si especifica destinationType para una cola o tema, se ignora el nombre de bus foráneo. La autorización se concede al destino del bus local.
- -bus nombreBus
- El nombre del bus local. Puede utilizar el mandato listSIBuses para listar los nombres de los buses existentes.
- -roletipo_rol
- Puede especificar uno de los siguientes tipos de rol, en función del -type que haya especificado.
- Emisor
- Este tipo de rol tiene autorización para enviar mensajes a destinos del bus local.
- Receptor
- Este tipo de rol tiene autorización para recibir mensajes de destinos del bus local.
- Browser
- Este tipo de rol tiene autorización para examinar mensajes en destinos del bus local.
- -user nombreUsuario
- El nombre del usuario que desea añadir al tipo de rol de destino para el bus local.
Parámetros condicionales
Ninguna.
Parámetros opcionales
- -foreignBus nombreBusForáneo
- Especifique el nombre del bus foráneo. Si va a añadir un usuario a un destino en un destino foráneo o un alias, debe especificar el nombre del bus foráneo que aloja el destino foráneo o el alias.
- -uniqueName nombreExclusivo
- Este parámetro sólo es válido cuando se utiliza con los servidores de aplicaciones WebSphere Application Server Versión 7.0 o posterior. No lo utilice con versiones anteriores. Especifique el nombre que defina exclusivamente al usuario en el registro de usuarios. Si se está utilizando un registro de usuarios de LDAP, el nombre exclusivo será el nombre distinguido (DN) para el usuario. Puede especificar valores tanto para -uniqueName como para -user, pero debe asegurarse de que identifiquen el mismo usuario. El mandato no comprueba si los valores coinciden.
Ejemplos
El ejemplo siguiente añade un usuario llamado User1 al rol de emisor en un destino de tipo de cola llamado Queue1 de un bus local llamado Bus1.
Admintask.addUserToDestinationRole ('[-type queue -bus Bus1
-destination Queue1 -role Sender -user User1]')
El ejemplo siguiente añade un usuario llamado User2 al rol de receptor en un destino de tipo de cola llamado Queue2 de un bus local llamado Bus1.
Admintask.addUserToDestinationRole ('[-type queue -bus Bus1
-destination Queue2 -role Receiver -user User2]')