Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
L'oggetto PowerShellTab rappresenta un ambiente di runtime di Windows PowerShell.
Metodi
Invoke( Script )
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Esegue lo script specificato nella scheda di PowerShell.
Nota
Questo metodo funziona solo su altre schede di PowerShell, non sulla scheda da cui viene eseguito. Non restituisce oggetti o valori. Se il codice modifica una variabile, le modifiche vengono mantenute nella scheda in cui è stato richiamato il comando.
Script - System.Management.Automation.ScriptBlock or String Il blocco di script da eseguire.
# 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 )
Supportato in Windows PowerShell ISE 3.0 e versioni successive e non presente nelle versioni precedenti.
Esegue lo script specificato nella scheda di PowerShell.
Nota
Questo metodo funziona solo su altre schede di PowerShell, non sulla scheda da cui viene eseguito. Il blocco di script viene eseguito e qualsiasi valore restituito dallo script viene restituito all'ambiente di esecuzione da cui è stato richiamato il comando. Se l'esecuzione del comando richiede più tempo rispetto al valore specificato in millesecondsTimeout, il comando non riesce con l'eccezione: "Timeout dell'operazione".
Script - System.Management.Automation.ScriptBlock or String Il blocco di script da eseguire.
[useNewScope] - Valore booleano facoltativo che per $true impostazione predefinita è Se impostato su $true, viene creato un nuovo ambito all'interno del quale eseguire il comando. Non modifica l'ambiente di runtime della scheda di PowerShell specificato dal comando.
[millisecondsTimeout] - Numero intero facoltativo che per impostazione predefinita è 500. Se il comando non viene completato entro il tempo specificato, genera TimeoutException con il messaggio "Timeout dell'operazione".
# 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)}
Proprietà
AddOnsMenu
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Proprietà di sola lettura che ottiene il menu Componenti aggiuntivi per la scheda di PowerShell.
# 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
CanInvoke
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Proprietà di sola lettura booleana che restituisce un valore $true se uno script può essere chiamato con il metodo Invoke( Script ).
# 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
ConsolePane
Supportato in Windows PowerShell ISE 3.0 e versioni successive e non presente nelle versioni precedenti. In Windows PowerShell ISE 2.0 era denominato CommandPane.
Proprietà di sola lettura che ottiene l'oggetto editor del riquadro della console.
# Gets the Console Pane editor.
$psISE.CurrentPowerShellTab.ConsolePane
DisplayName
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Proprietà di lettura/scrittura che ottiene o imposta il testo visualizzato nella scheda Di PowerShell. Per impostazione predefinita, le schede sono denominate "PowerShell #", dove # rappresenta un numero.
$newTab = $psISE.PowerShellTabs.Add()
# Change the DisplayName of the new PowerShell tab.
$newTab.DisplayName = 'Brand New Tab'
ExpandedScript
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Proprietà di lettura/scrittura booleana che determina se il riquadro di script è espanso o nascosto.
# Toggle the expanded script property to see its effect.
$psISE.CurrentPowerShellTab.ExpandedScript = !$psISE.CurrentPowerShellTab.ExpandedScript
File
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Proprietà di sola lettura che ottiene la raccolta di file di script aperti nella scheda di PowerShell.
$newFile = $psISE.CurrentPowerShellTab.Files.Add()
$newFile.Editor.Text = "a`r`nb"
# Gets the line count
$newFile.Editor.LineCount
Output
Questa funzionalità è presente in Windows PowerShell ISE 2.0, ma è stata rimossa o rinominata nelle versioni successive di ISE. Nelle versioni successive di Windows PowerShell ISE, è possibile usare l'oggetto ConsolePane per gli stessi scopi.
Proprietà di sola lettura che ottiene il riquadro di output dell'editor corrente.
# Clears the text in the Output pane.
$psISE.CurrentPowerShellTab.output.clear()
Richiesta
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Proprietà di sola lettura che ottiene il testo della richiesta corrente. Nota: la funzione Prompt può essere sostituita dal profilo dell'utente. Se il risultato è diverso da una stringa semplice, questa proprietà restituisce nothing.
# Gets the current prompt text.
$psISE.CurrentPowerShellTab.Prompt
ShowCommands
Supportato in Windows PowerShell ISE 3.0 e versioni successive e non presente nelle versioni precedenti.
Proprietà di lettura/scrittura che indica se il riquadro dei comandi è attualmente visualizzato.
# 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}
StatusText
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Proprietà di sola lettura che ottiene il testo dello stato di PowerShellTab.
# Gets the current status text,
$psISE.CurrentPowerShellTab.StatusText
HorizontalAddOnToolsPaneOpened
Supportato in Windows PowerShell ISE 3.0 e versioni successive e non presente nelle versioni precedenti.
Proprietà di sola lettura che indica se il riquadro dello strumento Componenti aggiuntivi orizzontale è attualmente aperto.
# Gets the current state of the horizontal Add-ons tool pane.
$psISE.CurrentPowerShellTab.HorizontalAddOnToolsPaneOpened
VerticalAddOnToolsPaneOpened
Supportato in Windows PowerShell ISE 3.0 e versioni successive e non presente nelle versioni precedenti.
Proprietà di sola lettura che indica se il riquadro dello strumento Componenti aggiuntivi verticale è attualmente aperto.
# Turns on the Commands pane
$psISE.CurrentPowerShellTab.ShowCommands = $true
# Gets the current state of the vertical Add-ons tool pane.
$psISE.CurrentPowerShellTab.HorizontalAddOnToolsPaneOpened
Vedi anche
Collabora con noi su GitHub
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.
