Бөлісу құралы:

служебная программа sqlps

Относится к:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsАналитическая платформа (PDW)SQL база данных в Microsoft Fabric

Служебная программа sqlps запускает сеанс Windows PowerShell с поставщиком SQL Server PowerShell и загруженными и зарегистрированными командлетами. Можно вводить команды или скрипты PowerShell, в которых используются компоненты SQL Server PowerShell для работы с экземплярами SQL Server и их объектами.

Внимание

Эта функция будет удалена в будущей версии SQL Server. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Вместо этого используйте модуль PowerShell sqlps . Дополнительные сведения о модуле sqlps см. в разделе Import the SQLPS Module.

Синтаксис

sqlps
[ [ [ -NoLogo ] [ -NoExit ] [ -NoProfile ]
    [ -OutPutFormat { Text | XML } ] [ -InPutFormat { Text | XML } ]
  ]
  [ -Command { -
             | script_block [ -args argument_array ]
             | string [ command_parameters ]
             }
  ]
]
[ -? | -Help ]

Аргументы

Указывает, что служебная программа sqlps не должна отображать баннер со сведениями об авторских правах при запуске.

-NoExit

Указывает, что служебная программа sqlps должна продолжать выполняться после выполнения команд запуска.

-NoProfile

Указывает служебной программе sqlps не загружать профиль пользователя. В профилях пользователей записываются часто используемые псевдонимы, функции и переменные для использования в различных сеансах PowerShell.

-OutPutFormat { Text | XML }

Указывает, что выходные данные служебной программы sqlps форматируются как текстовые строки (текст) или в сериализованном формате CLIXML (XML).

-InPutFormat { Text | XML }

Указывает, что входные данные служебной программы sqlps отформатированы в виде текстовых строк (Text) либо представлены в сериализованном формате CLIXML (XML).

-Команда

Указывает команду для выполнения служебной программой sqlps . Служебная программа sqlps запускает команду, а затем завершает работу, если -NoExit не указана. Не указывайте другие параметры после -Command. Они считываются как параметры команды.

-

-Command- указывает, что программа sqlps считывает входные данные из стандартного входного данных.

блок_скрипта [ -argsмассив_аргументов ]

Указывает блок команд PowerShell для выполнения, который должен быть заключен в фигурные скобки: {}. Параметрблок_скрипта можно указывать только в случае вызова служебной программы sqlps из PowerShell или другого сеанса служебной программы sqlps . Параметр массив_аргументов представляет собой массив переменных PowerShell, содержащий аргументы для команд PowerShell из параметра блок_скрипта.

string [ параметры_команды ]

Указывает строку, содержащую команды PowerShell для запуска. Используйте формат "{<command>}". Кавычки указывают строку, а оператор вызова (&) вызывает служебную программу sqlps для выполнения команды (<command>).

[ -? | -Помощь ]

Показывает синтаксис параметров служебной программы sqlps .

Замечания

Программа sqlps запускает среду PowerShell (PowerShell.exe) и загружает модуль SQL Server PowerShell. Модуль, также именуемый sqlps, загружает и регистрирует эти плагин SQL Server PowerShell.

  • Microsoft.SqlServer.Management.PSProvider.dll

    Реализует поставщик SQL Server PowerShell и связанные с ним командлеты, такие как Encode-SqlName и Decode-SqlName.

  • Microsoft.SqlServer.Management.PSSnapin.dll

    Реализует командлеты Invoke-Sqlcmd и Invoke-PolicyEvaluation .

Служебную программу sqlps можно использовать для выполнения следующих задач:

  • Вводить команды PowerShell в интерактивном режиме.

  • Запускать файлы скриптов PowerShell.

  • Выполнять командлеты SQL Server.

  • Используйте пути поставщика SQL Server для перехода по иерархии объектов SQL Server.

По умолчанию служебная программа sqlps запускается с политикой выполнения сценариев со значением Ограничено. Это предотвращает запуск любых скриптов PowerShell. Командлет Set-ExecutionPolicy обеспечивает возможность запуска как подписанных, так и любых других скриптов. Запускать следует только скрипты из надежных источников, а также рекомендуется защитить все входные и выходные файлы соответствующими разрешениями NTFS. Дополнительные сведения о включении скриптов PowerShell см. в разделе Запуск скриптов Windows PowerShell.

Версия служебной программы sqlps в SQL Server 2008 (10.0.x) и SQL Server 2008 R2 (10.50.x) была реализована в виде мини-оболочки Windows PowerShell 1.0. Мини-оболочки имеют определенные ограничения, например, не позволяя пользователям загружать оснастки, отличные от оснастки, загруженные мини-оболочкой. Эти ограничения не применяются к SQL Server 2012 (11.x) и более поздним версиям программы, которые были изменены для использования модуля sqlps .

Примеры

sqlps -NoLogo

B. Запуск сценария SQL Server PowerShell из командной строки

sqlps -Command "&{.\MyFolder.MyScript.ps1}"

В. Запуск сценария SQL Server PowerShell из командной строки с продолжением выполнения после завершения сценария

sqlps -NoExit -Command "&{.\MyFolder.MyScript.ps1}"

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

  • Last updated on