TabExpansion2

TabExpansion2
    [-inputScript] <String>
    [[-cursorColumn] <Int32>]
    [[-options] <Hashtable>]
    [<CommonParameters>]

TabExpansion2
    [-ast] <Ast>
    [-tokens] <Token[]>
    [-positionOfCursor] <IScriptPosition>
    [[-options] <Hashtable>]
    [<CommonParameters>]

TabExpansion2 사용자 입력에 대한 탭 완성을 제공하는 기본 제공 함수입니다. PowerShell은 사용자가 명령을 입력하는 동안 Tab 누르거나 Ctrl + 키를때 이 함수를 호출합니다. 함수는 현재 입력에 대해 가능한 완료 목록을 반환합니다.

TabExpansion2 일반적으로 사용자가 직접 호출하지 않습니다. 그러나 탭 완성을 테스트하는 데 유용할 수 있습니다. TabExpansion2사용하려면 스크립트에서 현재 입력 스크립트와 커서 위치를 제공해야 합니다. 이 함수는 현재 입력에 대한 가능한 완료 목록을 포함하는 CommandCompletion 개체를 반환합니다. 이 입력 스크립트는 스크립트를 나타내는 문자열 또는 추상 구문 트리(AST)일 수 있습니다.

PowerShell 세션에서 이름이 같은 사용자 지정 함수를 정의하여 TabExpansion2 기본 동작을 재정의할 수 있습니다. 이 사용자 지정 함수는 사용자 지정 명령 또는 매개 변수에 대한 완성을 제공할 수 있습니다. TabExpansion2재정의할 수 있지만 지원되지 않습니다. 탭 완성 동작을 사용자 지정해야 하는 특정한 필요성이 있는 경우에만 사용자 지정 함수를 만들어야 합니다.

이 예제에서는 PowerShell 명령 프롬프트에 Format-Hex -<Tab> 입력하여 얻을 수 있는 것과 동일한 결과를 보여줍니다. TabExpansion2 함수는 토큰에 대한 가능한 완료 목록을 포함하는 - 개체를 반환합니다.

TabExpansion2 -inputScript ($s = 'Format-Hex -') -cursorColumn $s.Length |
    Select-Object -ExpandProperty CompletionMatches

CompletionText       ListItemText           ResultType ToolTip
--------------       ------------           ---------- -------
-Path                Path                ParameterName [string[]] Path
-LiteralPath         LiteralPath         ParameterName [string[]] LiteralPath
-InputObject         InputObject         ParameterName [Object] InputObject
-Encoding            Encoding            ParameterName [string] Encoding
-Raw                 Raw                 ParameterName [switch] Raw
-Verbose             Verbose             ParameterName [switch] Verbose
-Debug               Debug               ParameterName [switch] Debug
-ErrorAction         ErrorAction         ParameterName [ActionPreference] ErrorAction
-WarningAction       WarningAction       ParameterName [ActionPreference] WarningAction
-InformationAction   InformationAction   ParameterName [ActionPreference] InformationAction
-ErrorVariable       ErrorVariable       ParameterName [string] ErrorVariable
-WarningVariable     WarningVariable     ParameterName [string] WarningVariable
-InformationVariable InformationVariable ParameterName [string] InformationVariable
-OutVariable         OutVariable         ParameterName [string] OutVariable
-OutBuffer           OutBuffer           ParameterName [int] OutBuffer
-PipelineVariable    PipelineVariable    ParameterName [string] PipelineVariable

이 예제에서는 매개 변수 값에 대한 탭 완성을 가져오는 방법을 보여줍니다. 이 예제에서는 Stage 매개 변수에 세 가지 가능한 값이 있고 값 중 하나가 Three것으로 예상합니다. 이 기술을 사용하여 함수에 대한 탭 완성이 예상된 결과를 반환하도록 테스트할 수 있습니다.

function Get-Data {
    param (
        [ValidateSet('One', 'Two', 'Three')]
        [string]$Stage
    )
    Write-Verbose "Retrieving data for stage $Stage"
}

$result = TabExpansion2 -inputScript ($line = 'Get-Data -Stage ') -cursorColumn $line.Length |
    Select-Object -ExpandProperty CompletionMatches
$result.Count -eq 3
$result.CompletionText -contains 'Three'

True
True

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.