Exchange PowerShell – Manejo de objetos y “Pipelining”

Article
11/03/2006

Por Daniel Seveso

Luego del artículo de Introducción publicado anteriormente, veamos lo que para mi es la principal diferencias entre PowerShell y los shells disponibles hasta ahora.

Objetos en PowerShell

Los shells en general, poseen la funcionalidad de redirigir la salida de un comando a otro utilizando cadena de caracteres (proceso conocido como pipelining). Por ejemplo, el siguiente es el resultado de hacer pipelining de la salida del comando ipconfig en el shell de Windows, enviándola como entrada del comando “find”:

C:\>ipconfig /all | find "IP Address"

IP Address. . . . . . . . . . . . : 192.168.0.7

La desventaja principal de este método es que debemos conocer exactamente cual será la salida del primer comando para no tener resultados inesperados.

En Exchange Management Shell (EMS) el pasaje de resultados de un comando a otro se realiza en el contexto de objetos. EMS usa información estructurada para representar los distintos ítems en la jerarquía de Exchange y a los que llamamos objetos. Cada objeto en EMS contiene información relacionada al ítem que representa y su estructura de datos. El objeto funciona como un una entidad que representa el ítem, por ejemplo, si modificamos un buzón desde EMS, estaremos trabajando con el objeto que representa ese buzón, no con el buzón en sí.

Al utilizar objetos para el pasaje de información entre comandos, evitamos los problemas de interpretación de la información, ya que todos los cmdlets conocerán el modelo de objetos a utilizar.

Un objeto está compuesto por tres tipos de información: el tipo de objeto, sus métodos y sus propiedades.

Tipo: El tipo de objeto identifica que clase de objeto es. Por ejemplo, en EMS, un objeto que representa un buzón es un objeto Mailbox, un objeto que representa un archivo es un objeto FileInfo.

Propiedades: Una propiedad es información asociada al objeto que especifica algo en particular del mismo. Por ejemplo, en un objeto Mailbox, tiene una propiedad Name que representa el atributo DisplayName en el directorio activo para usuario con buzón. También tiene una propiedad ServerLegacyDN que representa el valor del atributo msExchangeHomeServerName del usuario con buzón en el directorio activo. Este usuario con buzón, es el ítem representado por el objeto Mailbox en ESM.

Como se habrán dado cuenta, las propiedades de los objetos de EMS no tienen el mismo nombre que las propiedades de los objetos en el directorio activo, aunque representen el mismo valor.

El nombre y el tipo de datos de cada propiedad (entero, binario, cadena, etc.) es también información que está incluida en el objeto.

Para ver las propiedades del objeto Mailbox, pueden ejecutar el comando:

[MSH] C:\>get-mailbox <nombre> | List

Métodos: Un método es un conjunto de instrucciones que definen una acción en particular para un objeto. Por ejemplo, un objeto Mailbox incluye un método set_emailAddresses que se usa para configurar la dirección de correo (atributo proxyAddresses del directorio activo) para ese usuario con buzón. El nombre del método no es relevante para configurar la dirección de correo, dado que el cmdlet set-mailbox expone un parámetro –emailaddresses que utiliza este método en forma transparente.

[MSH] C:\>set-mailbox <nombre> -emailaddresses smtp:nombre@dominio.com

Si quieres ver todos los métodos asociados a un objeto mailbox, puedes usar el cmdlet get-member. Get-member trabaja con un objeto en particular, así que podríamos obtenerlos mediante el siguiente comando:

[MSH] C:\>get-mailbox <nombre> |get-member –membertype method

Pipelining – Pasando información entre comandos

Pipelining es el término en inglés utilizado para la redirección de la salida de un proceso hacia la entrada de otro. El símbolo “ | ” es usado para indicar esta redirección en EMS. Cuando encontremos este símbolo en una línea de comandos, significa que el resultado del comando que está a la izquierda del signo se usará como entrada para el comando que está a la derecha del signo. Este resultado tendrá la forma de uno o más objetos.

Ejemplo

Si quieres mostrar las propiedades del usuario Susana Oliveira, el comando sería:

[MSH] C:\>get-mailbox "Susana Oliveira"

Name Alias Server ProhibitSendQuo

---- ----- ------ ---------------

Susana Oliveira susoli fc-mbc 400MB

Solamente algunos atributos del objeto mailbox son mostrados en la consola pero en realidad la salida del comando es el objeto completo que representa el mailbox “Susana Oliveira”

Luego, por ejemplo, puedes usar el cmdlet format-list, que toma la salida del pipeline y despliega en pantalla una lista de propiedades de cada objeto. Si enviamos la salida del get-mailbox anterior al cmdlet format-list pidiendo las propiedades name y legacyexchangedn, obtendremos este resultado:

[MSH] C:\>get-mailbox "Susana Oliveira" |format-list -Property name,legacyexchangedn

Name : Susana Oliveira