基础设置

终端脚本限制

具体执行策略参考微软 官方文档,主要有这几种:AllSigned, Bypass, Default, RemoteSigned, Restricted, Undefined, Unrestricted

1
2
3
4
5
6
7
8
$PSVersionTable.PSVersion # 查询版本
# 获取当前计算机脚本的执行策略
Get-ExecutionPolicy -List
# 更改执行策略
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
# 删除执行策略可将对应策略设置为 undefined
choco install <package> --install-arguments="/installpath=C:\MyPath"

模块

作用域

powershell 启动时会默认加载一个脚本,脚本会有一个作用域(Scope)区分,不同作用域下的脚本存放在不同的位置,可以通过在 powershell 中输入以下命令进行查询 $PROFILE | Select-Object *Host* | Format-List

加载路径

修改环境变量 PSModulePath 以添加自己编写的模块路径

基础命令

  • 查看当前已有的脚本模块函数: Get-Module -ListAvailable
  • 导入模块: Import-Module -Name ModuleName
  • 创建模块描述文件: New-ModuleManifest -Path .\ModuleDemo1.psd1

示例

  • 创建软连接
1
2
3
4
5
6
7
8
$targetDir="D:\BaiduSyncdisk\preference\vscode\" $linkDir="C:\Users\ivan\AppData\Roaming\Code\User\snippets\" $linkFiles="c.json","cpp.json","latex.json"
foreach($linkFile in $linkFiles){
New-Item -ItemType SymbolicLink -Value $($targetDir+$linkFile) -Path $($linkDir+$linkFile)
}
#New-Item -ItemType SymbolicLink -Value D:\BaiduSyncdisk\preference\vscode\c.json -Path .\c.json

# -------- 为文件夹创建软连接 ----------------#
New-Item -ItemType SymbolicLink -Path $linkPath -Target $sourceFolder
  • 设置别名
1
2
3
4
5
6
7
8
9
10
11
$OutputEncoding = [console]::InputEncoding = [console]::OutputEncoding = New-Object System.Text.UTF8Encoding
function mxproxy {
$env:http_proxy = "127.0.0.1:9537"
$env:https_proxy = "127.0.0.1:9537"
Write-Host "代理设置完成"
}
function unproxy{
$env:https_proxy=""
$env:http_proxy=""
Write-Host "代理已清空"
}

命令解析与 PATH

PowerShell 可以查看某个命令最终解析到的文件,也可以列出 PATH 中的全部同名程序:

1
2
3
4
Get-Command ssh -All
Get-Command rsync -All
where.exe ssh
where.exe rsync

where 在 PowerShell 中通常是 Where-Object 的别名,因此查找可执行文件时应明确调用 where.exe。

对 $env:Path 的修改只影响当前 PowerShell 进程及其后续创建的子进程,不会回写系统配置:

1
2
$programBin = 'D:\Software\Example\bin'
$env:Path = "$programBin;$env:Path"

读取持久化的用户级和系统级 PATH:

1
2
[Environment]::GetEnvironmentVariable('Path', 'User') -split ';'
[Environment]::GetEnvironmentVariable('Path', 'Machine') -split ';'

已经启动的终端和图形程序通常不会自动获取后续修改的环境变量;新进程还可能继续继承长期运行的父进程环境。可重启最上层启动程序,或在当前会话中显式刷新或临时调整 PATH。

Wrapper 脚本

包装脚本可以在不污染父进程环境的情况下,为某个程序准备 PATH、参数和退出码:

1
2
3
$env:Path = "$PSScriptRoot\bin;$env:Path"
& "$PSScriptRoot\bin\program.exe" @args
exit $LASTEXITCODE
  • $PSScriptRoot 表示当前脚本所在目录。
  • @args 将调用包装脚本时收到的参数原样转发。
  • & 是调用运算符,可执行变量或带路径的命令。
  • $LASTEXITCODE 是最近一个原生程序的退出码,应传递给上层自动化程序。

这类脚本适合让一个程序使用同目录的 DLL、SSH 或其他配套工具,同时保留系统中的默认同名命令。Scoop 的 pre_install 可以在安装阶段生成此类脚本

文件所有者与 ACL

Get-Acl 用于读取文件或目录的所有者和访问控制列表:

1
2
3
$targetPath = 'C:\Path\To\File'
Get-Acl -LiteralPath $targetPath |
Format-List Owner, AccessToString, AreAccessRulesProtected

Windows 自带的 icacls.exe 可用于设置所有者、显式权限和继承状态:

1
2
3
4
5
6
$targetPath = 'C:\Path\To\File'
$currentUser = [System.Security.Principal.WindowsIdentity]::GetCurrent().Name

icacls.exe $targetPath /setowner $currentUser
icacls.exe $targetPath /grant:r "${currentUser}:(F)"
icacls.exe $targetPath /inheritance:r
  • /setowner 将所有者设为指定账户。
  • /grant:r 用新的显式授权替换该账户已有的显式授权。
  • (F) 表示完全控制;只需读取时应采用更小的权限。
  • /inheritance:r 禁用继承并移除已有的继承权限。

warning: >调整 ACL 前应先记录原权限并确认目标路径。移除继承可能同时移除管理员、SYSTEM 或备份程序所需的访问权,不宜对宽泛目录递归执行。SSH 配置和私钥通常要求归当前用户所有,且不能被其他用户写入。

问题

环境变量刷新问题

在从一个进程打开其他应用程序时默认是继承的这个程序的进程资源 (环境变量,系统资源等等)

此时被打开的程序不会直接从系统去更新环境变量,而仅仅是从主进程继承,故我们在使用 Rolan 这样的便捷打开程序时如果不让 Rolan 重启,而只是关闭掉如 Vscode 这样的子进程,再从 Rolan 重启时,此时 Vscode 的环境变量并未得到更新,因为 Rolan 并未重启,获得的变量仍为Rolan 上次启动时获得的变量,在 powershell 中提供了 refreshenv 命令来读取系统环境变量,要调用执行脚本 (要关闭终端脚本执行限制):

1
2
3
4
5
6
7
8
# 更改执行策略
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
# 引入执行脚本
Import-Module $env:ChocolateyInstall\helpers\chocolateyProfile.psm1
# 刷新环境变量
refreshenv
# 也可直接
Update-SessionEnvironment

更新问题

问题复述:

problem: update-help : 无法更新带有 UI 区域性 {zh-CN} 的模块“DefenderPerformance, Dism, Get-NetView, HostNetworkingService, Kds, NetQos, PcsvDevice, Pester, PKI, StorageBusCache, VMDirectStorage, Whea, WindowsUpdate”帮助: 在 HelpInfo XML 文件中检索不到 UI 区域性 zh-CN。确保模块清单中的 HelpInfoUri 属性有效或检查网络连接是否正常,然后重试该命令

解决办法:上面的问题的原因是当前操作系统的语言集为中文,如果语言为英文,则没有上面的问题。这是因为 PowerShell 某些命令的在线文档地址错误,用以下命令行忽略即可:

1
Update-Help -ErrorAction SilentlyContinue

中文乱码

修改对应的 powershell 脚本,在命令行中输入 code $Profile 进行修改,在打开的文件中输入如下代码

1
$OutputEncoding = [console]::InputEncoding = [console]::OutputEncoding = New-Object System.Text.UTF8Encoding

管道符号

  • & 前面的语句为假则直接执行后面的,都会执行一下
  • && 前面的语句为假则直接出错,后面也不执行
  • | 直接执行后面的语句。只执行后面的
  • || 前面出错执行后面的,前面没问题则只执行前面的

代理

1
2
$env:https_proxy = "127.0.0.1:9537"
$env:http_proxy = "127.0.0.1:9537"