Cómo escribir y ejecutar scripts en Windows PowerShell ISEHow to Write and Run Scripts in the Windows PowerShell ISE

En este artículo se describe cómo crear, editar, ejecutar y guardar scripts en el panel de scripts.This article describes how to create, edit, run, and save scripts in the Script Pane.

Cómo crear y ejecutar scriptsHow to create and run scripts

Puede abrir y editar archivos de Windows PowerShell en el panel de scripts.You can open and edit Windows PowerShell files in the Script Pane. Los tipos de archivo de interés específicos de Windows PowerShell son los archivos de script (.ps1), los archivos de datos de script (.psd1) y los archivos de módulo de script (.psm1).Specific file types of interest in Windows PowerShell are script files (.ps1), script data files (.psd1), and script module files (.psm1). Estos tipos de archivo presentan color de sintaxis en el editor de panel de scripts.These file types are syntax colored in the Script Pane editor. Otros tipos de archivo comunes que puede abrir en el panel de scripts son los archivos de configuración (.ps1xml), los archivos XML y los archivos de texto.Other common file types you may open in the Script Pane are configuration files (.ps1xml), XML files, and text files.

Nota

La directiva de ejecución de Windows PowerShell determina si puede ejecutar scripts y cargar archivos de configuración y perfiles de Windows PowerShell.The Windows PowerShell execution policy determines whether you can run scripts and load Windows PowerShell profiles and configuration files. La directiva de ejecución predeterminada, Restricted, impide que se ejecuten todos los scripts y que se carguen perfiles.The default execution policy, Restricted, prevents all scripts from running, and prevents loading profiles. Para cambiar la directiva de ejecución a fin de permitir cargar y usar perfiles, consulte Set-ExecutionPolicy y about_Signing.To change the execution policy to allow profiles to load and be used, see Set-ExecutionPolicy and about_Signing.

Para crear un nuevo archivo de scriptTo create a new script file

En la barra de herramientas, haga clic en Nuevo , o bien, en el menú Archivo , haga clic en Nuevo .On the toolbar, click New , or on the File menu, click New . El archivo creado aparece en una nueva pestaña de archivo en la ficha actual de PowerShell. Recuerde que las pestañas de PowerShell solo están visibles cuando hay más de una.The created file appears in a new file tab under the current PowerShell tab. Remember that the PowerShell tabs are only visible when there are more than one. De forma predeterminada, se crea un archivo de tipo script (.ps1), pero se puede guardar con un nombre y una extensión diferentes.By default a file of type script (.ps1) is created, but it can be saved with a new name and extension. Se pueden crear varios archivos de script en la misma pestaña de PowerShell.Multiple script files can be created in the same PowerShell tab.

Para abrir un script existenteTo open an existing script

En la barra de herramientas, haga clic en Abrir , o bien, en el menú Archivo , haga clic en Abrir .On the toolbar, click Open , or on the File menu, click Open . En el cuadro de diálogo Abrir , seleccione el archivo que quiera abrir.In the Open dialog box, select the file you want to open. El archivo abierto aparece en una nueva pestaña.The opened file appears in a new tab.

Para cerrar una pestaña de scriptTo close a script tab

Haga clic en el icono Cerrar ( X ) de la pestaña del archivo que desea cerrar o bien seleccione el menú Archivo y haga clic en Cerrar .Click the Close icon ( X ) of the file tab you want to close or select the File menu and click Close .

Si el archivo se ha modificado desde que se guardó por última vez, se le preguntará si desea guardar o descartar los cambios.If the file has been altered since it was last saved, you're prompted to save or discard it.

Para mostrar la ruta de acceso del archivoTo display the file path

En la pestaña del archivo, señale el nombre de archivo.On the file tab, point to the file name. La ruta de acceso completa al archivo de script se muestra en una información sobre herramientas.The fully qualified path to the script file appears in a tooltip.

Para ejecutar un scriptTo run a script

En la barra de herramientas, haga clic en Ejecutar script , o bien, en el menú Archivo , haga clic en Ejecutar .On the toolbar, click Run Script , or on the File menu, click Run .

Para ejecutar parte de un scriptTo run a portion of a script

  1. En el panel de scripts, seleccione una parte de un script.In the Script Pane, select a portion of a script.
  2. En el menú Archivo , haga clic en Ejecutar selección , o bien haga clic en Ejecutar selección en la barra de herramientas.On the File menu, click Run Selection , or on the toolbar, click Run Selection .

Para detener un script que se está ejecutandoTo stop a running script

Hay varias maneras para detener un script en ejecución.There are several ways to stop a running script.

  • Haga clic en Detener operación en la barra de herramientasClick Stop Operation on the toolbar
  • Presione CTRL+InterrumpirPress CTRL+BREAK
  • Seleccione el menú Archivo y haga clic en Detener operación .Select the File menu and click Stop Operation .

También funciona pulsar CTRL+C, a menos que ya haya texto seleccionado, en cuyo caso CTRL+C se asigna a la función de copia del texto seleccionado.Pressing CTRL+C also works unless some text is currently selected, in which case CTRL+C maps to the copy function for the selected text.

Cómo escribir y editar texto en el panel de scriptsHow to write and edit text in the Script Pane

Puede copiar, cortar, pegar, buscar y reemplazar texto en el panel de scripts.You can copy, cut, paste, find, and replace text in the Script Pane. También puede deshacer y rehacer la última acción que ha realizado.You can also undo and redo the last action you just performed. Los métodos abreviados de teclado para estas acciones son los mismos que los usados para todas las aplicaciones de Windows.The keyboard shortcuts for these actions are the same shortcuts used for all Windows applications.

Para escribir texto en el panel de scriptsTo enter text in the Script Pane

  1. Mueva el cursor al panel de scripts haciendo clic en cualquier lugar del panel de scripts o en Ir al panel de scripts en el menú Ver .Move the cursor to the Script Pane by clicking anywhere in the Script Pane, or by clicking Go to Script Pane in the View menu.
  2. Cree un script.Create a script. El color de sintaxis y la finalización con tabulación proporcionan una experiencia de edición más rica en Windows PowerShell ISE.Syntax coloring and tab completion provide a richer editing experience in Windows PowerShell ISE.
  3. Vea Cómo usar la finalización con tabulación en el panel de scripts y en el panel de consola para obtener más información sobre el uso de la característica de finalización de con tabulación para facilitar la escritura.See How to Use Tab Completion in the Script Pane and Console Pane for details about using the tab completion feature to help in typing.

Para buscar texto en el panel de scriptsTo find text in the Script Pane

  1. Para buscar texto en cualquier lugar, pulse CTRL+F o, en el menú Edición , haga clic en Buscar en el script .To find text anywhere, press CTRL+F or, on the Edit menu, click Find in Script .
  2. Para buscar texto después del cursor, presione F3 o, en el menú Edición , haga clic en Buscar siguiente en el script .To find text after the cursor, press F3 or, on the Edit menu, click Find Next in Script .
  3. Para buscar texto antes del cursor, pulse MAYÚS+F3 o, en el menú Edición , haga clic en Buscar anterior en el script .To find text before the cursor, press SHIFT+F3 or, on the Edit menu, click Find Previous in Script .

Para buscar y reemplazar texto en el panel de scriptsTo find and replace text in the Script Pane

Presione CTRL+H o, en el menú Edición , haga clic en Reemplazar en script .Press CTRL+H or, on the Edit menu, click Replace in Script . Escriba el texto que desea encontrar y el texto de reemplazo y, después, presione ENTRAR.Enter the text you want to find and the replacement text, then press ENTER.

Para ir a una línea determinada de texto en el panel de scriptsTo go to a particular line of text in the Script Pane

  1. En el panel de scripts, pulse CTRL+G o, en el menú Edición , haga clic en Ir a la línea .In the Script Pane, press CTRL+G or, on the Edit menu, click Go to Line .

  2. Escriba un número de línea.Enter a line number.

Para copiar texto en el panel de scriptsTo copy text in the Script Pane

  1. En el panel de scripts, seleccione el texto que desee copiar.In the Script Pane, select the text that you want to copy.

  2. Pulse CTRL+C o haga clic en el icono Copiar de la barra de herramientas. O bien, en el menú Edición , haga clic en Copiar .Press CTRL+C or, on the toolbar, click the Copy icon, or on the Edit menu, click Copy .

Para cortar texto en el panel de scriptsTo cut text in the Script Pane

  1. En el panel de scripts, seleccione el texto que desee cortar.In the Script Pane, select the text that you want to cut.
  2. Pulse CTRL+X o haga clic en el icono Cortar de la barra de herramientas. O bien, en el menú Edición , haga clic en Cortar .Press CTRL+X or, on the toolbar, click the Cut icon, or on the Edit menu, click Cut .

Para pegar texto en el panel de scriptsTo paste text into the Script Pane

Pulse CTRL+V o haga clic en el icono Pegar de la barra de herramientas. O bien, en el menú Edición , haga clic en Pegar .Press CTRL+V or, on the toolbar, click the Paste icon, or on the Edit menu, click Paste .

Para deshacer una acción en el panel de scriptsTo undo an action in the Script Pane

Pulse CTRL+Z o haga clic en el icono Deshacer de la barra de herramientas. O bien, en el menú Edición , haga clic en Deshacer .Press CTRL+Z or, on the toolbar, click the Undo icon, or on the Edit menu, click Undo .

Para rehacer una acción en el panel de scriptsTo redo an action in the Script Pane

Pulse CTRL+Y o haga clic en el icono Rehacer de la barra de herramientas. O bien, en el menú Edición , haga clic en Rehacer .Press CTRL+Y or, on the toolbar, click the Redo icon, or on the Edit menu, click Redo .

Cómo guardar un scriptHow to save a script

Aparece un asterisco junto al nombre del script para marcar un archivo que no se ha guardado desde que se modificó.An asterisk appears next to the script name to mark a file that hasn't been saved since it was changed. El asterisco desaparecerá cuando se guarda el archivo.The asterisk disappears when the file is saved.

Para guardar un scriptTo save a script

Pulse CTRL+S o haga clic en el icono Guardar de la barra de herramientas. O bien, en el menú Archivo , haga clic en Guardar .Press CTRL+S or, on the toolbar, click the Save icon, or on the File menu, click Save .

Para guardar un script y asignarle un nombreTo save and name a script

  1. En el menú Archivo , haga clic en Guardar como .On the File menu, click Save As . Se abre el cuadro de diálogo Guardar como .The Save As dialog box will appear.
  2. En el cuadro Nombre de archivo , escriba un nombre para el archivo.In the File name box, enter a name for the file.
  3. En el cuadro Guardar como tipo , seleccione un tipo de archivo.In the Save as type box, select a file type. Por ejemplo, en el cuadro Guardar como tipo , seleccione "Scripts de PowerShell (*.ps1)".For example, in the Save as type box, select 'PowerShell Scripts (*.ps1)'.
  4. Haga clic en Save (Guardar).Click Save .

Para guardar un script en la codificación ASCIITo save a script in ASCII encoding

De forma predeterminada, Windows PowerShell ISE guarda los nuevos archivos de script (.ps1), los archivos de datos de script (.psd1) y los archivos de módulo de script (.psm1) como Unicode (BigEndianUnicode).By default, Windows PowerShell ISE saves new script files (.ps1), script data files (.psd1), and script module files (.psm1) as Unicode (BigEndianUnicode) by default. Para guardar un script en otra codificación, como ASCII (ANSI), use los métodos Save o SaveAs en el objeto $psISE.CurrentFile.To save a script in another encoding, such as ASCII (ANSI), use the Save or SaveAs methods on the $psISE.CurrentFile object.

El siguiente comando guarda un nuevo script como MyScript.ps1 con la codificación ASCII.The following command saves a new script as MyScript.ps1 with ASCII encoding.

$psISE.CurrentFile.SaveAs("MyScript.ps1", [System.Text.Encoding]::ASCII)

El siguiente comando reemplaza el archivo de script actual con un archivo con el mismo nombre, pero con la codificación ASCII.The following command replaces the current script file with a file with the same name, but with ASCII encoding.

$psISE.CurrentFile.Save([System.Text.Encoding]::ASCII)

El comando siguiente obtiene la codificación del archivo actual.The following command gets the encoding of the current file.

$psISE.CurrentFile.encoding

Windows PowerShell ISE admite las siguientes opciones de codificación: ASCII, BigEndianUnicode, Unicode, UTF32, UTF7, UTF8 y Default.Windows PowerShell ISE supports the following encoding options: ASCII, BigEndianUnicode, Unicode, UTF32, UTF7, UTF8, and Default. El valor de la opción predeterminada varía según el sistema.The value of the Default option varies with the system.

Windows PowerShell ISE no cambia la codificación de los archivos de script cuando se usan los comandos Guardar o Guardar como.Windows PowerShell ISE doesn't change the encoding of script files when you use the Save or Save As commands.

Consulte tambiénSee Also