Установка модуля 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 на компьютере, который не имеет доступа к Интернету. Для выполнения этой установки требуется два компьютера: компьютер, подключенный к Интернету, и автономный конечный компьютер (не подключенный к Интернету).
На компьютере, подключенном к Интернету, скачайте модуль 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
Предварительные версии (или "предварительная версия") модуля 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.
Справочник по командлетам
Связанный контент
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по