WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Comando mqsiwebuseradmin - Sistemas Windows, Linux e UNIX

Use o comando mqsiwebuseradmin para administrar contas do usuário para a interface com o usuário da web nos sistemas Linux, UNIX ou Windows.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsiwebuseradmin--| brokerSpec |--+- -l +-------------------->
                                     +- -c +   
                                     +- -m +   
                                     '- -d-'   

>--+---------------+--+---------------+--+-----------+---------->
   '- -u -username-'  '- -a -password-'  '- -r -role-'   

>--+-------------------+--+-----------------------+------------><
   '- -w --timeoutSecs-'  '- -v -- traceFileName -'   

brokerSpec

|--+- brokerName ----------------+------------------------------|
   +- -n --brokerFileName--------+   
   | .-------------------------. |   
   | V                         | |   
   '-----+- -i --ipAddress-+---+-'   
         +- -p --port------+         
         '- -q --qMgr------'         

Parâmetros

brokerSpec
(Necessário) Você deve especificar pelo menos um parâmetro para identificar o broker de destino para esse comando, de uma das seguintes formas:
brokerName
Este parâmetro identifica o nome de um broker definido localmente. Você não poderá usar esta opção se o broker estiver em um computador remoto.
-n brokerFileName
Este parâmetro identifica o nome de um arquivo que contém os detalhes da conexão para um broker local ou remoto.

Use esta opção se múltiplos usuários desejarem se conectar ao mesmo broker ou se você estiver usando parâmetros de conexão avançada, como SSL.

Para criar este arquivo, clique com o botão direito do mouse no broker no WebSphere Message Broker Explorer e selecione Exportar Arquivo *.broker. Quando solicitado, navegue para o local no qual você deseja salvar o arquivo e insira o nome do arquivo; a extensão .broker é anexada automaticamente ao clicar em Salvar. Inclua o local (caminho) e o nome do arquivo quando especificar este parâmetro. Você deverá assegurar que o local seja acessível quando executar este comando.

Para executar um comando que use SSL para administrar um broker remoto através de um canal seguro, você deve especificar a senha de keystore e de truststore da conexão usando a variável de ambiente IBM_JAVA_OPTIONS. Consulte Resolvendo Problemas ao Executar Comandos para obter informações adicionais.

-i ipAddress, -p port, -q qMgr
Estes parâmetros identificam os detalhes de conexão do broker.

Use esta opção para conexões com brokers remotos que não requerem parâmetros de conexão avançada.

Se você escolher esta opção, deverá especificar pelo menos um destes três parâmetros; a ordem na qual eles são especificados é insignificante. Não é possível especificar cada parâmetro mais de uma vez.

Os parâmetros que forem omitidos assumirão valores-padrão:

  • -i ipAddress: O nome do host ou o endereço IP do computador no qual o broker está em execução. Se você não especificar este parâmetro, um valor que representa o computador local será usado.
  • -p port: A porta TCP na qual o gerenciador de filas do broker está atendendo. Se você não especificar este parâmetro, o valor 1414 será usado.
  • -q qMgr: O nome do gerenciador de filas do broker. Se você não especificar este parâmetro, um valor que representa o gerenciador de filas padrão no computador local será usado.
-l
(Opcional) Lista os usuários da web que estão definidos no broker, e as funções com as quais eles estão associados. Se -u (usuário) ou -r (função) for fornecido, a lista será filtrada por esse usuário ou essa função.
-c
(Opcional) Cria uma conta do usuário da web, que pode efetuar logon na interface com o usuário da web e faz chamadas da API REST. Se você usar esse parâmetro, deverá especificar também os parâmetros -u e -a. Se você não especificar o parâmetro -r ao criar uma conta do usuário da web, uma função padrão será criada com o mesmo nome da conta do usuário da web. Nesse caso, a conta do usuário da web que você cria deverá ter o mesmo nome que a conta do usuário do sistema que foi especificada no sistema.
-m
(Opcional) Modifica uma conta do usuário da web. Se você usar esse parâmetro, deverá usar o parâmetro -u para especificar a conta do usuário e deverá especificar também um valor para pelo menos um dos parâmetros -a e -r, dependendo de qual parâmetro você está modificando.
-d
(Opcional) Exclui uma conta do usuário da web. Se você usar essa opção, deverá usar também o parâmetro -u para especificar a conta do usuário.
-u username
(Opcional) Especifica o nome de uma conta do usuário da web. Esse parâmetro será necessário se você especificar os parâmetros -c, -d ou -m.
-a password
(Opcional) Especifica uma senha da conta do usuário da web. Esse parâmetro será necessário se você especificar o parâmetro -c.
-r role
(Opcional) Especifica uma função a ser associada à conta do usuário da web. A função é a conta do usuário do sistema cujas permissões de segurança de administração são verificadas. Cada conta do usuário da web está associada a uma única função e várias contas do usuário da web podem ser designadas à mesma função.

Se você não especificar o parâmetro -r ao criar uma conta do usuário da web (especificando o parâmetro -c), uma função padrão será criada com o mesmo nome da conta do usuário da web. Nesse caso, a conta do usuário da web que você cria deverá ter o mesmo nome que a conta do usuário do sistema que foi especificada no sistema.

Para obter mais informações sobre funções, consulte Segurança Baseada em Função.

-v traceFileName
(Opcional) Esse parâmetro envia informações de rastreio interno de depuração para o arquivo especificado.
-w timeoutSecs
(Opcional) Este parâmetro especifica o tempo máximo, em segundos, que o comando aguarda o intermediário completar o pedido antes de retornar.

Você pode configurar este parâmetro com um valor no intervalo de 1 - 2 145 336 164. Se você não fornecer um valor timeoutValue ou se configurar um valor menor que 1 ou maior que 2 145 336 164, um erro será retornado.

Configure este parâmetro para um valor maior que a soma dos parâmetros de tempo limite de configuração ConfigurationChangeTimeout e InternalConfigurationTimeout que você especificou para o intermediário, se desejar assegurar que uma resposta seja recebida dentro do período de timeoutValue. Se você configurar um valor menor, a resposta retornada poderá indicar que o estado do pedido de implementação é desconhecido.

Exemplos

Crie uma conta do usuário da web e uma senha e especifique a função associada (conta do usuário do sistema):
mqsiwebuseradmin MB8BROKER -c -u webuser1 -r admin -a passw0rd

No exemplo precedente, o valor admin corresponde a uma conta do sistema.

Altere a senha para webuser1:
mqsiwebuseradmin MB8BROKER -m -u webuser1 -a n3wpass
Exclua a conta do usuário da web de webuser1:
mqsiwebuseradmin MB8BROKER -d -u webuser1
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:31:36


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | bn28491_