El objeto PowerShellTabThe PowerShellTab Object

El objeto PowerShellTab representa un entorno de runtime de Windows PowerShell.The PowerShellTab object represents a Windows PowerShell runtime environment.

MétodosMethods

Invoke( Script )Invoke( Script )

Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.Supported in Windows PowerShell ISE 2.0 and later.

Ejecuta el script especificado en la pestaña de PowerShell.Runs the given script in the PowerShell tab.

Nota

Este método solo funciona en otras pestañas de PowerShell, no en la pestaña de PowerShell desde la que se ejecuta.This method only works on other PowerShell tabs, not the PowerShell tab from which it is run. No devuelve ningún objeto o valor.It does not return any object or value. Si el código modifica cualquier variable, esos cambios se conservan en la pestaña en la que se invocó el comando.If the code modifies any variable, then those changes persist on the tab against which the command was invoked.

Script : System.Management.Automation.ScriptBlock o cadena. El bloque de script para ejecutar.Script - System.Management.Automation.ScriptBlock or String The script block to run.

# Manually create a second PowerShell tab before running this script.
# Return to the first PowerShell tab and type the following command
$psISE.PowerShellTabs[1].Invoke({dir})

InvokeSynchronous( Script, [useNewScope], millisecondsTimeout )InvokeSynchronous( Script, [useNewScope], millisecondsTimeout )

Se admite en Windows PowerShell ISE 3.0 y versiones posteriores y no está presente en las versiones anteriores.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

Ejecuta el script especificado en la pestaña de PowerShell.Runs the given script in the PowerShell tab.

Nota

Este método solo funciona en otras pestañas de PowerShell, no en la pestaña de PowerShell desde la que se ejecuta.This method only works on other PowerShell tabs, not the PowerShell tab from which it is run. El bloque de script se ejecuta y cualquier valor que se devuelve desde el script se devuelve al entorno de ejecución desde el que se invocó el comando.The script block is run and any value that is returned from the script is returned to the run environment from which you invoked the command. Si el comando tarda más tiempo en ejecutarse que lo que especifica el valor de millesecondsTimeout , el comando no se ejecuta correctamente e inicia una excepción: "La operación ha agotado el tiempo de espera".If the command takes longer to run than the millesecondsTimeout value specifies, then the command fails with an exception: "The operation has timed out."

Script : System.Management.Automation.ScriptBlock o cadena. El bloque de script para ejecutar.Script - System.Management.Automation.ScriptBlock or String The script block to run.

[useNewScope] : booleano opcional cuyo valor predeterminado es $true. Si está establecido en $true, se crea un nuevo ámbito en el que ejecutar el comando.[useNewScope] - Optional Boolean that defaults to $true If set to $true, then a new scope is created within which to run the command. No modifica el entorno de tiempo de ejecución de la pestaña de PowerShell que se especifica mediante el comando.It does not modify the runtime environment of the PowerShell tab that is specified by the command.

[millisecondsTimeout] : entero opcional cuyo valor predeterminado es 500.[millisecondsTimeout] - Optional integer that defaults to 500. Si el comando no finaliza dentro del tiempo especificado, inicia TimeoutException con el mensaje "La operación ha agotado el tiempo de espera.".If the command does not finish within the specified time, then the command generates a TimeoutException with the message "The operation has timed out."

# Create a new PowerShell tab and then switch back to the first
$psISE.PowerShellTabs.Add()
$psISE.PowerShellTabs.SetSelectedPowerShellTab($psISE.PowerShellTabs[0])

# Invoke a simple command on the other tab, in its own scope
$psISE.PowerShellTabs[1].InvokeSynchronous('$x=1', $false)
# You can switch to the other tab and type '$x' to see that the value is saved there.

# This example sets a value in the other tab (in a different scope)
# and returns it through the pipeline to this tab to store in $a
$a = $psISE.PowerShellTabs[1].InvokeSynchronous('$z=3;$z')
$a

# This example runs a command that takes longer than the allowed timeout value
# and measures how long it runs so that you can see the impact
Measure-Command {$psISE.PowerShellTabs[1].InvokeSynchronous('sleep 10', $false, 5000)}

PropiedadesProperties

AddOnsMenuAddOnsMenu

Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.Supported in Windows PowerShell ISE 2.0 and later.

La propiedad de solo lectura que obtiene el menú Complementos para la pestaña de PowerShell.The read-only property that gets the Add-ons menu for the PowerShell tab.

# Clear the Add-ons menu if one exists.
$psISE.CurrentPowerShellTab.AddOnsMenu.SubMenus.Clear()
# Create an AddOns menu with an accessor.
# Note the use of "_"  as opposed to the "&" for mapping to the fast key letter for the menu item.
$menuAdded = $psISE.CurrentPowerShellTab.AddOnsMenu.SubMenus.Add('_Process', {Get-Process}, 'Alt+P')
# Add a nested menu.
$parentAdded = $psISE.CurrentPowerShellTab.AddOnsMenu.SubMenus.Add('Parent', $null, $null)
$parentAdded.SubMenus.Add('_Dir', {dir}, 'Alt+D')
# Show the Add-ons menu on the current PowerShell tab.
$psISE.CurrentPowerShellTab.AddOnsMenu

CanInvokeCanInvoke

Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.Supported in Windows PowerShell ISE 2.0 and later.

La propiedad booleana de solo lectura que devuelve un valor $true si se puede invocar un script con el método Invoke( Script ).The read-only Boolean property that returns a $true value if a script can be invoked with the Invoke( Script ) method.

# CanInvoke will be false if the PowerShell
# tab is running a script that takes a while, and you
# check its properties from another PowerShell tab. It is
# always false if checked on the current PowerShell tab.
# Manually create a second PowerShell tab before running this script.
# Return to the first tab and type
$secondTab = $psISE.PowerShellTabs[1]
$secondTab.CanInvoke
$secondTab.Invoke({sleep 20})
$secondTab.CanInvoke

ConsolePaneConsolePane

Se admite en Windows PowerShell ISE 3.0 y versiones posteriores y no está presente en las versiones anteriores.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions. En Windows PowerShell ISE 2.0 esto se llamaba CommandPane.In Windows PowerShell ISE 2.0 this was named CommandPane.

La propiedad de solo lectura que obtiene el objeto editor del panel de consola.The read-only property that gets the Console pane editor object.

# Gets the Console Pane editor.
$psISE.CurrentPowerShellTab.ConsolePane

DisplayNameDisplayName

Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.Supported in Windows PowerShell ISE 2.0 and later.

La propiedad de lectura y escritura que obtiene o establece el texto que se muestra en la pestaña de PowerShell. De forma predeterminada, las pestañas se denominan "PowerShell #", donde # representa un número.The read-write property that gets or sets the text that is displayed on the PowerShell tab. By default, tabs are named "PowerShell #", where the # represents a number.

$newTab = $psISE.PowerShellTabs.Add()
# Change the DisplayName of the new PowerShell tab.
$newTab.DisplayName = 'Brand New Tab'

ExpandedScriptExpandedScript

Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.Supported in Windows PowerShell ISE 2.0 and later.

La propiedad booleana de lectura y escritura que determina si el panel de scripts se expande o se oculta.The read-write Boolean property that determines whether the Script pane is expanded or hidden.

# Toggle the expanded script property to see its effect.
$psISE.CurrentPowerShellTab.ExpandedScript = !$psISE.CurrentPowerShellTab.ExpandedScript

ArchivosFiles

Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.Supported in Windows PowerShell ISE 2.0 and later.

La propiedad de solo lectura que obtiene la colección de archivos de scripts que están abiertos en la pestaña de PowerShell.The read-only property that gets the collection of script files that are open in the PowerShell tab.

$newFile = $psISE.CurrentPowerShellTab.Files.Add()
$newFile.Editor.Text = "a`r`nb"
# Gets the line count
$newFile.Editor.LineCount

OutputOutput

Esta característica está presente en Windows PowerShell ISE 2.0, pero se quitó o se cambió de nombre en versiones posteriores del ISE.This feature is present in Windows PowerShell ISE 2.0, but was removed or renamed in later versions of the ISE. En versiones posteriores de Windows PowerShell ISE, puede usar el objeto ConsolePane con el mismo propósito.In later versions of Windows PowerShell ISE, you can use the ConsolePane object for the same purposes.

La propiedad de solo lectura que obtiene el panel de salida del editor actual .The read-only property that gets the Output pane of the current editor.

# Clears the text in the Output pane.
$psISE.CurrentPowerShellTab.output.clear()

PromptPrompt

Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.Supported in Windows PowerShell ISE 2.0 and later.

La propiedad de solo lectura que obtiene el texto de la petición actual.The read-only property that gets the current prompt text. Nota: El perfil del usuario puede reemplazar a la función Prompt.Note: the Prompt function can be overridden by the user'™s profile. Si el resultado es distinto de una cadena simple, esta propiedad no devuelve nada.If the result is other than a simple string, then this property returns nothing.

# Gets the current prompt text.
$psISE.CurrentPowerShellTab.Prompt

ShowCommandsShowCommands

Se admite en Windows PowerShell ISE 3.0 y versiones posteriores y no está presente en las versiones anteriores.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

La propiedad de lectura y escritura que indica si actualmente se muestra el panel de comandos.The read-write property that indicates if the Commands pane is currently displayed.

# Gets the current status of the Commands pane and stores it in the $a variable
$a = $psISE.CurrentPowerShellTab.ShowCommands
# if $a is $false, then turn the Commands pane on by changing the value to $true
if (!$a) {$psISE.CurrentPowerShellTab.ShowCommands = $true}

StatusTextStatusText

Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.Supported in Windows PowerShell ISE 2.0 and later.

La propiedad de solo lectura que obtiene el texto de estado de PowerShellTab.The read-only property that gets the PowerShellTab status text.

# Gets the current status text,
$psISE.CurrentPowerShellTab.StatusText

HorizontalAddOnToolsPaneOpenedHorizontalAddOnToolsPaneOpened

Se admite en Windows PowerShell ISE 3.0 y versiones posteriores y no está presente en las versiones anteriores.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

La propiedad de solo lectura que indica si el panel de herramientas de complementos horizontal está abierto actualmente.The read-only property that indicates whether the horizontal Add-Ons tool pane is currently open.

# Gets the current state of the horizontal Add-ons tool pane.
$psISE.CurrentPowerShellTab.HorizontalAddOnToolsPaneOpened

VerticalAddOnToolsPaneOpenedVerticalAddOnToolsPaneOpened

Se admite en Windows PowerShell ISE 3.0 y versiones posteriores y no está presente en las versiones anteriores.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

La propiedad de solo lectura que indica si el panel de herramientas de complementos vertical está abierto actualmente.The read-only property that indicates whether the vertical Add-Ons tool pane is currently open.

# Turns on the Commands pane
$psISE.CurrentPowerShellTab.ShowCommands = $true
# Gets the current state of the vertical Add-ons tool pane.
$psISE.CurrentPowerShellTab.HorizontalAddOnToolsPaneOpened

Consulte tambiénSee Also