Este documento describe cómo instalar y usar el Presentation Server SDK de Citrix para administrar tareas administrativas mediante scripts. Explica cómo descargar e instalar el SDK MFCOM, registrar servidores remotos, escribir código para acceder a objetos como servidores y aplicaciones publicadas, y ejecutar scripts para automatizar tareas como deshabilitar el inicio de sesión en todos los servidores de una granja. También cubre el uso de referencias externas para definir variables y ejecutar scripts MFCOM en ficheros WSF.
1. TIC 1130
Administración de tareas administrativas mediante scripting
Presentation Server SDK
Instalación y uso
Joaquín Herrero
INSTITUTO NACIONAL DE ADMINISTRACION PÚBLICA Pintado
Plan interadministrativo de formación contínua en el área de tecnologías jherrero@mma.es
de la información y las comunicaciones
3. Primeros pasos
CTX106305
How to Get Started and Run an MFCOM Script
- Descargar e instalar el SDK de MFCOM
- Registrar el servidor "objetivo" si no es el local
- Definir parámetros por defecto de CScript
- Escribir el código
- Ejecutar
Para poder descargarnos el Software Development Kit (SDK) de Presentation
Server hay que disponer de una cuenta MyCitrix
6. ¿Qué es MFCom?
mfcom.exe
Es el Application Programming Interface (API) de Citrix, que está construido con una
arquitectura de servidor de objetos COM.
MFCOM is a COM server that exposes some of the MetaFrame XP control and monitoring functions through the
objects and interfaces defined in this COM server.
It is a programming interface to the functions provided by the Management Console for MetaFrame.
MFCOM is a COM object that meets the requirements defined in the Microsoft Component Object Model Specification.
MFCOM is a COM server, not a COM client. MFCOM exposes objects that can be accessed from a COM client.
7. Nomenclatura de Objetos en Citrix
Objeto que describe la "granja" MetaFrameFarm
Objeto que describe a cada "servidor" MetaFrameServer
Colección de objetos "servidor" MetaFrameServers
Objeto que describe a cada "aplicación publicada" MetaFrameApplication
Colección de objetos "aplicación" MetaFrameApplications
Objeto que describe a cada "sesion" MetaFrameSession
Colección de objetos "sesión" MetaFrameSessions
8. Interfaces
Interfaces de entrada al Objeto "MetaFrameServer"
ImetaframeServer
ImetaframeWinServer
ImetaframeServer2
ImetaframeWinServer2
etc...
¿Qué encontramos dentro?
Servername
Applications (colección)
IpAddress
Sessions (colección)
EnableLogon
Ver Manual de MFCOM para descripción detallada del contenido de los objetos.
9. Referencia de Objetos MFCOM
AL instalar MFCOM se instala un fichero de ayuda que contiene la descripción
detallada de cada objeto de MFCOM
Además, hay scripts de ejemplo en C:Program FilesCitrixMPSSDKWsh
13. Script para deshabilitar logon en todos los servidores
Set TheFarm = CreateObject("MetaFrameCOM.MetaFrameFarm")
TheFarm.Initialize(MetaFrameWinFarmObject)
For Each Servidor in theFarm.Servers
set aWinServer = Servidor.WinServerObject
aWinServer.enablelogon = 0
Next
Este script funciona, pero le falta algo...
14. Referencias externas
En el script hemos usado nombres de variable que no han sido definidas.
TheFarm.Initialize(MetaFrameWinFarmObject)
Para que esas variables tengan su valor correcto hay que introducir el código
VBScript en un fichero WSF para su ejecución en el entorno Windows Script Host, y
entonces definir una "referencia a la granja":
<reference object="MetaFrameCOM.MetaFramefarm"/>
15. Scripts MFCOM en ficheros WSF
<package>
<job id="Servers">
<comment>
Este script permite Logon en todos los servidores de la Granja
</comment>
<reference object="MetaFrameCOM.MetaFramefarm"/>
<script language="VBScript">
Set TheFarm = CreateObject("MetaFrameCOM.MetaFrameFarm")
TheFarm.Initialize(MetaFrameWinFarmObject)
For Each Servidor in theFarm.Servers
set aWinServer = Servidor.WinServerObject
aWinServer.enablelogon = 0
Next
</script>
</job>
</package>