PowerShellEditorServices is the server and vscode-powershell is the client.Changelog | Visual Studio Marketplace
截至2022年最后一个版本的情况如下:
The extension should work anywhere VS Code itself and PowerShell Core 7.2 or higher is supported.
For Windows PowerShell, only version 5.1 is supported.
Please note that PowerShell Core 6 is end-of-life and so not supported
powershell Core 7.2以及之后的版本都支持
powershell corePS D:\repos\scripts> $PSVersionTable
Name Value
---- -----
PSVersion 5.1.22621.963
PSEdition Desktop
PSCompatibleVersions {1.0, 2.0, 3.0, 4.0...}
BuildVersion 10.0.22621.963
CLRVersion 4.0.30319.42000
WSManStackVersion 3.0
PSRemotingProtocolVersion 2.3
SerializationVersion 1.1.0.1
PS D:\repos\scripts> $psVersionTable
Name Value
---- -----
PSVersion 7.3.1
PSEdition Core
GitCommitId 7.3.1
OS Microsoft Windows 10.0.2…
Platform Win32NT
PSCompatibleVersions {1.0, 2.0, 3.0, 4.0…}
PSRemotingProtocolVersion 2.3
SerializationVersion 1.1.0.1
WSManStackVersion 3.0
powershell.powerShellAdditionalExePaths
例如,我要添加名为pwsh7.3,且可执行文件绝对路径为C:\Program Files\powershell\7\pwsh.exe
通常推荐使用gui进行配置
配置完,settings.json文件中的添加了如下内容
"powershell.powerShellAdditionalExePaths": {
"pwsh7.3": "C:\\Program Files\\powershell\\7\\pwsh.exe"
}
如果您的系统powershell版本不符合vscode powershell插件的支持
或者配置的非默认powershell 版本的路径设置出现问题
关于脚本 - PowerShell | Microsoft Docs
完整路径名+脚本名).\<程序名或脚本名>来执行某个脚本/程序查看本机powershell模块路径(环境变量值)
$env:PSModulePath -split ";"
PS C:\Users\cxxu> $env:PSModulePath -split ";"
D:\usersByCxxu\DocumentsAll\PowerShell\Modules
C:\Program Files\PowerShell\Modules
c:\program files\powershell\7\Modules
D:\program files\WindowsPowerShell\Modules
D:\repos\PwshLearn\modulesByCxxu
关于自动导入,实际体验验上是指,您可以直接在终端中引用(通过模块中的(公开的)函数名称来调用某个函数
这些模块只有在被放置在$env:psModulePath下,同时符合一定的目录层析要求,才可以达到效果
如果你的模块文件组织的合乎规范,那么在调用相应函数后,模块才会显示的被导入
gmo(get-module)查询到被导入的模块处理系统配置的几个模块自动导入目录,您还可以通过一定的语句实现psModulePath的自定义添加,如此一来,您的模块就不必要放置在那几个默认的目录下了.
# add $psPath:
#Save the current value in the $p variable.
$p = [Environment]::GetEnvironmentVariable("PSModulePath")
#Add the new path to the $p variable. Begin with a semi-colon separator.
$p += ";$env:repos\learnpwsh\modulesByCxxu\"
#Add the paths in $p to the PSModulePath value.
[Environment]::SetEnvironmentVariable("PSModulePath",$p)
不同path需要以; 分割
按照microsoft的说法,修改path之后需要做广播处理,如果是通过修改启动配置文件的方式添加,则不需要即时广播psmodulePath的变化
这是更直接的方式!
powershell中输入SystemPropertiesAdvanced.exe
psModulePathabout Comment Based Help - PowerShell | Microsoft Learn
函数 - PowerShell | Microsoft Docs
一种好的习惯是将基于注释的帮助文档添加到函数，以便你与之共享函数的人知道如何使用它们。
function Add-Extension
{
param
(
[string]
#Specifies the file name.
$name,
[string]
#Specifies the file name extension. "Txt" is the default.
$extension = 'txt'
)
$name = $name + '.' + $extension
$name
<#
.SYNOPSIS
Adds a file name extension to a supplied name.
.DESCRIPTION
Adds a file name extension to a supplied name. Takes any strings for the
file name or extension.
.INPUTS
None. You cannot pipe objects to Add-Extension.
.OUTPUTS
System.String. Add-Extension returns a string with the extension or
file name.
.EXAMPLE
PS> extension -name "File"
File.txt
.EXAMPLE
PS> extension -name "File" -extension "doc"
File.doc
.EXAMPLE
PS> extension "File" "doc"
File.doc
.LINK
http://www.fabrikam.com/extension.html
.LINK
Set-Item
#>
}
关于函数 - PowerShell | Microsoft Learn
about_Functions
about Functions Advanced Parameters - PowerShell | Microsoft Learn
关于 Functions 高级参数 - PowerShell | Microsoft Learn
参数属性
Parameter 属性用于声明函数参数的属性。
Parameter 属性是可选的，如果函数的任何参数都不需要属性，则可以省略它。
Parameter 属性具有用于定义参数特征的参数，
使用以下语法声明 Parameter 属性、参数和参数值。
将参数及其值括起来的括号必须跟在 参数 后面，且没有干预空格。
使用逗号分隔括号中的参数。 使用以下语法声明 Parameter 属性的两个参数。
Param(
[Parameter(Argument=value)]
$ParameterName
)
Param(
[Parameter(Argument1=value1,Argument2=value2)]
)
#Use commas to separate arguments within the parentheses.
#Use the following syntax to declare two arguments of the Parameter attribute.
The boolean argument types of the Parameter attribute default to False when omitted from the Parameter attribute.
Set the argument value to $true or just list the argument by name.
[parameter(..)]中的()可以包含多个parameter-attribute-argument参数,记为paa,这些参数都是可选的true/false ) ,这类paa记为bpaaFalseMandatory就属于bpaa,如果不写入括号,那么相当于写入Mandatory=$falseFor example, the following Parameter attributes are equivalent.
Param(
[Parameter(Mandatory=$true)]
)
# Boolean arguments can be defined using this shorthand syntax
Param(
[Parameter(Mandatory)]
)
Param(
[Parameter(Mandatory=$false)]
)
# Boolean arguments can be defined using this shorthand syntax
Param(
[Parameter()]
)
相关命令
export-alias导出别名配置文件new-alias新建别名(也可强制修改别名）set-alias修改别名（也可新建别名）allscope是通过option选项来指定的（而不是scope选项）
New-Alias testAllScopeAlias -Value desktop -Option AllScope将上述函数的调用（或者说函数名）写入到单独创建的启动配置文件中