Поделиться через

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

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

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

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

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

Замечание

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

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

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

Замечание

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

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

SQL Server Management Studio (SSMS)

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

Замечание

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

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

Замечание

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

Обновление установленной версии модуля 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.

Это важно

Эти версии могут быть обнаружены и установлены с помощью обновленных 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/linux/sql-server-manage-powershell-core, чтобы узнать, как установить SQL Server PowerShell на Linux.

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

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

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

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

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

  • Last updated on