Запускает 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



Содержание