![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
Intelligent Management: tareas administrativas de preferencias de usuario de las operaciones de tiempo de ejecución
Puede utilizar los lenguajes de script Jacl y Jython para clonar, establecer y obtener preferencias con la herramienta wsadmin. Utilice los mandatos y parámetros del grupo UserPreferences.
- cells/myCell/preferences/User_1/preferenceset.xml
- cells/myCell/applications/TestAppA.ear/preferences/User_1/preferenceset.xml
- cells/myCell/nodes/myNode/servers/myServer/preferences/User_1/preferenceset.xml
- cells/myCell/clusters/myCluster/preferences/User_1/preferenceset.xml
- cells/myCell/serviceclasses/Platinum/preferences/User_1/preferenceset.xml
Para obtener ejemplos sobre cómo utilizar Jython para interactuar con objetos de preferencias, consulte Mandatos de objeto de preferencias Jython.
clonePreference
El mandato clonePreference copia una preferencia de un usuario o rol en otro usuario o rol.
Objeto de destino
configID del padre.
Parámetros necesarios
-name Especifica el nombre de la preferencia que se va a clonar. (String, necesario)
Parámetros opcionales
- -scope: especifica el ámbito de la preferencia para guardar cuando se clonan las preferencias.
Si no especifica un ámbito, se utiliza el ámbito del configID.
(Serie, opcional) El ámbito se puede adoptar uno de los valores siguientes:
- Applications
- Servers
- Clusters
- ServiceClasses
- -touser: especifica el usuario para el cual recuperar preferencias. Si no indica este valor, el valor por omisión utiliza el ID de usuario para la sesión en la que se ejecuta el mandato. (String, opcional)
- -torole: especifica el rol para el cual recuperar las preferencias. Este valor se ignora si ha especificado el parámetro -touser. (String, opcional)
- -fromuser: especifica el usuario que obtiene una copia de las preferencias. Puede indicar varios usuarios colocando los usuarios en una lista, por ejemplo: user1,user2,user3. No incluya espacios en la lista. (String, opcional)
- -fromrole: especifica el rol que obtiene una copia de las preferencias. (String, opcional)
Ejemplo de utilización de la modalidad por lotes
- Utilizando Jython:
cellid= AdminConfig.getid("/Cell:myCell") AdminTask.clonePreference(cellid, '[-name ChartGroups -fromuser user1 -touser user2,user3,user4,user5]') AdminConfig.save()
- Utilización de Jacl:
$AdminTask clonePreference cells/dabtcCell02|cell.xml#Cell_1 {-name ChartGroups -fromuser user1 -touser user2,user3,user4,user5}
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.clonePreference('[-interactive]')
- Utilización de Jacl:
$AdminTask clonePreference {-interactive}
getPreferences
El mandato getPreferences devuelve una colección de preferencias basándose en el documento de preferencias que ha especificado pasando un nombre de usuario o rol. Debe tener privilegios de administrador para obtener preferencias para un determinado usuario o rol de usuario.
Objeto de destino
configID del padre.
Parámetros necesarios
- -name: especifica el nombre de la preferencia. (Serie, necesario)
Parámetros opcionales
- -scope: especifica un ámbito para las preferencias.
Puede elegir uno de los siguientes valores
válidos:
- Applications
- Servers
- Clusters
- ServiceClasses
- -user: especifica el nombre de usuario para el cual recuperar preferencias. Si no indica un usuario, la acción por omisión es utilizar el nombre de usuario que ejecuta el script. (String, opcional)
- -role: especifica el rol de usuario para el cual recuperar preferencias. (String, opcional)
Valor de retorno
El mandato devuelve un objeto DescriptivePropertyGroup que contiene las preferencias, o null si no se encuentra ninguna preferencia.
Ejemplo de utilización de la modalidad por lotes
- Utilizando serie de Jython:
cellid= AdminConfig.getid("/Cell:myCell") AdminTask.getPreferences(cellid, '[-name ChartGroups -user user1]')
- Utilización de Jacl:
$AdminTask getPreferences cells/dabtcCell02|cell.xml#Cell_1 {-name Reports -user user1}
Ejemplo de utilización de la modalidad interactiva
- Utilizando serie de Jython:
AdminTask.getPreferences('[-interactive]')
- Utilización de Jacl:
$AdminTask getPreferences {-interactive}
setPreference
El mandato setPreference establece una preferencia específica en un documento de preferencias. Debe tener privilegios de administrador para establecer preferencias para un determinado usuario o rol de usuario.
Objeto de destino
configID del padre.
Parámetros necesarios
- -name: especifica el nombre de la preferencia. (Serie, necesario)
- -propertyLongName: especifica la vía de acceso completa a la propiedad en el grupo de propiedades, delimitado por un carácter de barra inclinada (/). Si la propiedad está contenida directamente en el grupo de propiedades raíz, puede utilizarse el nombre abreviado de la propiedad porque será exactamente igual al nombre largo. (String, necesario)
- -propertyValue: especifica el nuevo valor para definir para la preferencia. (String, necesario)
Parámetros opcionales
- -scope: especifica el ámbito de la preferencia para guardar cuando se clonan las preferencias. Si no especifica un ámbito, se utiliza el ámbito del configID.
(Serie, opcional) El ámbito se puede adoptar uno de los valores siguientes:
- Applications
- Servers
- Clusters
- ServiceClasses
- -user: especifica el nombre de usuario para el cual guardar preferencias. Si no indica un usuario, la acción por omisión es utilizar el nombre de usuario que ejecuta el script. (String, opcional)
- -role: especifica el rol de usuario para el cual guardar preferencias. (String, opcional)
Ejemplo de utilización de la modalidad por lotes
- Utilizando serie de Jython:
AdminTask.setPreference(cellid, '[-name myChartGroup -propertyLongName defaultChartSize -propertyValue large]')
- Utilizando Jacl:
$AdminTask setPreference cells/dabtcCell02|cell.xml#Cell_1 {-name Reports -user user1 -propertyLongName defaultChartSize -propertyValue large}
Ejemplo de utilización de la modalidad interactiva
- Utilizando serie de Jython:
AdminTask.setPreference('[-interactive]')
- Utilización de Jacl:
$AdminTask setPreference {-interactive}
Mandatos de objeto de preferencias Jython
Utilice los siguientes ejemplos para interactuar con el objeto de preferencias con mandatos Jython:
Para listar las preferencias por usuario.
prefSets = AdminConfig.list("PreferenceSet") print prefSets
Para eliminar las preferencias de un usuario.
prefid = AdminConfig.getid("/PreferenceSet:User_1") AdminConfig.remove(prefid) AdminConfig.save()
Para listar las preferencias de todos los usuarios, agrupadas por usuario.
prefs = AdminConfig.list("Preferences") print prefs