Установка модуля 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.

Примечание.

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

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

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

Примечание.

В контексте модулей SqlServer и SQLPS имена команд могут существовать в обоих модулях.

Это может создать конфликт, когда один модуль уже установлен, а другой устанавливается или обновляется. Чтобы предотвратить этот конфликт, параметр -AllowClobber можно использовать при установке или обновлении модуля. Кроме того, при импорте одного модуля необходимо сначала удалить другой модуль или использовать параметр -DisableNameChecking, чтобы предотвратить ошибку. Эти меры гарантируют, что модули могут сосуществовать без каких-либо проблем.

Среда 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

Предварительные версии (или "предварительная версия") модуля 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 см. в этой статье.

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

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

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

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

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