addGroupToDestinationRole command
Use the addGroupToDestinationRole command to add a group to the destination roles for a local or foreign bus.
Para executar o comando, utilize o objeto AdminTask do cliente de script wsadmin.
O cliente de script wsadmin é executado do Qshell.
Para obter informações adicionais, consulte Configurando o Qshell para Executar Scripts do WebSphere Usando o Script wsadmin.
- Para obter uma lista dos comandos de segurança do barramento de integração de
serviços disponíveis no Jython e uma breve descrição de cada comando, digite o seguinte
comando no prompt wsadmin:
print AdminTask.help('SIBAdminBusSecurityCommands')
- Para obter ajuda de visão geral sobre um determinado comando, digite o seguinte comando no prompt wsadmin:
print AdminTask.help('command_name')
AdminConfig.save()
Purpose
Use the addGroupToDestinationRole command to grant a group access to local bus destinations for the specified roles. The roles you can specify depend on the type of destination.
Target object
None.
Required parameters
- -type destinationType
- You can specify one of the following destination types:
- Queue
- Port
- TopicSpace
- ForeignDestination
- Alias
The allowed roles for a destination depend on the type of the destination as defined in Administrando Funções de Destino.
If you are specifying a destinationType that is either foreignDestination or alias, the foreign bus name that you specify must be the name of the foreign bus hosting the destination.
If you specify a destinationType of queue or topic, the foreign bus name is ignored. The authorization is granted against the destination in the local bus.
- -bus busName
- The name of the local bus. You can use the listSIBuses command to list the names of existing buses.
- -role roleType
- You can specify one of the following role types, depending on the -type you
have specified.
- Sender
- This role type applies to alias, foreignDestination, port, queue, and topicSpace destination types.
- Receiver
- This role type applies to alias, port, queue, and topicSpace destination types.
- Browser
- This role type applies to alias, port, and queue destination types.
- -group groupName
- The name of the group that you want to add to the destination role type
for the local bus. You can specify a group name, or one of the following specialized
group names:
- Server
- This group contains application servers.
- AllAuthenticated
- This group contains authenticated users only.
- Everyone
- This group contains all users. Each user is anonymous.
Conditional parameters
None.
Optional parameters
- -foreignBus foreignBusName
- Specify the name of the foreign bus. If you are adding a group to a destination on a foreign destination or an alias, you must specify the name of the foreign bus that hosts the foreign destination or the alias.
- -uniqueName uniqueName
- This parameter is valid only when used with WebSphere® Application Server Versão 7.0 ou posterior application servers. Do not use it with earlier versions. Especifique o nome que define exclusivamente o grupo no registro do usuário. Se um registro do usuário LDAP estiver em uso, o nome exclusivo será o DN (nome distinto) para o grupo. É possível especificar valores para -uniqueName e -group, mas você deve assegurar-se de que eles identifiquem o mesmo grupo. O comando não verifica se os valores correspondem.
Examples
The following example adds a group with the group name Group1, and the unique name SalesGroup to the sender role on a queue type destination called Queue1, on a local bus called Bus1.
AdminTask.addGroupToDestinationRole ('[-type queue -bus Bus1
-destination Queue1 -role Sender -group Group1 -uniqueName SalesGroup]')
The following example adds a group called Group2 to the receiver role on a queue type destination called Queue2, on a local bus called Bus1.
AdminTask.addGroupToDestinationRole ('[-type queue -bus Bus1
-destination Queue2 -role Receiver -group Group2]')