Compartir a través de

Asistente para actividades de línea de comandos

  • Artículo

El Asistente para actividades de línea de comandos permite crear rápidamente nuevas actividades en Orchestrator mediante la encapsulación de comandos, argumentos y parámetros en un ensamblado de Microsoft .NET (.DLL). El asistente crea automáticamente código fuente de C# mediante el SDK de Orchestrator y lo compila automáticamente. Con este ensamblado, puedes usar el paquete de integración de .NET (parte del kit de herramientas de integración) para probar las actividades y después usar el Asistente para paquetes de integración para empaquetar el ensamblado en un paquete de integración personalizado que se puede distribuir e implementar igual que otros paquetes de integración.

Un ensamblado puede contener una o varias actividades (comandos) y las actividades pueden ser de uno o de varios tipos de comandos disponibles (comando, línea de comandos, PowerShell o comando SSH). Define el nombre de la actividad, la estructura de comandos, los parámetros de entrada e incluso los datos publicados (salida).

Información general sobre las actividades en Orchestrator

Una actividad es una única parte funcional de un runbook de Orchestrator. Las actividades son las que hacen el trabajo real dentro de los runbooks y se unen mediante vínculos que se pueden definir con condiciones para crear ramas de flujo de trabajo. Al crear un runbook mediante Runbook Designer, arrastras y colocas actividades desde el panel Actividades al runbook y los vinculas juntos para formar el flujo de trabajo. A medida que se ejecuta el runbook, invoca cada actividad en secuencia según la forma en que estaban vinculadas. Cada actividad realiza un deber específico y puede recopilar datos de entrada del bus de datos de Orchestrator y publicar su salida en el mismo bus de datos. Cada actividad tiene la capacidad de extraer datos publicados de cualquiera de las actividades que se ejecutaron antes de ella en el runbook, y la publicación de los datos de salida permite que las actividades siguientes accedan a ellos.

Las actividades varían de simples a complejas. Puedes crear una actividad mediante el asistente para actividades de línea de comandos que no hace nada más que reproducir texto en una propiedad de salida. También puedes crear una sola actividad que realice una acción compleja y de varios pasos, como la implementación de máquinas virtuales. Es necesario definir lo que hará cada actividad. Sin embargo, tu objetivo debe ser definir actividades que encapsulan conjuntos únicos de funcionalidades que permiten una reutilización sencilla en muchos tipos diferentes de situaciones. La clave es la flexibilidad. Es mejor crear un conjunto de 10 actividades diferentes y que cada una haga algo específico, y poder usar esas actividades de 20 maneras diferentes, en lugar de crear 20 actividades diferentes para resolver escenarios individuales específicos. Más adelante en este documento se proporciona más información sobre los procedimientos recomendados.

Creación de un nuevo ensamblado de actividad

Sigue estos pasos para crear un nuevo ensamblado de actividad de línea de comandos:

  1. Selecciona Iniciar > Todos los programas > Microsoft System Center 2012 > Orchestrator > Integration Toolkit > Orchestrator Command-Line Activity Wizard

  2. Selecciona Siguiente.

  3. En la página Assembly Details, escribe un valor para Name que comienza con una letra y va seguido de cero o más caracteres alfanuméricos. Este nombre se usa como identificador de espacio de nombres de C# para el ensamblaje y las actividades.

  4. En Assembly file, escribe una ruta de acceso y un nombre de archivo del archivo de ensamblado que creará este asistente. Si este archivo ya existe, se te pedirá que sobrescribas el archivo.

  5. Selecciona Información de ensamblado. Puedes escribir la información aquí que se convertirá en las propiedades del archivo de ensamblado, visibles en el Explorador de Windows a través de propiedades de archivo. Los valores de propiedad se definen en la tabla siguiente. Esta información es opcional y no es necesaria para compilar un ensamblado.

    Propiedad Descripción
    Título Especifica un título para el ensamblado, que aparece como la propiedad de Descripción de archivo en las propiedades del Explorador de Windows.
    Descripción Especifica una descripción opcional para el ensamblado, que no aparece en las propiedades del Explorador de Windows.
    Producto Especifica un nombre de producto para el ensamblado, que aparece como la propiedad de nombre de producto en las propiedades del Explorador de Windows.
    Empresa Especifica un nombre de empresa para el ensamblado, que no aparece en las propiedades del Explorador de Windows.
    Copyright Especifica un aviso de copyright para el ensamblado, que aparece como Copyright en las propiedades del Explorador de Windows.
    Marca comercial Especifica una marca comercial para el ensamblado, que aparece como Legal trademarks en las propiedades del Explorador de Windows.
    Versión Especifica la versión del ensamblado y del archivo. Estos aparecen en las propiedades del Explorador de Windows como Versión de archivo y Versión de producto,

    El número de versión tiene cuatro partes de la siguiente manera:

    <versión principal>.<versión secundaria>.<número de compilación>.<revisión>

  6. Selecciona Aceptar cuando hayas terminado de escribir información de ensamblado.

  7. Selecciona Siguiente. Se muestra la página de Comandos.

  8. Agrega uno o varios comandos siguiendo las instrucciones proporcionadas en Add Commands to an Assembly.

  9. Cuando hayas completado la definición de la actividad, selecciona Aceptar. El cuadro de diálogo se cierra y la nueva actividad se agrega a la lista de la página de Comandos. Si necesitas volver atrás y editar un comando, selecciona el comando de la lista y selecciona Editar. Si necesitas eliminar un comando, selecciona el comando de la lista y después Quitar.

  10. Cuando hayas terminado de agregar y modificar comandos, selecciona Siguiente. Se compila el archivo del ensamblaje especificado al inicio del asistente y, una vez completado el proceso, se muestra la página final del asistente.

  11. Si quieres compilar inmediatamente un paquete de integración a partir de este nuevo ensamblado, selecciona el botón Build Integration Pack, que inicia el asistente para el paquete de integración y carga previamente la información del ensamblado. Después sigue las instrucciones de Creating a New Integration Pack para crear el paquete de integración.

  12. Si quieres probar el ensamblado mediante la actividad Invocar .NET o simplemente omitir el proceso de compilación de IP por ahora, selecciona Finish.

Adición de comandos a un ensamblado

Sigue estos pasos para agregar un comando a un ensamblado:

  1. En la página de Comandos, puedes definir uno o varios comandos (que se convierten en actividades) que se agregarán al ensamblado. Selecciona Agregar para agregar un nuevo comando.

  2. Aparece el cuadro de diálogo Add/Edit Command y contiene tres pestañas: General, Arguments y Published Data. Escribe un Nombre para el comando. Este nombre se muestra en el Runbook Designer para la actividad. También puedes escribir una descripción para el comando.

  3. El selector de propiedades de modo contiene cuatro opciones: Run Command, Run Windows PowerShell, Run Program y Run SSH Command. Si seleccionaste el modo Run Program, se activará el campo Program. Selecciona el botón de puntos suspensivos (...) y busca el programa que deseas ejecutar.

    Nota:

    El programa seleccionado en un comando de ejecución de programa será invocado en el Servidor de Runbook donde se está ejecutando el runbook que contiene esta actividad. Por lo tanto, este programa debe existir en todos los servidores Runbook donde esperarías ejecutar el libro de ejecución.

  4. Selecciona la pestaña Arguments.

  5. En el campo Línea de comandos, escribe los parámetros de la línea de comandos o comandos necesarios para la actividad. Si el comando va a tomar los parámetros que deseas que los usuarios especifiquen, deberás agregarlos en la lista Parámetros siguiente y después usar el botón Insertar para agregarlos a la línea de comandos.

    Importante

    Si especificaste Run Windows PowerShell para el modo y haces referencia a un script de PowerShell incluido con el paquete de integración, debes anteceder el nombre del script con caracteres de punto y barra diagonal para hacer referencia al directorio local. Por ejemplo, se especificaría .\MyScript.ps1 para un script denominado MyScript.ps1. Esto se debe a que el archivo de script se copiará en el directorio predeterminado del paquete de integración. Cuando Windows PowerShell ejecuta un script desde el directorio local, debe especificar esta notación.

  6. Para proporcionar parámetros para una línea de comandos, selecciona Agregar. Aparece el cuadro de diálogo Add/Edit Parameter.

  7. En el campo Nombre, escribe un nombre para el parámetro que vas a agregar. Este es el nombre visible del parámetro que se muestra en la lista de Propiedades de la actividad.

  8. En la lista desplegable Usage mode, selecciona el modo que usarás para el parámetro. El modo de uso tiene dos opciones:

    Modo de uso Descripción
    Argumentos de comandos Selecciona esta opción para usar este argumento como parámetro dentro de la línea de comandos (mediante el botón Insertar). Por ejemplo, un parámetro de argumento de comando denominado "Folder" podría colocarse en la línea de comandos de la siguiente manera:

    Dir $(folder) Nota: si los argumentos de la línea de comandos contienen espacios (como nombres de carpeta), es posible que tengas que incluirlos entre comillas para que el comando funcione correctamente. Por ejemplo: Dir "$(folder)"
    Variable de entorno Selecciona esta opción para usar este argumento como una variable de entorno que se establecerá antes de ejecutar la línea de comandos. Se puede usar como parámetro de línea de comandos o como una variable de entorno dentro de un script que se ejecuta.

    Por ejemplo, un parámetro de variable de entorno denominado "Folder" podría colocarse en la línea de comandos de la siguiente manera:

    Dir %Folder% Importante: el nombre de la variable de entorno ya existe en entornos de usuario o sistema. Se producirá un error en el comando con un mensaje de error similar al siguiente: El elemento ya ha sido añadido. Clave en el diccionario: 'folder' Clave que se está añadiendo: 'folder'. Puedes determinar qué variables de entorno existen en un equipo local o remoto al seleccionar Iniciar > Ejecutar y escribir MSINFO32.EXE. Luego, selecciona Entorno de Software > Variables de Entorno. Para seleccionar otro equipo, presiona <CTRL+R>, selecciona Remote Computer on the Network, escribe el nombre del equipo y selecciona OK.

  9. En la lista desplegable Estilo de presentación, selecciona el estilo que usarás para mostrar el parámetro. El estilo de presentación determina cómo interactuará el usuario con la entrada cuando se le presente. A continuación se describen las opciones.

    Estilo de presentación Descripción
    Texto Al usuario se le presentará un cuadro de texto de forma libre para escribir un valor.
    Texto cifrado Al usuario se le presentará un cuadro de texto enmascarado. Los datos de este campo se cifrarán en la base de datos y no se mostrarán en ningún registro
    Verdadero/Falso El usuario puede seleccionar True o False en un cuadro de diálogo emergente
    Texto con selección El usuario puede seleccionar entre el grupo de opciones que especifiques
    Fecha y hora El usuario puede seleccionar el valor mediante un control Selector de Fecha/Hora
    Archivo El usuario puede seleccionar el valor mediante un control de navegador de archivos
    Carpeta El usuario puede seleccionar el valor mediante un control Explorador de carpetas
    Computadora El usuario puede seleccionar el valor mediante un control de navegador en el equipo

  10. Si el parámetro requiere o deseas proporcionar un valor predeterminado, es preciso escribirlo en el campo Valor predeterminado.

  11. Si seleccionaste Texto con selección, el campo Opciones está habilitado. Para agregar valores de opción entre los que el usuario puede seleccionar, selecciona el botón de puntos suspensivos situado junto al campo Opciones y escríbelos. Cada opción aparece en una línea independiente. Cuando hayas terminado de agregar las opciones, selecciona Aceptar.

  12. Cuando hayas terminado con la definición de parámetros, selecciona Aceptar.

  13. Si se define como un parámetro de comando, el parámetro ahora se puede agregar a la línea de comandos colocando el cursor en el punto de inserción deseado en la línea de comandos al seleccionar el botón Insertar y seleccionar el nombre del parámetro. Si se define como una variable de entorno, debes escribir manualmente en la variable (con el formato %variable%) si lo deseas en la línea de comandos.

  14. Si elegiste los modos Run Program o Run Command Line, la casilla Include working directory parameter está habilitada.

  15. Selecciona la pestaña Published Data. La configuración de esta pestaña te permite publicar datos de salida en el bus de datos de Orchestrator para que otras actividades puedan usar la información.

  16. Para agregar una nueva propiedad de datos publicada, selecciona Agregar.

  17. Si seleccionaste la opción Run Command, Run Program o Run SSH Command en la lista desplegable Mode de la pestaña General del cuadro de diálogo Add/Edit Command, aparecen los siguientes elementos en el cuadro de diálogo Add/Edit Published Data:

    Productos Descripción
    Nombre El nombre visible del elemento de Datos publicados que estás creando
    Source Origen del elemento Datos publicados. Puedes elegir entre Standard Output Stream o Standard Error Stream desde la línea de comando
    Modo El modo que deseas usar para seleccionar los datos publicados.

    Usa Patrón de coincidencia para determinar si un patrón determinado se encuentra en el origen. Esto devolverá True o False.

    Usa Extraer grupo para recuperar cada elemento de datos que coincida con el patrón que especifiques.
    Patrón La expresión regular que se aplica a la configuración del modo
    Descripción Texto de descripción que se muestra junto a la propiedad "datos publicados" en el Diseñador de Runbooks. (opcional).

  18. Si seleccionaste la opción Run Windows PowerShell en la lista desplegable Mode de la pestaña General del cuadro de diálogo Add/Edit Command, aparecerán los siguientes elementos en el cuadro de diálogo Add/Edit Published Data:

    Productos Descripción
    Nombre El nombre visible del elemento de Datos publicados que estás creando
    Propiedad El nombre de la propiedad de Windows PowerShell que se guardará en el elemento Datos publicados. Esta propiedad debe estar contenida en una salida de objeto a la canalización de PowerShell durante el script y no debe ser un objeto (se debe poder convertir en una cadena).
    Descripción Texto de descripción que se muestra junto a la propiedad de datos publicados en el Diseñador de Runbooks. (opcional).

  19. Selecciona Aceptar para terminar de agregar el elemento de datos publicados. Repite los pasos del 16 al 18 para cada elemento de datos publicados que desees agregar.

  20. Selecciona Aceptar para cerrar el cuadro de diálogo Agregar o editar comando y volver al cuadro de diálogo Comandos.

Probar un conjunto de actividad

Después de crear un ensamblado, puedes probarlo usando la actividad Invocar .NET (contenida en el kit de herramientas de integración IP para .NET) para comprobar que funciona según lo previsto antes de convertirlo en un paquete de integración personalizado.

Probar un ensamblado

Sigue estos pasos para probar un ensamblado:

  1. Abre el Diseñador de Runbooks.

  2. Crea un nuevo cuaderno de ejecución.

  3. En el panel Activities, selecciona la categoría Integration Toolkit para expandirla y arrastra una actividad Invoke .NET al nuevo runbook.

  4. Haz doble clic en el objeto Invocar .NET para ver el cuadro de diálogo Propiedades.

  5. En el campo Assembly, busca el archivo de ensamblado que creaste usando el Asistente para actividades de línea de comando (o mediante desarrollo personalizado usando el SDK) al seleccionar el botón de puntos suspensivos (...) a la derecha del campo. Selecciona el archivo y selecciona Abrir.

  6. Selecciona el botón de puntos suspensivos situado a la derecha del campo Clase para ver una lista de los comandos individuales del ensamblado. Selecciona una clase de comando y selecciona Aceptar. Los parámetros de esta clase aparecen en la pestaña Propiedades del cuadro de diálogo.

  7. El campo Configuración lo utilizan únicamente las clases desarrolladas de forma personalizada que usan el SDK del orquestador con el atributo OrchestratorData. Para obtener más información sobre el SDK, consulta Kit de herramientas de integración del orquestador de System Center.

  8. Seleccione la pestaña Propiedades.

  9. Proporciona la información de cada una de las propiedades según sea necesario.

  10. Selecciona Finalizar para guardar la configuración y volver al runbook.

  11. Selecciona Evaluador de Runbooks en la barra de herramientas del Diseñador de Runbooks. Se inicia el comprobador de los runbooks.

  12. Selecciona Ejecutar hasta el punto de interrupción en la barra de herramientas. Se inicia el manual de operaciones y se ejecuta la actividad. Los resultados de la actividad se muestran en el panel Registro de ejecución.

  13. Selecciona Mostrar detalles en el nombre de la actividad en el panel Ejecutar registro para ver los resultados detallados, incluyendo las propiedades de entrada y los datos publicados.

Migración de actividad de la CLI de QIK

Si tienes un ensamblado que se ha creado mediante el asistente de la CLI de QIK de Opalis 6.3, deberás convertirlo en compatible con el orquestador para poder usarlo en un paquete de integración del orquestador o directamente en runbooks mediante la actividad Invocar .NET. El proceso de conversión es sencillo y solo tarda unos segundos por ensamblado.

Importante

La instalación del Kit de herramientas de integración de Orchestrator no producirá un error si Microsoft .NET Framework 3.5, Service Pack 1 no está instalado, pero fallarán diferentes operaciones en el Asistente de Actividad de Línea de Comandos si no está presente. Asegúrate de que Microsoft .NET Framework 3.5, Service Pack 1 está instalado antes de usar la CLI.

Convertir un ensamblado CLI de Opalis QIK

Sigue estos pasos para convertir un ensamblado CLI QIK de Opalis:

  1. Inicia el asistente de actividades de línea de comando del orquestador seleccionando Iniciar > Todos los programas > Microsoft System Center 2012 > Orquestador > Asistente para actividades de línea de comando.

  2. Cuando se cargue el asistente, selecciona el botón Cargar ensamblado existente de la primera página.

  3. Selecciona el archivo de ensamblado existente y selecciona Abrir. Se muestran el nombre del ensamblado y la ubicación del archivo.

  4. Modifica la ruta de acceso del archivo para que los cambios se guarden en un nuevo archivo. También puedes cambiar el nombre del ensamblaje si es necesario.

  5. Si necesitas realizar más cambios en los detalles de la información del ensamblado, selecciona el botón Información de ensamblado y realiza esos cambios. Selecciona Aceptar cuando hayas terminado para volver a la página Detalles del ensamblado.

  6. Selecciona Siguiente para ir a la página Comandos. Deberías ver una lista de comandos que se han definido anteriormente en el ensamblado. Revisa los comandos si es necesario y selecciona Siguiente para continuar hacia la página de Construcción de ensamblaje.

  7. El nuevo módulo se construirá y se guardará con la ruta de acceso y el nombre de archivo que has definido anteriormente.

  8. Ahora puedes usar el nuevo ensamblado compatible con el orquestador en runbooks con la actividad Invocar .NET, o bien puedes compilar un paquete de integración desde este ensamblado al seleccionar el botón Compilar paquete de integración. Si no deseas compilar una dirección IP en este momento, selecciona Cerrar para finalizar el asistente.

Recursos de Orquestador

Además de esta referencia en línea proporcionada para el orquestador de System Center 2012, hay una serie de recursos que pueden proporcionar información adicional sobre la creación de runbooks, el uso del kit de herramientas de integración y los procedimientos recomendados.