Справка

После того как мы разобрались с методом поиска команд следует посмотреть каким образом по ним можно получить справку.

Получить справку по определенной команде можно введя команду:

Get-Help command_name

(Enter)

Можно воспользоваться звездочкой «*» и получить список команд с описание того что они выполняют.

Get-Help Get-*

Или запросить только список командлетов по маске *help*

Get-Command *help* -CommandType cmdlet

Так же в комплект поставки powershell входит подборка справочных файлов, содержащих обзоры различных концепций. Каждый файл концепции начинается с символов «about_» и заканчивается именем раздела. Для просмотра алфавитного списка разделов about запустите команду.

Get-Help about*

Чтобы просмотреть информацию по конкретной теме, необходимо просто включить в значение параметра полное имя темы. К примеру, для считывания файла об управлении потоками данных необходимо выполнить команду

Get-Help about_flow_control

Во встроенной системе помощи приведено очень много примеров того как можно использовать те или иные команды. Например приведенные ниже команды позволяют:

• Получить справку по запрашиваемой функции или командлету с примерами его использования (я предпочитаю этот вариант).

Get-Help Get-Process –Examples

• Запрашиваем полную справку по команде (если вариант -Examples не помог то читаю этот).

Get-Help Get-Process -Full

• Выводим описание команды и примеры использования.

Get-Help Get-Process -Detailed

При обилии выводимой на экран информации следует предпринять что то для просмотра полученного. Могу предложить два способа:

• Первый будет выводить на экран информацию по мере необходимости.

Get-Help Dir -full | more

• Второй выведет все в файл и вы сможете прочитать результат позже.

Get-Help Dir -full > dir-help.txt

notepad dir-help.txt

Создание простого скрипта для PowerShell

Скрипт на powershell является обычным текстовым файлом с расширением «.ps1» поэтому правой кнопкой мыши нажимаем «Создать» – «Текстовый документ», вводим имя файла, присваиваем ему расширение PS1, нажимаем Enter.

Примечание: По умолчанию, из соображений безопасности, при двойном клике он не запускается а открывается в текстовом редакторе. Проверьте снята ли у вас галка «Скрывать расширения у зарегистрированных файлов».

Если указанная выше опция не установлена то создание скриптов доступно прямо из окна проводника (вы можете менять расширение на нужное).

Если указанная опция включена то вам придется менять расширение файла любым доступным методом, например из командной строки или из файлового менеджера.

Практика

Создайте в папке C:\TEMP скрипт 1.ps1 со следующим содержимым

Write-Host "Hello!"

Запустите powershell (Win+R, вводим powershell.exe и нажимаем enter), перейдите с папку командой cd C:\TEMP и попробуйте запустить скрипт командой .\1.ps1

В результате powershell ответит ошибкой.

PS C:\temp> .\1.ps1 File C:\temp\1.ps1 cannot be loaded because the execution of scripts is disabled on this system. Please see «get-help about_signing» for more details. At line:1 char:8 + .\1.ps1 <<<< + CategoryInfo : NotSpecified: (:) [], PSSecurityException + FullyQualifiedErrorId : RuntimeException

Подобное поведение связано с тем что в настройках по умолчанию, считается что только команды могут выполняться интерактивно, а выполнение скриптов запрещено.

Естественно, в случае необходимости уровень выполнения политики (по умолчанию установлен Restricted) можно изменить.