|
1 | 1 | # vscode-powershell Release History
|
2 | 2 |
|
| 3 | +## 0.10.0 |
| 4 | +### Tuesday, March 14, 2017 |
| 5 | + |
| 6 | +#### New interactive console experience |
| 7 | + |
| 8 | +We are excited to provide you with the first release of our new interactive |
| 9 | +console experience! When you open up a PowerShell script file, you will |
| 10 | +be greeted with a new VS Code integrated terminal window called |
| 11 | +"PowerShell Integrated Console" |
| 12 | + |
| 13 | + |
| 14 | + |
| 15 | +In this console you will have an experience that falls somewhere between |
| 16 | +the PowerShell ISE and the PowerShell console host: |
| 17 | + |
| 18 | +- Tab completion of commands and their parameters |
| 19 | +- Basic command history, accessed using the up/down arrow keys |
| 20 | +- The `psedit` command opens existing files in an editor pane |
| 21 | +- Pressing <kbd>F8</kbd> in an editor pane runs the current line or selection in the console |
| 22 | +- Native applications like `git` are fully supported |
| 23 | +- Script debugging shares the same console session with the editor for |
| 24 | + a true ISE-like debugging experience |
| 25 | + |
| 26 | +It even works with your fancy prompt function if configured in your |
| 27 | +VS Code profile (`$HOME\Documents\WindowsPowerShell\Microsoft.VSCode_profile.ps1`): |
| 28 | + |
| 29 | + |
| 30 | + |
| 31 | +The integrated console is supported on PowerShell v3 through v6 and works |
| 32 | +on Linux and macOS with PowerShell Core. By default you don't have to |
| 33 | +configure which PowerShell to run, we will pick an appropriate default |
| 34 | +based on your platform. If you'd like to choose a different install |
| 35 | +of PowerShell you can always change the `powershell.developer.powerShellExePath` |
| 36 | +setting. |
| 37 | + |
| 38 | +Keep in mind that this is the first release for this feature and there are |
| 39 | +bound to be issues and missing functionality. Please feel free to file |
| 40 | +GitHub issues for any bugs or feature requests! |
| 41 | + |
| 42 | +##### Known Issues and Limitations |
| 43 | + |
| 44 | +- [#535](https://github.com/PowerShell/vscode-powershell/issues/535) PSReadline |
| 45 | + is currently **not** supported in the integrated console. We will enable this |
| 46 | + in a future release. |
| 47 | +- [#534](https://github.com/PowerShell/vscode-powershell/issues/534) Integrated console |
| 48 | + prompt is not restarted when you stop the debugging of a local runspace in another |
| 49 | + process. This will be addressed soon in a patch update. |
| 50 | +- [#533](https://github.com/PowerShell/vscode-powershell/issues/533) Backspace key |
| 51 | + does not work in the integrated console on Linux and macOS. The workaround for now |
| 52 | + is to use <kbd>Ctrl+H</kbd> instead of the Backspace key. This will be addressed |
| 53 | + soon in a patch update. |
| 54 | +- [#536](https://github.com/PowerShell/vscode-powershell/issues/536) Integrated console |
| 55 | + sometimes does not have a scrollbar at startup. The workaround is to resize the width |
| 56 | + of the VS Code window slightly and the scrollbar will appear. This will be addressed |
| 57 | + soon in a patch update. |
| 58 | + |
| 59 | +#### Get-Credential and PSCredential support |
| 60 | + |
| 61 | +Now that we have the integrated console, we have added support for the `Get-Credential` |
| 62 | +cmdlet, `Read-Host -AsSecureString`, and any input prompt of type `SecureString` or `PSCredential`. |
| 63 | +When you run any of these cmdlets you will be prompted inside the integrated console: |
| 64 | + |
| 65 | + |
| 66 | + |
| 67 | +#### Code formatting improvements |
| 68 | + |
| 69 | +We now support VS Code's `editor.formatOnType` setting so that your code gets formatted |
| 70 | +as you type! Formatting will be triggered when you press Enter or the closing curly |
| 71 | +brace character `}`. |
| 72 | + |
| 73 | +Based on your feedback, we've also added new code formatting options, all of which |
| 74 | +are turned on by default: |
| 75 | + |
| 76 | +- `powershell.codeFormatting.newLineAfterCloseBrace` - Causes a newline to be inserted |
| 77 | + after a closing brace in multi-line expressions like if/else |
| 78 | +- `powershell.codeFormatting.whitespaceBeforeOpenBrace` - Causes whitespace to be |
| 79 | + inserted before an open brace like `Foreach-Object {` |
| 80 | +- `powershell.codeFormatting.whitespaceBeforeOpenParen` - Causes whitespace to be |
| 81 | + inserted before an open parentheses like `if (` |
| 82 | +- `powershell.codeFormatting.whitespaceAroundOperator` - Causes whitespace to be |
| 83 | + inserted around operators like `=` or `+` |
| 84 | +- `powershell.codeFormatting.whitespaceAfterSeparator` - Causes whitespace to be |
| 85 | + inserted around separator characters like `;` and `,` |
| 86 | +- `powershell.codeFormatting.ignoreOneLineBlock` - Single-line expressions, like |
| 87 | + small if/else statements, will not be expanded to multiple lines. |
| 88 | + |
| 89 | +We've also made many improvements to the performance and stability of the formatter. |
| 90 | + |
| 91 | +#### Debugging improvements |
| 92 | + |
| 93 | +We've added a new configuration for debugging your Pester tests. By default it |
| 94 | +merely runs `Invoke-Pester` at the workspace path, but you can also edit the |
| 95 | +configuation to add additional arguments to be passed through. |
| 96 | + |
| 97 | +We've also added support for column breakpoints. Now you can set a breakpoint |
| 98 | +directly within a pipeline by placing your cursor at any column on a line and |
| 99 | +running the `Debug: Column Breakpoint` command: |
| 100 | + |
| 101 | + |
| 102 | + |
| 103 | +For the latest PowerShell Core release ([6.0.0-alpha.17](https://github.com/PowerShell/PowerShell/releases/tag/v6.0.0-alpha.17)), |
| 104 | +we have also added the ability to step into ScriptBlocks that are executed on another |
| 105 | +machine using `Invoke-Command -Computer`. |
| 106 | + |
| 107 | +Set a breakpoint on an `Invoke-Command` line and then once it's hit: |
| 108 | + |
| 109 | + |
| 110 | + |
| 111 | +Press `F11` and you will step into the ScriptBlock. You can now continue to use |
| 112 | +"step in" and trace the ScriptBlock's execution on the remote machine: |
| 113 | + |
| 114 | + |
| 115 | + |
| 116 | +Note that you cannot currently set breakpoints in the script listing file as |
| 117 | +this code is being executed without an actual script file on the remote machine. |
| 118 | + |
| 119 | +#### Other fixes and improvements |
| 120 | + |
| 121 | +- Fixed [#427](https://github.com/PowerShell/vscode-powershell/issues/427) - |
| 122 | + The keybinding for "Expand Alias" command has been changed to <kbd>Shift+Alt+E</kbd> |
| 123 | +- Fixed [#519](https://github.com/PowerShell/vscode-powershell/issues/519) - |
| 124 | + Debugger hangs after continuing when watch expressions are set |
| 125 | +- Fixed [#448](https://github.com/PowerShell/vscode-powershell/issues/448) - |
| 126 | + Code formatter should keep indentation for multi-line pipelines |
| 127 | +- Fixed [#518](https://github.com/PowerShell/vscode-powershell/issues/518) - |
| 128 | + Code formatter fails when dollar-paren `$()` expressions are used |
| 129 | +- Fixed [#447](https://github.com/PowerShell/vscode-powershell/issues/447) - |
| 130 | + Code formatter crashes when run on untitled documents |
| 131 | + |
3 | 132 | ## 0.9.0
|
4 | 133 | ### Thursday, January 19, 2017
|
5 | 134 |
|
|
0 commit comments