Запускает Windows PowerShell из командной строки или другого средства, например из программы Cmd.exe.
Синтаксис
PowerShell[.exe]
[-PSConsoleFile <file> | -Version <version>]
[-EncodedCommand <Base64EncodedCommand>]
[-ExecutionPolicy <ExecutionPolicy>]
[-File <filePath> <args>]
[-InputFormat {Text | XML}]
[-NoExit]
[-NoLogo]
[-NonInteractive]
[-NoProfile]
[-OutputFormat {Text | XML}]
[-Sta]
[-WindowStyle <style>]
[-Command { - | <script-block> [-args <arg-array>]
| <string> [<CommandParameters>] } ]
PowerShell[.exe] -Help | -? | /?
Параметры
-EncodedCommand
Принимает команду в виде закодированной base-64 строки. Используйте этот параметр для передачи в Windows PowerShell команд, где требуются сложные кавычки или круглые скобки.
-ExecutionPolicy
Задает политику выполнения по умолчанию для текущего сеанса. Этот параметр не меняет политику выполнения Windows PowerShell, указанную в реестре.
-File
Выполняет указанный скрипт. Введите путь к файлу скрипта и любые параметры.
-InputFormat
Описывает формат данных, отправляемых в Windows PowerShell. Допустимые значения: Text (текстовые строки), XML (сериализованный формат CLIXML).
-NoExit
Не происходит выход после выполнения команд запуска.
-NoLogo
При запуске баннер с уведомлением об авторском праве скрывается.
-NonInteractive
Не выдается интерактивный запрос пользователю.
-NoProfile
Профиль Windows PowerShell не загружается.
-OutputFormat
Определяет форматирование выходных данных Windows PowerShell. Допустимые значения: Text (текстовые строки), XML (сериализованный формат CLIXML).
-PSConsoleFile
Загружается указанный файл консоли Windows PowerShell. Для создания файла консоли используйте командлет Export-Console в Windows PowerShell.
-Sta
Оболочка запускается в режиме однопотокового подразделения.
-Version
Запускается заданная версия Windows PowerShell. Введите номер версии с этим параметром, например "-version 1.0".
-WindowStyle
Позволяет задать стиль окна (Normal, Minimized, Maximized или Hidden).
-Command
Позволяет выполнить указанные команды (с любыми параметрами), как если бы они были введены в командной строке Windows PowerShell, и завершает выполнение, если не задан параметр NoExit. Значением параметра Command может быть "-", строка или блок скрипта.
Если параметр Command имеет значение "-", текст команды считывается из стандартного ввода.
Блок скрипта должен быть заключен в фигурные скобки ({}). Блок скрипта можно задать, только если PowerShell.exe выполняется в Windows PowerShell. Результаты работы скрипта возвращаются в родительскую оболочку в виде десериализованных объектов XML, а не активных объектов.
Если значением параметра Command является строка, то параметр Command должен быть последним параметром команды, так как любые символы, введенные после этого параметра, интерпретируются как аргументы команды.
Для записи строки, выполняющей команду Windows PowerShell, используйте следующий формат:
"& {<command>}"
где кавычки обозначают строку, а оператор вызова (&) приводит к выполнению команды.
-Help, -?, /?
Выводит это сообщение. При вводе команды PowerShell.exe в Windows PowerShell параметрам должен предшествовать символ дефис (-), а не косая черта (/). В программе Cmd.exe можно использовать как дефис, так и косую черту.
ПРИМЕРЫ
PowerShell -PSConsoleFile sqlsnapin.psc1
PowerShell -version 1.0 -NoLogo -InputFormat text -OutputFormat XML
PowerShell -Command {Get-EventLog -LogName security}
PowerShell -Command "& {Get-EventLog -LogName security}"
# To use the -EncodedCommand parameter:
$command = "dir 'c:\program files' "
$bytes = [System.Text.Encoding]::Unicode.GetBytes($command)
$encodedCommand = [Convert]::ToBase64String($bytes)
powershell.exe -encodedCommand $encodedCommand