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

Применимо к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure Azure Synapse Analytics AnalyticsPlatform System (PDW)

Эта статья содержит инструкции по установке модуля SqlServer PowerShell.

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

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

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

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

Примечание.

Версии модуля SqlServer в коллекции PowerShell поддерживают управление версиями и требуют PowerShell 5.1 или более поздней версии.

Разделы справки можно найти здесь:

Среда SQL Server Management Studio

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

Примечание.

SQL Server Management Studio (SSMS) 16.x (и более ранних версий) включал модуль SQLPS .

Azure Data Studio

Azure Data Studio не устанавливает ни один из модулей PowerShell. Для работы PowerShell с Azure Data Studio установите модуль SqlServer из коллекции PowerShell.

Можно использовать расширение PowerShell, которое обеспечивает полноценную поддержку редактора 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 с повышенными правами, запущенном от имени администратора:

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

Примечание.

PowerShell всегда использует последний установленный модуль.

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

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

Update-Module -Name SqlServer -AllowClobber

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

Однако если вы не хотите хранить старые версии модулей, можно использовать 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

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

Важно!

Их можно найти и установить с помощью обновленных командлетов Find-Module и Install-Module, которые входят в модуль PowerShellGet, передав параметр -AllowPrerelease. Чтобы использовать эти командлеты, установите модуль PowerShellGet, а затем откройте новый сеанс.

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

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

Find-Module SqlServer -AllowPrerelease

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

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

Используйте для этого следующую команду:

Install-Module SqlServer -RequiredVersion 21.1.18218-preview -AllowPrerelease

SQL Server PowerShell в Linux

Установка SQL Server PowerShell на Linux показана в статье Управление SQL Server на Linux с помощью PowerShell.

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

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

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

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

Следующие шаги