从 Windows PowerShell 5.1 迁移到 PowerShell 7

---

PowerShell 7 专为云、本地和混合环境而设计，包含增强功能和新功能。

• 与 Windows PowerShell 并行安装和运行
• 改进了与现有 Windows PowerShell 模块的兼容性
• 新的语言功能，例如三元运算符和 ForEach-Object -Parallel
• 提高性能
• 基于 SSH 的远程处理
• 跨平台互操作性
• 对 Docker 容器的支持

PowerShell 7 与 Windows PowerShell 并行工作，让您可以在部署之前轻松测试和比较版本。迁移简单、快速且安全。

以下 Windows 操作系统支持 PowerShell 7：

• Windows 10 和 11
• Windows Server 2016、2019 和 2022

PowerShell 7 还可以在 macOS 和多个 Linux 发行版上运行。有关支持的操作系统的列表以及有关支持生命周期的信息，请参阅 PowerShell 支持生命周期。

安装PowerShell 7

为了灵活性并支持 IT、DevOps 工程师和开发人员的需求，有多种选项可用于安装 PowerShell 7。在大多数情况下，安装选项可简化为以下方法：

• 使用 MSI 包部署 PowerShell
• 使用 ZIP 包部署 PowerShell

笔记

可以使用 Microsoft Configuration Manager 等管理产品来部署和更新 MSI 包。从 GitHub 发布页面下载软件包。

部署 MSI 包需要管理员权限。 ZIP 包可以由任何用户部署。 ZIP 包是在进行完整安装之前安装 PowerShell 7 进行测试的最简单方法。

您还可以通过 Windows 应用商店或 winget 安装 PowerShell 7。有关这两种方法的更多信息，请参阅在 Windows 上安装 PowerShell 中的详细说明。

将 PowerShell 7 与 Windows PowerShell 5.1 并行使用

PowerShell 7 旨在与 Windows PowerShell 5.1 共存。以下功能可确保您在 PowerShell 上的投资受到保护，并且您可以轻松迁移到 PowerShell 7。

• 单独的安装路径和可执行文件名称
• 单独的 PSModulePath
• 每个版本都有单独的配置文件
• 改进的模块兼容性
• 新的远程处理端点
• 集团政策支持
• 单独的事件日志

.NET 版本之间的差异

PowerShell 7.2 基于 .NET 6.0 构建。 Windows PowerShell 5.1 基于 .NET Framework 4.x 构建。 .NET 版本之间的差异可能会影响脚本的行为，特别是当您直接调用 .NET 方法时。有关详细信息，请参阅 Windows PowerShell 5.1 和 PowerShell 7.x 之间的差异。

单独的安装路径和可执行文件名称

PowerShell 7 安装到新目录，从而能够与 Windows PowerShell 5.1 并行执行。

按版本安装位置：

• Windows PowerShell 5.1：$env:WINDIR\System32\WindowsPowerShell\v1.0
• PowerShell 6.x：$env:ProgramFiles\PowerShell
• PowerShell 7：$env:ProgramFiles\PowerShell

新位置将添加到您的 PATH，允许您运行 Windows PowerShell 5.1 和 PowerShell 7。如果您要从 PowerShell 6.x 迁移到 PowerShell 7，则 PowerShell 6 将被删除并替换 PATH。

在 Windows PowerShell 中，PowerShell 可执行文件名为 powershell.exe。在版本 6 及更高版本中，可执行文件名为 pwsh.exe。新名称可以轻松支持两个版本的并行执行。

单独的 PSModulePath

默认情况下，Windows PowerShell 和 PowerShell 7 将模块存储在不同的位置。 PowerShell 7 将这些位置组合到 $Env:PSModulePath 环境变量中。按名称导入模块时，PowerShell 会检查 $Env:PSModulePath 指定的位置。这允许 PowerShell 7 加载 Core 和 Desktop 模块。

Install Scope Windows PowerShell 5.1 PowerShell 7.0 PowerShell modules $env:WINDIR\system32\WindowsPowerShell\v1.0\Modules $env:ProgramFiles\PowerShell\Modules User installed
AllUsers scope $env:ProgramFiles\WindowsPowerShell\Modules $env:ProgramFiles\PowerShell\Modules User installed
CurrentUser scope $HOME\Documents\WindowsPowerShell\Modules $HOME\Documents\PowerShell\Modules

以下示例显示每个版本的 $Env:PSModulePath 的默认值。

• 对于 Windows PowerShell 5.1：

  $Env:PSModulePath -split (';')
  

  C:\Users\<user>\Documents\WindowsPowerShell\Modules
  C:\Program Files\WindowsPowerShell\Modules
  C:\WINDOWS\System32\WindowsPowerShell\v1.0\Modules
  

• 对于 PowerShell 7：

  $Env:PSModulePath -split (';')
  

  C:\Users\<user>\Documents\PowerShell\Modules
  C:\Program Files\PowerShell\Modules
  C:\Program Files\PowerShell\Modules
  C:\Program Files\WindowsPowerShell\Modules
  C:\WINDOWS\System32\WindowsPowerShell\v1.0\Modules
  

请注意，PowerShell 7 包括 Windows PowerShell 路径和用于提供模块自动加载的 PowerShell 7 路径。

笔记

如果您更改了 PSModulePath 环境变量或安装了自定义模块或应用程序，则可能存在其他路径。

有关详细信息，请参阅 about_PSModulePath。

有关模块的更多信息，请参阅 about_Modules。

单独的配置文件

PowerShell 配置文件是在 PowerShell 启动时执行的脚本。此脚本通过添加命令、别名、函数、变量、模块和 PowerShell 驱动器来自定义您的环境。配置文件脚本使这些自定义在每个会话中可用，而无需手动重新创建它们。

配置文件位置的路径在 PowerShell 7 中已更改。

• 在 Windows PowerShell 5.1 中，配置文件的位置为 $HOME\Documents\WindowsPowerShell。
• 在 PowerShell 7 中，配置文件的位置为 $HOME\Documents\PowerShell。

配置文件文件名也发生了变化：

$PROFILE | Select-Object *Host* | Format-List

 AllUsersAllHosts       : C:\Program Files\PowerShell\profile.ps1
 AllUsersCurrentHost    : C:\Program Files\PowerShell\Microsoft.PowerShell_profile.ps1
 CurrentUserAllHosts    : C:\Users\<user>\Documents\PowerShell\profile.ps1
 CurrentUserCurrentHost : C:\Users\<user>\Documents\PowerShell\Microsoft.PowerShell_profile.ps1

有关_Profiles 的更多信息。

PowerShell 7 与 Windows PowerShell 5.1 模块的兼容性

Windows PowerShell 5.1 中使用的大多数模块已可与 PowerShell 7 配合使用，包括 Azure PowerShell 和 Active Directory。我们正在继续与其他团队合作，为更多模块（包括 Microsoft Graph、Office 365 等）添加本机 PowerShell 7 支持。有关受支持模块的当前列表，请参阅 PowerShell 7 模块兼容性。

笔记

在 Windows 上，我们还在 Import-Module 中添加了 UseWindowsPowerShell 开关，以便使用不兼容模块的用户可以轻松过渡到 PowerShell 7。有关此功能的详细信息，请参阅 about_Windows_PowerShell_Compatibility。

PowerShell 远程处理

PowerShell 远程处理允许您在一台或多台远程计算机上运行任何 PowerShell 命令。您可以在远程计算机上建立持久连接、启动交互式会话以及运行脚本。

WS-管理远程处理

Windows PowerShell 5.1 及更低版本使用 WS-Management (WSMAN) 协议进行连接协商和数据传输。 Windows 远程管理 (WinRM) 使用 WSMAN 协议。如果已启用 WinRM，PowerShell 7 将使用名为 Microsoft.PowerShell 的现有 Windows PowerShell 5.1 端点进行远程连接。要更新 PowerShell 7 以包含其自己的端点，请运行 Enable-PSRemoting cmdlet。有关连接到特定端点的信息，请参阅 PowerShell 中的 WS-Management Remoting

要使用 Windows PowerShell 远程处理，必须将远程计算机配置为进行远程管理。有关详细信息（包括说明），请参阅关于远程要求。

有关使用远程处理的更多信息，请参阅关于远程

基于 SSH 的远程处理

PowerShell 6.x 中添加了基于 SSH 的远程处理，以支持无法使用 Windows 本机组件（例如 WinRM）的其他操作系统。 SSH 远程处理在目标计算机上创建一个 PowerShell 主机进程作为 SSH 子系统。有关在 Windows 或 Linux 上设置基于 SSH 的远程处理的详细信息和示例，请参阅：通过 SSH 的 PowerShell 远程处理。

笔记

PowerShell Gallery (PSGallery) 包含一个模块和 cmdlet，可自动配置基于 SSH 的远程处理。从 PSGallery 安装 Microsoft.PowerShell.RemotingTools 模块并运行 Enable-SSH cmdlet。

New-PSSession、Enter-PSSession 和 Invoke-Command cmdlet 具有新的参数集来支持 SSH 连接。

[-HostName <string>]  [-UserName <string>]  [-KeyFilePath <string>]

要创建远程会话，请使用 HostName 参数指定目标计算机，并使用 UserName 提供用户名。以交互方式运行 cmdlet 时，系统会提示您输入密码。

Enter-PSSession -HostName <Computer> -UserName <Username>

或者，当使用 HostName 参数时，请提供用户名信息，后跟 at 符号 (@)，然后提供计算机名称。

Enter-PSSession -HostName <Username>@<Computer>

您可以使用带有 KeyFilePath 参数的私钥文件来设置 SSH 密钥身份验证。有关更多信息，请参阅 OpenSSH 密钥管理。

支持组策略

PowerShell 包含组策略设置，可帮助您为企业环境中的服务器定义一致的选项值。这些设置包括：

• 控制台会话配置：设置运行 PowerShell 的配置端点。
• 打开模块日志记录：设置模块的 LogPipelineExecutionDetails 属性。
• 打开 PowerShell 脚本块日志记录：启用所有 PowerShell 脚本的详细日志记录。
• 打开脚本执行：设置 PowerShell 执行策略。
• 打开 PowerShell 转录：允许将 PowerShell 命令的输入和输出捕获为基于文本的转录本。
• 设置 Update-Help 的默认源路径：将可更新帮助的源设置为目录，而不是 Internet。

有关详细信息，请参阅 about_Group_Policy_Settings。

PowerShell 7 包括组策略模板和 $PSHOME 中的安装脚本。

组策略工具使用管理模板文件（.admx、.adml）在用户界面中填充策略设置。这允许管理员管理基于注册表的策略设置。 InstallPSCorePolicyDefinitions.ps1 脚本在本地计算机上安装 PowerShell 管理模板。

Get-ChildItem -Path $PSHOME -Filter *Core*Policy*

    Directory: C:\Program Files\PowerShell

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           2/27/2020 12:38 AM          15861 InstallPSCorePolicyDefinitions.ps1
-a---           2/27/2020 12:28 AM           9675 PowerShellCoreExecutionPolicy.adml
-a---           2/27/2020 12:28 AM           6201 PowerShellCoreExecutionPolicy.admx

单独的事件日志

Windows PowerShell 和 PowerShell 7 将事件记录到单独的事件日志中。使用以下命令获取 PowerShell 日志列表。

Get-WinEvent -ListLog *PowerShell*

有关详细信息，请参阅 about_Logging_Windows。

改进了 Visual Studio Code 的编辑体验

具有 PowerShell 扩展的 Visual Studio Code (VSCode) 是 PowerShell 7 支持的脚本环境。Windows PowerShell 集成脚本环境 (ISE) 仅支持 Windows PowerShell。

更新后的 PowerShell 扩展包括：

• 新的 ISE 兼容模式
• 集成控制台中的 PSReadLine，包括语法突出显示、多行编辑和向后搜索
• 稳定性和性能改进
• 新的 CodeLens 集成
• 改进的路径自动完成

为了更轻松地过渡到 Visual Studio Code，请使用命令面板中提供的启用 ISE 模式功能。此函数将 VSCode 切换为 ISE 风格的布局。 ISE 风格的布局为您提供了 PowerShell 的所有新特性和功能，并提供熟悉的用户体验。

要切换到新的 ISE 布局，请按 Ctrl+Shift+P 打开命令面板，输入 PowerShell 并选择PowerShell：启用 ISE 模式。

要将布局设置为原始布局，请打开命令面板，选择PowerShell：禁用 ISE 模式（恢复为默认值）。

有关将 VSCode 布局自定义到 ISE 的详细信息，请参阅如何在 Visual Studio Code 中复制 ISE 体验

笔记

没有计划使用新功能更新 ISE。在最新版本的 Windows 10 或 Windows Server 2019 及更高版本中，ISE 现在是用户可卸载的功能。目前还没有永久删除 ISE 的计划。 PowerShell 团队及其合作伙伴致力于改善 Visual Studio Code 的 PowerShell 扩展中的脚本编写体验。

下一步

掌握了有效迁移的知识，立即安装 PowerShell 7！