| title | Manage Tab Completion (SQL Server PowerShell) | Microsoft Docs | |
|---|---|---|
| ms.custom | ||
| ms.date | 03/14/2017 | |
| ms.prod | sql-server-2016 | |
| ms.reviewer | ||
| ms.suite | ||
| ms.technology |
|
|
| ms.tgt_pltfrm | ||
| ms.topic | article | |
| ms.assetid | 6296848a-890f-4ad3-8d9f-92ed6a79aa00 | |
| caps.latest.revision | 6 | |
| author | JennieHubbard | |
| ms.author | jhubbard | |
| manager | jhubbard |
The [!INCLUDEssNoVersion] PowerShell snap-ins introduce three variables ($SqlServerMaximumTabCompletion, $SqlServerMaximumChildItems, and $SqlServerIncludeSystemObjects) to control Windows PowerShell tab completion. Tab completion reduces the amount of typing you must do by returning tables of items whose names start with the string you are typing.
With Windows PowerShell tab-completion, when you have typed part of a path or cmdlet name, you can hit the Tab key to get a list of the items whose names match what you have already typed. You can then select the item you want from the list without having to type the rest of the name.
If you are working in a database that has a lot of objects, the tab-completion lists can become very large. Some [!INCLUDEssNoVersion] object types, such as views, also have large numbers of system objects.
The [!INCLUDEssNoVersion] snap-ins introduces three system variables that you can use to control the amount of information presented by tab-completion and Get-ChildItem.
$SqlServerMaximumTabCompletion = n
Specifies the maximum number of objects to include in a tab-completion list. If you select Tab at a path node having more than n objects, the tab-completion list is truncated at n. n is an integer. 0 is the default setting, and means there is no limit to the number of objects listed.
$SqlServerMaximumChildItems = n
Specifies the maximum number of objects displayed by Get-ChildItem. If Get-ChildItem is run at a path node having more than n objects, the list is truncated at n. n is an integer. 0 is the default setting, and means there is no limit to the number of objects listed.
$SqlServerIncludeSystemObjects = { $True | $False }
If $True, system objects are displayed by tab-completion and Get-ChildItem. If $False, no system objects are displayed. The default setting is $False.
For any of the variables you want to change from the default value, set the variable to the new value.
The following example sets all three variables and lists their settings:
$SqlServerMaximumTabCompletion = 20
$SqlServerMaximumChildItems = 10
$SqlServerIncludeSystemObjects = $False
dir variable:sqlserver*