安装  PowerShell 模块

本文提供安装 SqlServer PowerShell 模块的指导。

适用于 SQL Server 的 PowerShell 模块

提供两种 SQL Server PowerShell 模块：

• SqlServer：SqlServer 模块包括新的 cmdlet，用于支持最新的 SQL 功能。 该模块还包含 SQLPS 中 cmdlet 的更新版本。 若要下载 SqlServer 模块，请在 PowerShell 库中转到 SqlServer 模块。

• SQLPS：SQLPS 是 SQL 代理使用 PowerShell 子系统在代理作业步骤中运行代理作业时所使用的模块。

 备注

PowerShell 库中这些版本的 SqlServer 模块支持版本控制并且要求 PowerShell 5.1 或更高版本。

有关帮助主题，请转到：

• SqlServer cmdlet。
• SQLPS cmdlets。

SQL Server Management Studio

SQL Server Management Studio (SSMS) 不会安装任何 PowerShell 模块。 要在 SSMS 中使用 PowerShell，则必须从 PowerShell 库安装 SqlServer 模块。

 备注

SQL Server Management Studio (SSMS) 16.x（及更早版本）包含 SQLPS 模块。

Azure Data Studio

Azure Data Studio 不会安装任何一个 PowerShell 模块。 若要将 PowerShell 与 Azure Data Studio 一起使用，请从 PowerShell 库安装 SqlServer 模块。

可以使用 PowerShell 扩展，此扩展在 Azure Data Studio 中提供丰富的 PowerShell 编辑器支持。

安装或更新 SqlServer 模块

若要从 PowerShell 库安装 SqlServer 模块，请启用 PowerShell 会话并运行 Install-Module SQLServer。

PowerShell复制

Install-Module -Name SqlServer

如果在 Windows PowerShell 上运行，则可以使用 Install-Module SQLServer -Scope CurrentUser 为当前用户安装模块，避免需要提升的权限。

为所有用户安装 SqlServer 模块

若要为所有用户安装 SqlServer 模块，请在提升的 PowerShell 会话中运行以下命令；以管理员身份启动 PowerShell 会话：

PowerShell复制

Install-Module -Name SqlServer

将 SqlServer 模块安装到脱机计算机

本部分将指导你完成在无法访问 Internet 的计算机上安装 SqlServer PowerShell 模块的步骤。 需要两台计算机才能完成此安装：一台计算机连接到 Internet，目标计算机则保持脱机状态（未连接 Internet）。

1. 在连接到 Internet 的计算机上，下载 SQLServer PowerShell 模块。 此命令将下载该模块的所有文件并将这些文件保存在示例 $env:TEMP\SQLServer\<SomeVersion> 文件夹中，-Path 参数中定义了该文件夹。 你可以根据自己的偏好选择一个文件夹作为连接 Internet 的计算机上的目标。

   PowerShell复制

   Save-Module -Name SqlServer -Path $env:TEMP
   

2. 在文件资源管理器中浏览至该文件夹位置，验证 $env:TEMP\SQLServer\<SomeVersion> 文件夹是否存在或运行以下命令：

   PowerShell复制

   Get-ChildItem -Path $env:TEMP\SQLServer\
   

3. 将步骤 2 中找到的 $env:TEMP\SQLServer\<SomeVersion> 文件夹复制到 %ProgramFiles%\WindowsPowerShell\Modules\SqlServer 文件夹（此文件夹对于 PS5 和 PS7 均适用）中的目标脱机计算机。 请务必将 <SomeVersion> 替换为在上一步中找到的值。

4. 通过运行以下 PowerShell cmdlet，确认 SqlServer PowerShell 模块在脱机计算机上可用：

   PowerShell复制

   Get-Module SqlServer -ListAvailable
   

   输出可能如下所示（实际版本可能不同，并且必须与前面列出的 <SomeVersion> 匹配）：

   控制台复制

      PS C:\Users\user1> Get-Module SqlServer -ListAvailable
   
          Directory: C:\Program Files\WindowsPowerShell\Modules
   
      ModuleType Version    Name                     ExportedCommands
      ---------- -------    ----                     ----------------
      Script     22.1.1     SqlServer                {Add-RoleMember, Add-SqlAvail...