Objek PowerShellTab

  • Artikel

Objek PowerShellTab mewakili lingkungan runtime Windows PowerShell.

Metode

Panggil( Skrip )

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Menjalankan skrip yang diberikan di tab PowerShell.

Catatan

Metode ini hanya berfungsi pada tab PowerShell lainnya, bukan tab PowerShell tempatnya dijalankan. Ini tidak mengembalikan objek atau nilai apa pun. Jika kode memodifikasi variabel apa pun, maka perubahan tersebut bertahan pada tab tempat perintah dipanggil.

Skrip - System.Management.Automation.ScriptBlock atau String Blok skrip untuk dijalankan.

# 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 )

Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.

Menjalankan skrip yang diberikan di tab PowerShell.

Catatan

Metode ini hanya berfungsi pada tab PowerShell lainnya, bukan tab PowerShell tempatnya dijalankan. Blok skrip dijalankan dan nilai apa pun yang dikembalikan dari skrip dikembalikan ke lingkungan eksekusi tempat Anda memanggil perintah. Jika perintah membutuhkan waktu lebih lama untuk dijalankan daripada nilai millesecondsTimeout yang ditentukan, maka perintah gagal dengan pengecualian: "Operasi telah kehabisan waktu."

Skrip - System.Management.Automation.ScriptBlock atau String Blok skrip untuk dijalankan.

[useNewScope] - Boolean opsional yang default ke Jika diatur ke $true$true, maka cakupan baru dibuat untuk menjalankan perintah. Ini tidak mengubah lingkungan runtime tab PowerShell yang ditentukan oleh perintah .

[milidetikTimeout] - Bilangan bulat opsional yang default ke 500. Jika perintah tidak selesai dalam waktu yang ditentukan, maka perintah menghasilkan TimeoutException dengan pesan "Operasi telah kehabisan waktu."

# 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)}

Properti

AddOnsMenu

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Properti baca-saja yang mendapatkan menu Add-on untuk tab 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

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Properti Boolean baca-saja yang mengembalikan $true nilai jika skrip dapat dipanggil dengan metode 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

Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya. Di Windows PowerShell ISE 2.0 ini diberi nama CommandPane.

Properti baca-saja yang mendapatkan objek editor panel Konsol.

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

DisplayName

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Properti baca-tulis yang mendapatkan atau mengatur teks yang ditampilkan pada tab PowerShell. Secara default, tab diberi nama "PowerShell #", di mana # mewakili angka.

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

ExpandedScript

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Properti Boolean baca-tulis yang menentukan apakah panel Skrip diperluas atau disembunyikan.

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

File

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Properti baca-saja yang mendapatkan kumpulan file skrip yang terbuka di tab PowerShell.

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

Output

Fitur ini ada di Windows PowerShell ISE 2.0, tetapi dihapus atau diganti namanya dalam versi ISE yang lebih baru. Di versi IsE Windows PowerShell yang lebih baru, Anda dapat menggunakan objek ConsolePane untuk tujuan yang sama.

Properti baca-saja yang mendapatkan panel Output editor saat ini.

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

Prompt

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Properti baca-saja yang mendapatkan teks perintah saat ini. Catatan: fungsi Prompt dapat ditimpa oleh profil pengguna ™. Jika hasilnya selain string sederhana, maka properti ini tidak mengembalikan apa pun.

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

Tampilkan Perintah

Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.

Properti baca-tulis yang menunjukkan apakah panel Perintah saat ini ditampilkan.

# 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

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Properti baca-saja yang mendapatkan teks status PowerShellTab .

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

HorizontalAddOnToolsPaneOpened

Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.

Properti baca-saja yang menunjukkan apakah panel alat Add-On horizontal saat ini terbuka.

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

VerticalAddOnToolsPaneOpened

Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.

Properti baca-saja yang menunjukkan apakah panel alat Add-On vertikal saat ini terbuka.

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

Lihat Juga