Установка модуля 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 на компьютере, который не имеет доступа к Интернету. Для выполнения этой установки требуется два компьютера: компьютер, подключенный к Интернету, и целевой компьютер, который находится в автономном режиме (не подключен к Интернету).
На компьютере, подключенном к Интернету, скачайте модуль SQLServer PowerShell. Эта команда скачивает и сохраняет все файлы модуля в папке образца
$env:TEMP\SQLServer\<SomeVersion>
, которая определена в параметре -Path . Вы можете выбрать папку вашего предпочтения в качестве назначения на компьютере, подключенном к Интернету.Save-Module -Name SqlServer -Path $env:TEMP
Перейдите к расположению папки в проводник, чтобы убедиться, что
$env:TEMP\SQLServer\<SomeVersion>
папка существует или выполните следующую команду:Get-ChildItem -Path $env:TEMP\SQLServer\
Скопируйте папку
$env:TEMP\SQLServer\<SomeVersion>
, найденную на шаге 2, на конечный автономный компьютер в%ProgramFiles%\WindowsPowerShell\Modules\SqlServer
папке (эта папка будет работать как для PS5, так и ДЛЯ PS7). Обязательно замените<SomeVersion>
значением, найденным на предыдущем шаге.Убедитесь, что модуль 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.
Справочник по командлетам
Следующие шаги
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе:Отправить и просмотреть отзыв по