执行 PowerShell 脚本时遇到的各种错误及解决方法

.\myscript.ps1 : 无法加载文件 .\myscript.ps1，因为在此系统上禁止运行脚本。
有关详细信息，请参阅 https:/go.microsoft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。
所在位置 行:1 字符: 1
+ .\myscript.ps1
+ ~~~~~~~~~~~~~~~
    + CategoryInfo          : SecurityError: (:) []，PSSecurityException
    + FullyQualifiedErrorId : UnauthorizedAccess

Get-ExecutionPolicy
# 输出通常是 Restricted

Unblock-File -Path .\downloaded-script.ps1

C:\Program : 无法将"C:\Program"项识别为 cmdlet、函数、脚本文件或可运行程序的名称。
所在位置 行:1 字符: 1
+ C:\Program Files\MyTool\script.ps1
+ ~~~~~~~~~~
    + CategoryInfo          : ObjectNotFound: (C:\Program:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

# ❌ 错误写法
C:\Program Files\MyTool\script.ps1

# ✅ 正确写法之一：使用调用运算符 &
& "C:\Program Files\MyTool\script.ps1"

# ✅ 正确写法之二：使用引号包裹并调用
. "C:\Program Files\MyTool\script.ps1"

# ✅ 正确写法之三：使用 Invoke-Expression（注意安全风险）
Invoke-Expression "C:\Program Files\MyTool\script.ps1"

# ✅ 正确写法之四：Tab 补全（PowerShell 会自动加引号和 &）
# 输入 C:\Prog 然后按 Tab

# 现象：脚本中的中文字符显示为乱码或导致语法错误
所在位置 行:5 字符: 15
+ Write-Host "鏂囦欢宸插垹闄?  # 原本应该是"文件已删除"
字符串缺少终止符: "。
    + CategoryInfo          : ParserError: (:) [], ParseException
    + FullyQualifiedErrorId : TerminatorExpectedAtEndOfString

# VS Code 底部状态栏点击编码 → 选择"通过编码保存" →
# 对于 PS 5.1：选择 "UTF-8 with BOM"
# 对于 PS 7： 选择 "UTF-8"

# 在 PowerShell 控制台中：
powershell -ExecutionPolicy Bypass -File .\script.ps1

# PS 5.1 中可以通过读取 UTF-8 文件来执行：
$script = Get-Content -Path ".\script.ps1" -Encoding UTF8 -Raw
Invoke-Expression $script

# 安装 PowerShell 7（推荐）
winget install Microsoft.PowerShell
# 之后用 pwsh.exe 代替 powershell.exe 执行脚本

Import-Module : 未加载指定的模块"Az"，因为在任何模块目录中都没有找到有效模块文件。
所在位置 行:1 字符: 1
+ Import-Module Az
+ ~~~~~~~~~~~~~~~~
    + CategoryInfo          : ResourceUnavailable: (Az:String) [Import-Module], FileNotFoundException
    + FullyQualifiedErrorId : Modules_ModuleNotFound,Microsoft.PowerShell.Commands.ImportModuleCommand

# 查看已安装的模块
Get-Module -ListAvailable

# 查看模块安装路径
$env:PSModulePath -split ';'

# 查看模块是否在仓库中
Find-Module -Name Az

# 查看模块依赖
Find-Module -Name Az | Select-Object -ExpandProperty Dependencies

# 在联网机器上下载模块（保存为 .nupkg）
Save-Module -Name Az -Path "D:\OfflineModules"

# 复制到离线机器后安装
Install-Module -Name Az -Repository "D:\OfflineModules"

New-Item : 拒绝访问路径"C:\Program Files\MyApp\config.json"。
所在位置 行:1 字符: 1
+ New-Item -Path "C:\Program Files\MyApp\config.json"
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : PermissionDenied: (C:\Program Files\MyApp\config.json:String) [New-Item], UnauthorizedAccessException
    + FullyQualifiedErrorId : ItemExistsUnauthorizedAccessError,Microsoft.PowerShell.Commands.NewItemCommand

# 检查当前是否以管理员身份运行
$isAdmin = ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator")
if (-not $isAdmin) {
    Write-Host "请以管理员身份重新运行此脚本" -ForegroundColor Red
}

# 检测并自动以管理员身份重新启动
if (-NOT ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator")) {
    $arguments = "-NoProfile -ExecutionPolicy Bypass -File `"$PSCommandPath`""
    Start-Process powershell.exe -Verb RunAs -ArgumentList $arguments
    exit
}

# 之后的代码将以管理员权限运行
Write-Host "当前以管理员身份运行" -ForegroundColor Green

.\script.ps1 : 文件 .\script.ps1 未经数字签名。无法在当前系统上运行该脚本。
    + CategoryInfo          : SecurityError: (:) [], PSSecurityException
    + FullyQualifiedErrorId : UnauthorizedAccess

# 1. 创建自签名证书
$cert = New-SelfSignedCertificate -Subject "CN=MyPowerShellScripts" `
    -Type CodeSigningCert `
    -CertStoreLocation "Cert:\CurrentUser\My"

# 2. 签名脚本
Set-AuthenticodeSignature -FilePath ".\script.ps1" -Certificate $cert

# 3. 验证签名
Get-AuthenticodeSignature -FilePath ".\script.ps1"
# Status 应为 Valid

# 4.（可选）将证书导出给其他机器信任
Export-Certificate -Cert $cert -FilePath ".\MyPSRoot.cer"

# 这段代码在 PS 7 中没问题，在 PS 5.1 中会报错
$result = Test-Path "C:\Windows" ? "存在" : "不存在"
# PS 5.1 错误：Unexpected token '?' in expression or statement.

$PSVersionTable.PSVersion
# 输出示例：Major  Minor  Build  Revision
#           -----  -----  -----  --------
#           5      1      19041  4291

# 条件判断替代三元运算符（兼容 PS 5.1）
if (Test-Path "C:\Windows") {
    $result = "存在"
} else {
    $result = "不存在"
}

# 使用 #requires 限制脚本运行环境
#requires -Version 7.0
# 如果版本不满足，脚本会直接中止并提示用户

# 动态检测版本并分支
if ($PSVersionTable.PSVersion.Major -ge 7) {
    # PS 7+ 代码路径
    $null = Test-Path "C:\Windows" ? $true : $false
} else {
    # PS 5.1 兼容代码
    $null = if (Test-Path "C:\Windows") { $true } else { $false }
}