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


Программа sqlps

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

Синтаксис

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

Аргументы

  • -NoLogo
    Указывает программе sqlps скрывать при запуске баннер со сведениями об авторских правах.

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

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

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

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

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

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

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

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

  • [ -? | -Help ]
    Показывает сводку с синтаксисом параметров программы sqlps.

Замечания

Программа sqlps запускает среду PowerShell (PowerShell.exe) с загруженными и зарегистрированными оснастками SQL Server PowerShell. Существуют следующие оснастки SQL Server PowerShell.

  • Microsoft.SqlServer.Management.PSProvider.dll

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

  • Microsoft.SqlServer.Management.PSSnapin.dll

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

С помощью программы sqlps можно делать следующее.

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

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

  • Запускать командлеты служб SQL Server.

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

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

Примеры

А. Запуск программы sqlps в режиме по умолчанию (интерактивном) без баннера со сведениями об авторских правах

sqlps -NoLogo

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

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

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

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