Administración de Plataforma Live@Edu (Parte 2)

Contenido:

• Introducción.
• Conexión al Servidor de Exchange.
• Cmdlets en Power Shell.
• Creación de Cuentas de Distribución.
• Llenado de Grupos de Distribución.
• Renombrado de Grupos de Distribución.
• Eliminación de Grupos de Distribución.
• Ejemplo General.

 

Introducción:

Este tema en particular, yo lo explico orientado al manejo de la herramienta "Power Shell", con esta herramienta se puede manejar la plataforma Live@Edu de forma masiva, alimentandose de CSV.

El objetivo de este post es orientar sobre el formato que deben llevar los CSV, y las funciones que se deben ejecutar en "Power Shell" para realizar las trasaccione mencionadas en el Contenido.

En este post no se enseñara Trasanc-SQL, se presupone que el lector ya conoce esto, de forma que comenzamos directamente indicado los parametros para el llenado del CSV, la extracción de datos de la base, sera relativa a la organización "X" en cuestión.

Conexión al Servidor Exchange.

Antes de avanzar con este tema, los invito a revisar previamente este post, en este se detallan los requisitos para poder realizar transacciones administrativas dentro de la plataforma.

Una vez que tenga todos los derechos y privilegios correspondientes podra realizar las respectivas transacciones.

Si usted cuenta con la Herramienta Power Shell correctamente instalada (viene incorporada con Windows 7), siga los siguientes pasos, caso contrario de click Aquí.

     Permitir la Conexión de Power Shell.

1. Haga clic en Inicio > Todos los programas > Accesorios > Windows PowerShell.
2. Seleccion Ejecutar como Administrador.
3. Ejecute el siguiente Comando:  "Get-ExecutionPolicy".
4. Si el valor devuelto no es RemoteSigned, debe cambiarlo a RemoteSigned ( con el comando Set-ExecutionPolicy RemoteSigne)

     Comprobar que WinRM permite la Conexión a Power Shell.

1. Abir la ventana de Simbolo de Sistema (Windows R).
2. Escriba y Ejecute el siguiente Comando "net start winrm". 

Nota:  Esta ultima secuencia no es obligatoria, suele estar activada por defecto.

Para más información sobre la instalación y configuración de la Herramienta Power Shell, de click Aquí. 

   Conexión al Servidor de Exchange vía Power Shell.

1. Una vez dentro de Power Shell, ejecute el siguiente comando:  "$LiveCred = Get-Credential ", estos nos abre una ventana, donde se nos pide usuario y contraseña, de tal forma que podemos hacer log in a nuestra cuenta live@edu, que debe tener los respectivos privilegios y derechos.
2. Luego del paso anterior ejecute el siguiente Comando:  "$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://ps.outlook.com/powershell/ -Credential $LiveCred -Authentication Basic -AllowRedirection".
3. Por ultimo este comando "Import-PSSession $Session".

 Y Listo, ya con esto estamos conectados a nuestro servidor de Exchange, desde la herramienta Power Shell y podemos comenzar a hacer transacciones.

Para más información de Click Aquí.

Cmdlets en Power Shell.

En Power Shell vienen funciones predefinidas, las cuales nosotros debemos conocer, no solamente su nombre, sino tambien sus respectivos parametros de trabajo, para ver una lista total de las funciones existente de click Aquí.

Hago referencia de algunos detables:







Para más información puede consultar tambien el siguiente Aquí (relativa a los parametros de uso de cada cmdlet).

Creación de Grupos de Distribución.

Vamos a comenzar a ejecutar cmdlets específicos de administración en este caso vamos nostotros a añadir un nuevo grupo de distribución, por lo que usaremos el cmdlet "New-DistributionGroup".

Este cmdlet tiene 1 parametros básicos:

• Identity

Este corresponde al nombre que se le va a dar al grupo de distribución, este nombre abra de tener espacios y llamarce sal y como se desea mostrar, tomar en cuenta no usar "Ñ", de forma automatica se genera el Alías del grupo (es el nombre del grupo sin espacios).

El comando a ejecutar en Power Shell es el siguiente (no olvidar que antes de ejecutar estas funciones debe haberce conectado previamente).

$Memsfile = import-csv -Path D:\5TOA8VO.csv -OutVariable string | foreach {New-DistributionGroup  $_.GRUPO}

En el parametro Path siempre colocaremos la ruta de ubicación de nuestro CSV, así mismo declararemos el nombre del cmdlet a usar y un identificador para la columna del CSV que contiene cada respectivo parametro, en este caso solo hay un parametro, de nombre Identity, este parametro es común a todas los cmdlet, por lo cual este en particular se sobre entiendo, y en este caso le hemos colocado la etiqueta GRUPO.

Esto en el lado del CSV, implíca que la Columna donde estan los nombres de los grupos de distribución a crear, debe llevar en su primera Fila la palabra "GRUPO", caso contrario arrojara un error.

Llenado de Grupos de Distribución.

Para el llenado de los grupos de distrución usaremos el siguiente Cmdlet:  "Add-DistributionGroupMember".

Este tiene 2 parámetros principales:

• Identity (en este caso es el ALIAS del grupo).
• Member (corresponde al correo de la persona que se desea agregar).

El comando a ejecutar en Power Shell es el siguiente:

$Memsfile = import-csv -Path D:\5TOA8VO-NETWORKING.csv -OutVariable string | foreach {add-distributiongroupmember  $_.GRUPO -member $_.NAME}

Como pueden el parametro Path prevalece e indica la ruta donde esta el CSC, asi mismo se declara el nombre del cmdlet a usar "add-distributiongroupmember", el primer parametro Identity, se sobrentiede, por lo cual no hay que etiquetarlo, el segundo es el parametro member, el cual si requiere ser etiquetado (-member), cada uno de estos parametros lleva un distintivo que se declara con el signo "S_.", posteior a este distintivo esta el Rotulo que debera llevar la columna que tenga los respectivos datos en el CSV.

 

Renombrado de Grupos de Distribución.

Para renombrar  grupos de distribución se usara el siguiente Cmdlet:  "Set-DistributionGroup", con los siguiente parametros:

• Identity(en esta caso corresponde al Alias del grupo).
• DisplayName(corresponde al nombre para mostrar).

El comando a ejecutar en Power Shell es el siguiente:

$Memsfile = import-csv -Path D:\RENOMBRAR.csv -OutVariable string | foreach {Set-DistributionGroup  $_.NOMBRE -DisplayName $_.NUEVONOMBRE}

En este comando como en todos los anteriores hay que espeficar un Path, que es la ruta donde se encuentra  nuestro CSV a cargar, el cmdlet "Set-DistributionGroup", con sus 2 parametros Identity y Display, deben ser llenados, como se dijo en los casos anteriores el identity no requiere etiqueta, ya  que el programa lo interpreta por defecto, el segundo en cambio requiere su respectiva eticua "-DisplayName", por ultimo es necesario para cada parametro poner un identificador, que sera el equivalente a la cabecera de las columnas en nuestro CSV "$_.NOMBRE" y "$_.NUEVONOMBRE".

 

Eliminación de Grupos de Distribución.

Para la elimincación de grupos de distribución previamente creados, se usasra el siguiente cmdlet: "Remove-DistributionGroup", con los siguientes parametros:

• Identity (en este caso el Alias del Grupo de Distribución).

El comando a ejecutar en Power Shell es el siguiente:

$Memsfile = import-csv -Path D:\ELIMINAR.csv -OutVariable string | foreach {Remove-DistributionGroup  $_.GRUPO}

Este cmdlet como todos los demás usa el parametro "-Path" para ingresar la ruta donde se encuentra el CSV, este cmdlet necesita unicamente para funcionar el parametro "Identity", este no requiere etiqueta como en casos anteriores, ya que es reconocido por defecto, adiconal a esto se debe poner un identificador "$_.GRUPO", que debe corresponder a la cabecera de la Columna del CSV, donde se colocaran todos los alias de los grupos a eliminar.

Ejemplo General.

Para este fin he preparado un script de Power Shell(abrir power shell como administrador), en el orden que debería ejecutarse, como buena practica recomiendo ejecutar linea por linea, deben seleccionar la respectiva linea y dar click en ejecutar seleccion (Alado de la fecha verde).




Las lineas ya estan en el orden de ejecución Respectivo.

Lo primero sería hacer Log in en el Servidor Exchange de nuestra cuenta live@edu, ejecutamos entonces la primera linea, nos aparece un cuadro de dialogo solicitando  nuestro consentimiento, al cual contestaremos afirmativamente.



Continuamos entonces ejecutando la segunda linea, nos aparecera entonces un cuadro de dialogo en el cual ingresaremos nuestras credenciales live@edu.



Ejecutamos entonces la tercera linea (4),  y seguida de esta la 4ta (6), esta ultima puede tardar un poco.

Si todo sale sin errores podemos continuar ejecutando los cmdlets explicados anteriormente, caso contrario regresar a la parte de conexión e instalción y seguir los pasos que ahi se citan.