PowerShellTab 개체The PowerShellTab Object

PowerShellTab 개체는 Windows PowerShell 런타임 환경을 나타냅니다.The PowerShellTab object represents a Windows PowerShell runtime environment.

메서드Methods

Invoke( Script )Invoke( Script )

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

PowerShell 탭에서 지정된 스크립트를 실행합니다.Runs the given script in the PowerShell tab.

참고

이 메서드는 이 메서드가 실행되는 PowerShell 탭이 아닌, 다른 PowerShell 탭에 대해서만 작동합니다.This method only works on other PowerShell tabs, not the PowerShell tab from which it is run. 개체 또는 값을 반환하지 않습니다.It does not return any object or value. 코드가 어떤 변수든 수정한다면, 해당 변경 내용은 해당 명령이 호출된 탭에서 유지됩니다.If the code modifies any variable, then those changes persist on the tab against which the command was invoked.

Script - System.Management.Automation.ScriptBlock 또는 문자열. 실행할 스크립트 블록입니다.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 )

Windows PowerShell ISE 3.0 이상에서 지원되며, 이전 버전에는 없습니다.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

PowerShell 탭에서 지정된 스크립트를 실행합니다.Runs the given script in the PowerShell tab.

참고

이 메서드는 이 메서드가 실행되는 PowerShell 탭이 아닌, 다른 PowerShell 탭에 대해서만 작동합니다.This method only works on other PowerShell tabs, not the PowerShell tab from which it is run. 스크립트 블록이 실행되고, 스크립트에서 반환되는 모든 값은 명령을 호출한 실행 환경에 반환됩니다.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. millesecondsTimeout 값이 지정하는 시간보다 명령이 실행되는 데 더 오래 걸린다면 "작업 시간이 초과되었습니다."라는 예외와 함께 명령이 실패합니다.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 또는 문자열. 실행할 스크립트 블록입니다.Script - System.Management.Automation.ScriptBlock or String The script block to run.

[useNewScope] - 기본적으로 $true로 설정되는 선택적 부울. $true로 설정된 경우 명령을 실행할 새 범위가 만들어집니다.[useNewScope] - Optional Boolean that defaults to $true If set to $true, then a new scope is created within which to run the command. 명령으로 지정되는 PowerShell 탭의 런타임 환경을 수정하지는 않습니다.It does not modify the runtime environment of the PowerShell tab that is specified by the command.

[millisecondsTimeout] - 기본값이 500인 선택적 정수.[millisecondsTimeout] - Optional integer that defaults to 500. 이 명령이 지정된 시간 안에 완료되지 않으면 이 명령은 "작업 시간이 초과되었습니다"라는 메시지와 함께 TimeoutException을 생성합니다.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)}

속성Properties

AddOnsMenuAddOnsMenu

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

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

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

스크립트를 Invoke( Script ) 메서드로 호출할 수 있으면 $true 값을 반환하는 읽기 전용 부울 속성입니다.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

Windows PowerShell ISE 3.0 이상에서 지원되며, 이전 버전에는 없습니다.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions. Windows PowerShell ISE 2.0에서는 이 속성의 이름이 CommandPane이었습니다.In Windows PowerShell ISE 2.0 this was named CommandPane.

콘솔 창 editor 개체를 가져오는 읽기 전용 속성입니다.The read-only property that gets the Console pane editor object.

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

DisplayNameDisplayName

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

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

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

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

파일Files

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

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

출력Output

이 기능은 Windows PowerShell ISE 2.0에는 있었지만 그 이후 버전의 ISE에서 제거되었거나 이름이 바뀌었습니다.This feature is present in Windows PowerShell ISE 2.0, but was removed or renamed in later versions of the ISE. Windows PowerShell ISE의 이후 버전에서는 동일한 용도로 ConsolePane 개체를 사용할 수 있습니다.In later versions of Windows PowerShell ISE, you can use the ConsolePane object for the same purposes.

현재 편집기의 출력 창을 가져오는 읽기 전용 속성입니다.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

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

현재 프롬프트 텍스트를 가져오는 읽기 전용 속성입니다.The read-only property that gets the current prompt text. 참고: Prompt 함수는 사용자 프로필로 재정의할 수 있습니다.Note: the Prompt function can be overridden by the user'™s profile. 결과가 단순 문자열이 아니라면 이 속성은 아무 것도 반환하지 않습니다.If the result is other than a simple string, then this property returns nothing.

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

ShowCommandsShowCommands

Windows PowerShell ISE 3.0 이상에서 지원되며, 이전 버전에는 없습니다.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

현재 명령 창이 표시되어 있는지 여부를 나타내는 읽기-쓰기 속성입니다.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

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

PowerShellTab 상태 텍스트를 가져오는 읽기 전용 속성입니다.The read-only property that gets the PowerShellTab status text.

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

HorizontalAddOnToolsPaneOpenedHorizontalAddOnToolsPaneOpened

Windows PowerShell ISE 3.0 이상에서 지원되며, 이전 버전에는 없습니다.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

가로 추가 기능 도구 창이 현재 열려 있는지 여부를 나타내는 읽기 전용 속성입니다.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

Windows PowerShell ISE 3.0 이상에서 지원되며, 이전 버전에는 없습니다.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

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

참고 항목See Also