PowerShellTab 개체

PowerShellTab 개체는 Windows PowerShell 런타임 환경을 나타냅니다.

메서드

Invoke( Script )

Windows PowerShell ISE 2.0 이상에서 지원됩니다.

PowerShell 탭에서 지정된 스크립트를 실행합니다.

스크립트 - System.Management.Automation.ScriptBlock 또는 문자열 실행할 스크립트 블록입니다.

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

Windows PowerShell ISE 3.0 이상에서 지원되며, 이전 버전에는 없습니다.

PowerShell 탭에서 지정된 스크립트를 실행합니다.

스크립트 - System.Management.Automation.ScriptBlock 또는 문자열 실행할 스크립트 블록입니다.

[useNewScope] - 기본적으로 $true로 설정되는 선택적 부울. $true로 설정된 경우 명령을 실행할 새 범위가 만들어집니다. 명령으로 지정된 PowerShell 탭의 런타임 환경은 수정되지 않습니다.

[millisecondsTimeout]- 기본값이 500인 선택적 정수 이 명령이 지정된 시간 안에 완료되지 않으면 이 명령은 "작업 시간이 초과되었습니다"라는 메시지와 함께 TimeoutException을 생성합니다.

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

속성

AddOnsMenu

Windows PowerShell ISE 2.0 이상에서 지원됩니다.

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

Windows PowerShell ISE 2.0 이상에서 지원됩니다.

Invoke(Script) 메서드를 사용하여 스크립트를 $true 호출할 수 있는 경우 값을 반환하는 읽기 전용 부울 속성입니다.

# 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

Windows PowerShell ISE 3.0 이상에서 지원되며, 이전 버전에는 없습니다. Windows PowerShell ISE 2.0에서는 CommandPane이라는 이름이 지정되었습니다.

콘솔 창 편집 기 개체를 가져오는 읽기 전용 속성입니다.

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

DisplayName

Windows PowerShell ISE 2.0 이상에서 지원됩니다.

PowerShell 탭에 표시되는 텍스트를 가져오거나 설정하는 읽기-쓰기 속성입니다. 기본적으로 탭 이름은 "PowerShell #"이며 여기서 #은 숫자를 나타냅니다.

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

ExpandedScript

Windows PowerShell ISE 2.0 이상에서 지원됩니다.

스크립트 창이 확장 또는 숨겨져 있는지 여부를 결정하는 읽기-쓰기를 부울 속성입니다.

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

Files

Windows PowerShell ISE 2.0 이상에서 지원됩니다.

PowerShell 탭에서 열려 있는 스크립트 파일의 컬렉션을 가져오는 읽기 전용 속성입니다.

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

출력

이 기능은 Windows PowerShell ISE 2.0에 있지만 이후 버전의 ISE에서 제거되거나 이름이 바뀌었습니다. 이후 버전의 Windows PowerShell ISE에서는 ConsolePane 개체를 동일한 용도로 사용할 수 있습니다.

현재 편집기의 출력 창을 가져오는 읽기 전용 속성입니다.

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

프롬프트

Windows PowerShell ISE 2.0 이상에서 지원됩니다.

현재 프롬프트 텍스트를 가져오는 읽기 전용 속성입니다. 참고: 프롬프트 함수는 사용자의 프로필에 의해 재정의™될 수 있습니다. 결과가 단순 문자열이 아니라면 이 속성은 아무 것도 반환하지 않습니다.

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

ShowCommands

Windows PowerShell ISE 3.0 이상에서 지원되며, 이전 버전에는 없습니다.

명령 창이 현재 표시되는지 나타내는 읽기/쓰기 속성입니다.

# 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

Windows PowerShell ISE 2.0 이상에서 지원됩니다.

PowerShellTab 상태 텍스트를 가져오는 읽기 전용 속성입니다.

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

HorizontalAddOnToolsPaneOpened

Windows PowerShell ISE 3.0 이상에서 지원되며, 이전 버전에는 없습니다.

가로 추가 기능 도구 창이 현재 열려 있는지 여부를 나타내는 읽기 전용 속성입니다.

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

VerticalAddOnToolsPaneOpened

Windows PowerShell ISE 3.0 이상에서 지원되며, 이전 버전에는 없습니다.

세로 추가 기능 도구 창이 현재 열려 있는지 여부를 나타내는 읽기 전용 속성입니다.

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

참고 항목

• PowerShellTabCollection 개체
• Windows PowerShell ISE 스크립팅 개체 모델의 용도
• ISE 개체 모델 계층 구조