Comando Power Shell

Comando

• Origen: Especifica el origen para el comando que se envía.

  • Comando(s) integrado(s):

  • Valor: Utilice el cuadro de entrada para indicar 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 un archivo que contenga los datos que quiere. 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.

  • Editar valor integrado : Abre el Editor de archivos de comando PowerShell, donde puede escribir y editar el archivo de comando PowerShell para la acción.

  • Variable:

    • Variable: Escriba la variable que quiera utilizar como origen. Alternativamente, haga clic en para seleccionar una variable utilizada recientemente, o haga clic en Más variables para abrir el cuadro de diálogo Insertar 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. Para obtener más información sobre las ubicaciones de almacenamiento en la nube compatibles, consulte la Cloud Storage Page de Administration Console.

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

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

• Ejecutar como lote: Especifica que el archivo indicado se ejecuta como un archivo de lote. Disponible cuando el valor de Fuente se establezca en Archivo Externo y el valor de Ubicación se configure como Ordenador/Red.

  • Parámetros: Especifica los parámetros que se pasan al archivo de lote. Disponible cuando se seleccione Ejecutar como lote.

• Esperar a que finalice el comando: Especifica que el comando no se ejecuta hasta recibir una respuesta. Si no se selecciona esta opción, el comando se ejecuta sin esperar ninguna respuesta.

  • Tiempo de espera de ejecución (segundos): Especifica la cantidad de tiempo que la acción permite que se ejecute el comando antes de que la acción considere que se ha superado el tiempo de espera y se cierre.

Salida

• Enviar resultado de comando a registro de mensajes: Registra la salida del comando shell en el registro de mensajes.

Para cada una de las siguientes opciones, puede introducir la variable que quiera. Alternativamente, puede añadir una variable.

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

• Guardar errores de comando a variable: Especifica la variable en la que se guardan los errores de comando.

• Guardar excepciones de comandos a variable: Especifica la variable en la que se guardan las excepciones de comando.

Acción

• Nombre: Especifica el nombre de la acción. Puede sustituir el nombre predeterminado escribiendo un nuevo nombre en este campo.

• Descripción: Especifica una descripción para la acción.

• Ejecutar acción: Especifica la frecuencia con la que quiere que la acción se ejecute.

  • Siempre: Especifica que la acción se ejecuta la acción cada vez que ocurre el evento.

  • Nunca: Especifica que la acción no se ejecuta cuando ocurre el evento.

  • Condicionalmente, en base a una variable: Especifica que la acción se ejecuta 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. Después de seleccionar esta opción, puede crear la instrucción condicional en el cuadro de entrada.

    Controles del cuadro de entrada

    • Variable: Especifica la variable que quiera utilizar como instrucción condicional. Introduzca la variable en el cuadro de entrada. Haga clic en para ver una lista de variables utilizadas recientemente, o haga clic en Más variables para abrir el cuadro de diálogo Insertar variable.

    • [Operador relacional]: Especifica el operador relacional que se utilizará para la instrucción condicional. Haga clic en el operador existente para que se muestre 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 los valores que se utilizarán para la instrucción condicional. Para añadir un valor, haga clic en , haga clic en <introducir un valor>, introduzca el valor que desee y, a continuación, pulse Enter. Para eliminar un valor, utilice el botón secundario del ratón para hacer clic en él y, a continuación, haga clic en Eliminar. Algunos operadores, como Is blank y Is not blank, 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.

  • Condicionalmente, en base a una expresión: Especifica las condiciones en las que se ejecuta la acción. Utilice esta opción para situaciones que requieran más de una instrucción condicional. Cuando selecciona esta opción, puede crear la expresión condicional en el cuadro de entrada creando las instrucciones condicionales que desee. 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. La unión condicional predeterminada es Y.

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

      • And, Or, NotAnd, NotOr: Haga clic en la unión condicional de la lista 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: Haga clic para eliminar el subgrupo. Disponible cuando se abre el menú desde un subgrupo.

      • Eliminarlo todo: Haga clic para eliminar todas las declaraciones condicionales (incluyendo subgrupos). Disponible cuando se abre el menú desde el grupo más alto.

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

    • :  Elimina la declaración condicional. Visible a la derecha de una expresión condicional existente cuando se señala la expresión.

    • Variable: Especifica la variable que quiera utilizar como instrucción condicional. Introduzca la variable en el cuadro de entrada. Haga clic en para ver una lista de variables utilizadas recientemente, o haga clic en Más variables para abrir el cuadro de diálogo Insertar variable.

    • [Operador relacional]: Especifica el operador relacional que se utilizará para la instrucción condicional. Haga clic en el operador existente para que se muestre 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 los valores que se utilizarán para la instrucción condicional. Para añadir un valor, haga clic en , haga clic en <introducir un valor>, introduzca el valor que desee y, a continuación, pulse Enter. Para eliminar un valor, utilice el botón secundario del ratón para hacer clic en él y, a continuación, haga clic en Eliminar. Algunos operadores, como Is blank y Is not blank, 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.

Gestión de errores y diagnósticos

• Ignorar errores y continuar ejecutando acciones: Especifica que en caso de que la acción falle, las demás acciones siguen ejecutándose. Cuando no se selecciona esta opción y la acción falle, el comportamiento resultante depende de varios factores, como son:

  La acción está dentro de una Acción de grupo

  • Si ha especificado Secuencialmente para la propiedad Ejecutar acciones en la ficha Ejecución de la acción Agrupar, no se ejecutan más acciones dentro de esa Acción de grupo. No afecta a ninguna acción ajena a esta Acción de grupo.

  • Si ha especificado En paralelo para la propiedad Ejecutar acciones en la ficha Ejecución de la acción Agrupar, los errores se ignoran y se ejecutan las demás acciones de esa Acción de grupo. No afecta a ninguna acción ajena a esta Acción de grupo.

  La acción no está dentro de una Acción de grupo

  • Si ha especificado Secuencialmente para la propiedad Ejecutar acciones de la ficha Ejecución, no se ejecutan más acciones del evento.

  • Si ha especificado En paralelo para la propiedad Ejecutar acciones de la ficha Ejecución, los errores se ignoran y se ejecutan las demás acciones del evento.

• Reintentar si falla: Especifica que si la acción falla, BarTender intenta ejecutarla de nuevo.

  • Máximo de reintentos: Especifica la cantidad máxima de veces que BarTender volverá a intentar ejecutar la acción. Disponible cuando se haya seleccionado la opción Reintentar si falla.

  • Reintentar intervalo: Especifica el tiempo que BarTender esperará después de que la acción haya fallado y antes de volver a ejecutarla. Disponible cuando se haya seleccionado la opción Reintentar si falla.