Abierto de navegación

The Power Shell Command action runs a Windows PowerShell command.

You can configure the following properties for the Power Shell Command action:

Acción

• Nombre: Especifica el nombre de la acción. Si lo desea, puede sustituir el nombre predeterminado escribiendo un nuevo nombre en este campo.

• Descripción: Permite guardar una descripción para la acción.

• Ejecutar acción: Permite especificar la frecuencia con la que quiera ejecutar la acción.

  • Siempre: Especifica que Integration Service ejecutará la acción cada vez que ejecute la integración.

  • Nunca: Especifica que Integration Service no ejecutará la acción cuando ejecute la integración.

  • Condicionalmente, en base a una variable: especifica que Integration Service ejecutará la acción solo cuando una variable seleccionada cumple una condición específica. Utilice esta opción en situaciones en las que solo haya una condición que determine si la acción se ejecutará o no. Una vez que haya activado esta opción, puede crear la instrucción condicional en el cuadro de entrada.

    Controles del cuadro de entrada

    • Variable: Introduzca la variable que quiera utilizar como instrucción condicional. Alternativamente, puede añadir una variable para el valor de la instrucción condicional.

    • [Operador relacional]: Especifica el operador relacional que se utilizará para la instrucción condicional. Haga clic en el operador existente para abrir una lista de operadores adicionales y seleccione el que quiera utilizar. Para obtener más información, consulte Operadores ralacionales. Los operadores disponibles en la lista dependen de si ha seleccionado Texto o Decimal para la opción Tipo.

    • Valor: Especifica el/los valor(es) que se utilizará(n) para la instrucción condicional. Algunos operadores, como Is null y Is not null, no requieren que se especifique ningún valor. En estas situaciones, el campo Valor no estará disponible.

    • Tipo: Especifica si la declaración condicional evalúa un valor de texto o decimal.

       

  • Con condiciones, en base a la expresión: Especifica las condiciones bajo las que Integration Service ejecutará la acción. Utilice esta opción para situaciones que requieran más de una instrucción condicional. Una vez que haya activado esta opción, puede crear la expresión condicional en el cuadro de entrada creando las instrucciones condicionales deseadas. Cree y edite su expresión condicional en la ficha Vista del árbol. Haga clic en la ficha Vista del texto para ver una vista del texto de solo lectura de la expresión condicional.

    Controles del cuadro de entrada (Ficha Vista del árbol)

    • [Unión condicional]: Especifica la unión condicional para las instrucciones condicionales del grupo. The default conditional joiner is And.

      Haga clic en la unión condicional existente para acceder al menú que le permitirá configurar su expresión condicional de una de las siguientes maneras:

      • Seleccione una unión condicional diferente: Las opciones del menú incluyen una lista de uniones condicionales. Seleccione la unión condicional que quiera utilizar como instrucción condicional. Para obtener más información sobre las uniones condicionales compatibles, consulte Uniones condicionales.

      • Añadir condición: Haga clic para añadir otra instrucción condicional para el grupo actual.

      • Añadir grupo: Haga clic para añadir un subgrupo de instrucciones condicionales para el grupo actual.

      • Eliminar grupo: Disponible en el menú cuando el menú se haya abierto desde un subgrupo. Haga clic para eliminar el subgrupo.

      • Eliminarlo todo: Disponible en el menú cuando el menú se haya abierto desde el grupo de mayor nivel. Haga clic para eliminar todas las instrucciones condicionales (incluyendo subgrupos).

    • : Visible justo a la derecha de cada unión condicional de su expresión. Haga clic para añadir una declaración condicional para el grupo asociado con dicha unión.

    • : Visible cuando posiciona el cursor sobre una instrucción condicional existente. Haga clic para eliminar la declaración condicional.

    • Variable: Introduzca la variable que quiera utilizar como instrucción condicional. Alternativamente, puede añadir una variable para la instrucción condicional.

    • [Operador relacional]: Especifica el operador relacional que se utilizará para la instrucción condicional. Haga clic en el operador existente para abrir una lista de operadores adicionales y seleccione el que quiera utilizar. Para obtener más información, consulte Operadores ralacionales. Los operadores disponibles en la lista dependen de si ha seleccionado Texto o Decimal para la opción Tipo.

    • Valor: Especifica el/los valor(es) que se utilizará(n) para la instrucción condicional. Algunos operadores, como Is null y Is not null, no requieren que se especifique ningún valor. En estas situaciones, se ocultará el campo Valor.

    • Tipo: Especifica si la declaración condicional evalúa un valor de texto o decimal.

Comando

• Origen: Especifica el origen para el comando que se enviará.

  • Comando(s) integrado(s):

  • Valor: Utilice el cuadro de entrada para escribir los datos que quiera que utilice la acción. Alternativamente, puede añadir una variable para especificar los datos, o añadir un carácter especial al valor que haya introducido.

  • Importar: Abre el cuadro de diálogo Abrir archivo para que pueda navegar y seleccionar el archivo que contiene los datos deseados. El contenido del archivo se importa al cuadro de entrada Valor.

  • Exportar: Abre el cuadro de diálogo Guardar archivo para que pueda guardar el contenido del cuadro de entrada Valor como un archivo externo. Puede guardar el valor como un nuevo archivo, o sustituir el contenido de un archivo existente.

  • Variable:

    • Variable: Escriba la variable que quiera utilizar como origen. Alternativamente, puede añadir una variable.

  • Archivo externo:

    • Ubicación: Especifica el sistema de archivos donde se encuentra la carpeta de origen. Los sistemas o ubicaciones de archivos pueden incluir sistemas de archivos o recursos de red, Librarian, o una ubicación de almacenamiento en la nube compatible. For more information about supported cloud storage locations, see Administration Console's Cloud Storage Page.

    • Nombre de archivo: Especifica la ruta del archivo. Puede escribir la ubicación de la carpeta y el nombre del archivo, o hacer clic en Explorar para localizar y seleccionar el archivo deseado. Alternativamente, puede añadir una variable para especificar el archivo deseado, o añadir un carácter especial al valor que haya introducido.

    • Codificación de archivos: Especifica la codificación utilizada por un archivo de origen.

• Esperar a que finalice el comando: Specifies that the command is not executed until after a response is received. De lo contrario, el comando se ejecuta sin esperar a una respuesta.

  • Tiempo de espera de ejecución (segundos): Specifies the amount of time the action allows for command execution before the action times out and exits.

Salida

• Enviar resultado de comando a registro de mensajes: Logs the shell command output to the message log.

For each of the following options, you can enter the variable that you want. Alternativamente, puede añadir una variable.

• Guardar resultado del comando y errores en variable: Especifica la variable en la que se guardarán las salidas de comando y los errores.

• Guardar errores de comando a variable: Especifica la variable en la que se guardarán los errores del comando.

• Guardar excepciones de comandos a variable: Especifica la variable en la que se guardarán las excepciones del comando.

Probar Comando Power Shell

• Prueba: Ejecuta la acción. El panel Mensaje indica si la acción se ha realizado con éxito o si ha fallado.

  Al hacer clic en el botón Prueba se ejecuta la acción, pero no la integración. Por lo tanto, la acción se ejecutará sin ningún dato de la integración que haya podido configurar para utilizarla conjuntamente con la acción. Para más información sobre cómo probar su integración, consulte Utilizar el panel Prueba.

Cuenta de usuario

• Heredar de la acción principal: Al activarla, la acción hereda las credenciales de la cuenta de usuario especificada en la página de propiedades Acciones. Alternativamente, si la acción es parte de una acción Agrupar, heredará las credenciales de la cuenta de usuario especificadas en la página de propiedades de la acción Agrupar inmediatamente superior.

• Especificar credenciales de usuario: Al activarla, la acción se ejecuta utilizando las credenciales especificadas.

Gestión de errores y diagnósticos

• Ignorar errores y continuar ejecutando acciones: Al activarla, especifica que en caso de que la acción falle, las demás acciones seguirán ejecutándose.

  Cuando esta propiedad no esté activada y la acción falle, el comportamiento resultante depende de los siguientes factores: Si ha especificado Secuencialmente para la propiedad Ejecutar acciones de la página Acciones o Agrupar jerárquica de la acción seleccionada, no se ejecutarán más acciones dentro del grupo. Si ha indicado En paralelo en la propiedad Ejecutar acciones de la página Acciones o Agrupar jerárquica de la acción seleccionada, las acciones del mismo grupo no se verán afectadas; los errores se ignoran y el resto de acciones del grupo se ejecutan con normalidad. Si la acción seleccionada está dentro de una acción Agrupar, no afectará a ninguna otra acción externa a dicha acción Agrupar.

• Reintentar si falla: Al activarla, especifica que en caso de que la acción falle, Integration Service intentará ejecutarlo de nuevo.

• Máximo reintentos: Especifica la cantidad máxima de veces que Integration Service volverá a intentar ejecutar la acción. Disponible al activar Reintentar si falla.

• Reintentar intervalo: Especifica el tiempo que Integration Service esperará después de que la acción haya fallado y antes de volver a ejecutarla. Disponible al activar Reintentar si falla.