Программа sqlps

Синтаксис

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}"

См. также

Задания

Другие ресурсы