Программа sqlps

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

Это важно

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

Синтаксис

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

Аргументы

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

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

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

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

-InPutFormat { Text | XML }
Указывает, что входные данные в sqlps программу форматируются как текстовые строки (текст) или в сериализованном формате CLIXML (XML).

-Команда
Указывает команду для запуска служебной sqlps программы. Программа sqlps запускает команду, а затем завершает работу, если не указан параметр -NoExit . После параметра -Commandне следует указывать какие-либо иные параметры, так как они будут интерпретироваться как параметры команды.

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

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

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

[ -? | -Помощь ]
Отображает сводку синтаксиса параметров служебной 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 и SQL Server 2008 R2 была реализована в виде мини-оболочки Windows PowerShell 1.0. Мини-оболочки имеют определенные ограничения, такие как запрет на загрузку пользователями других оснасток, помимо загруженных мини-оболочкой. Эти ограничения не применяются к sql Server 2012 и более поздним версиям служебной программы, которые были изменены для использования sqlps модуля.

Примеры

sqlps -NoLogo

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

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

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

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

См. также

Включение или отключение сетевого протокола сервера
SQL Server PowerShell

Last updated on 2017-03-08