Установка модуля SQL Server PowerShell

В этой статье приведены инструкции по установке модуля SqlServer PowerShell.

Модули PowerShell для SQL Server

Существует два модуля SQL Server PowerShell:

• SqlServer: модуль SqlServer включает новые командлеты для поддержки последних функций SQL. Модуль также содержит обновленные версии командлетов в SQLPS. Чтобы скачать модуль SqlServer, перейдите к модулю SqlServer в коллекции PowerShell.

• SQLPS: SQLPS — это модуль, используемый агентом SQL для запуска заданий агента в шагах задания агента с помощью подсистемы PowerShell.

Дополнительные статьи см. в следующих статьях:

• Командлеты SqlServer.
• Командлеты SQLPS.

SQL Server Management Studio (SSMS)

SQL Server Management Studio (SSMS) не устанавливает ни один модуль PowerShell. Чтобы использовать PowerShell с SSMS, установите модуль SqlServer из коллекции PowerShell.

Azure Data Studio

Azure Data Studio не устанавливает ни модуль PowerShell. Чтобы использовать PowerShell с Azure Data Studio, установите модуль SqlServer из коллекции PowerShell.

Вы можете использовать поддержку редактора PowerShell для Azure Data Studio, которая обеспечивает многофункциональную поддержку редактора PowerShell в Azure Data Studio.

Установка или обновление модуля SqlServer

Чтобы установить модуль SqlServer из коллекции PowerShell, запустите сеанс PowerShell и запустите его Install-Module SQLServer.

Install-Module -Name SqlServer

При запуске в Windows PowerShell можно установить Install-Module SQLServer -Scope CurrentUser модуль для текущего пользователя и избежать необходимости в повышенных разрешениях.

Установка модуля SqlServer для всех пользователей

Чтобы установить модуль SqlServer для всех пользователей, выполните следующую команду в сеансе PowerShell с повышенными привилегиями; запустите сеанс PowerShell от имени администратора:

Install-Module -Name SqlServer

Установка модуля SqlServer на автономный компьютер

В этом разделе описано, как установить модуль SqlServer PowerShell на компьютере без доступа к Интернету. Для выполнения этой установки требуется два компьютера: компьютер, подключенный к Интернету и автономный конечный компьютер.

1. На компьютере, подключенном к Интернету, скачайте модуль SQLServer PowerShell. Эта команда скачивает и сохраняет все файлы модуля в образце $env:TEMP\SQLServer\<SomeVersion> папки, определенной в параметре -Path . Вы можете выбрать папку вашего предпочтения в качестве назначения на компьютере, подключенном к Интернету.

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

2. Перейдите к расположению папки в проводнике, чтобы убедиться, что $env:TEMP\SQLServer\<SomeVersion> папка существует или выполните следующую команду:

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

3. Скопируйте папку $env:TEMP\SQLServer\<SomeVersion> , найденную на шаге 2, на конечный автономный компьютер в %ProgramFiles%\WindowsPowerShell\Modules\SqlServer папке (эта папка будет работать как для PS5, так и ДЛЯ PS7). Обязательно замените <SomeVersion> значением, найденным на предыдущем шаге.

4. Убедитесь, что модуль 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...
   

Просмотр версий установленного модуля SqlServer

Выполните следующую команду, чтобы просмотреть установленные версии модуля SqlServer.

Get-Module SqlServer -ListAvailable

Просмотр версии модуля SqlServer, загруженного в текущем сеансе

(Get-Module SqlServer).Version

Перезапись предыдущей версии модуля SqlServer

Вы также можете использовать Install-Module команду для перезаписи предыдущей версии.

Install-Module -Name SqlServer -AllowClobber

Обновление установленной версии модуля SqlServer

Когда доступны обновленные версии модуля SqlServer , можно установить более новую версию с помощью следующей команды:

Update-Module -Name SqlServer -AllowClobber

Чтобы установить последнюю версию модуля SQLServer PowerShell, можно использовать Update-Module команду, но она не удаляет старые версии. Он устанавливает более новые версии параллельно, чтобы позволить экспериментировать с последней версией, а также устанавливать старые модули.

Однако если вы не хотите хранить старые версии модулей, можно использовать Uninstall-Module команду для удаления предыдущих версий.

Для перечисления нескольких версий можно использовать следующую команду:

Get-Module SqlServer -ListAvailable

Для удаления старых версий можно использовать следующую команду:

Uninstall-module -Name SQLServer -RequiredVersion "<version number>"

Устранение неполадок

Если возникли проблемы с установкой, ознакомьтесь с документацией поInstall-Module и Install-Module справочником.

Использование определенной версии модуля SqlServer

Чтобы использовать определенную версию модуля, импортируйте его с определенным номером версии, аналогичным следующей команде:

Import-Module SqlServer -Version 21.1.18218

Предварительные версии модуля SqlServer

Предварительная версия (или предварительная версия) модуля SqlServer может быть доступна в коллекции PowerShell.

Обнаружение предварительных версий модуля SqlServer

Чтобы обнаружить предварительные версии модуля SqlServer, выполните следующую команду:

Find-Module SqlServer -AllowPrerelease

Установка определенной предварительной версии модуля SqlServer

Чтобы установить определенную предварительную версию модуля, установите ее с определенным номером версии.

Вы можете попробовать использовать следующую команду:

Install-Module SqlServer -RequiredVersion 21.1.18218-preview -AllowPrerelease

SQL Server PowerShell в Linux

Ознакомьтесь с разделом /sql/linux/sql-server-manage-powershell-core, чтобы узнать, как установить SQL Server PowerShell на Linux.

Прочие модули

• Az.Sql — командлеты службы SQL для Azure Resource Manager в Windows PowerShell и PowerShell.

• SqlServerDsc — модуль с ресурсами DSC для развертывания и настройки Microsoft SQL Server.

Справочник по командлетам

• Командлеты SqlServer
• Командлеты SQLPS

Связанный контент

• SQL Server PowerShell
• Командлеты SQL Server PowerShell
• Поддержка редактора PowerShell для Azure Data Studio