Поиск по сайту:

PowerShell: Использование справки (Get-Help)

Дон Джонс, автор книги «Научитесь PowerShell за месяц обедов», сказал:

«Будьте готовы читать справку, иначе вы потерпите неудачу в PowerShell.»

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

Загрузка справочного контента

Вы можете получить справку с помощью команды Get-Help. Это дает вам информацию о том, что справка доступна только онлайн. Но хорошая новость заключается в том, что вы можете скачать ее.

Get-Help

Чтобы использовать справку для Get-Childitem без ее загрузки, выполните

Get-Help Get-ChildItem -Online

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

Вернёмся к основной теме. Чтобы скачать, запустите справку.

Update-Help -UICulture "en-US" -Force

Обратите внимание, что вы можете запустить команду без -Force только один раз в день.

Используя справку

Get-Help предлагает широкий спектр параметров. Введите Get-Help, затем наберите - и удерживайте CTRL + SPACE, чтобы увидеть все из них.

Чтобы получить содержимое справки команды Get-Childitem, просто введите

Get-Help Get-ChildItem

или

Help Get-ChildItem

Это показывает небольшую версию справки. Для начинающих может быть разочаровывающе читать справку таким образом. Она не предлагает примеров и не содержит подробной информации о использовании команды. Давайте перейдем к параметру Пример, который более полезен для "обучения через практику".

Примеры

Примеры справки PowerShell действительно отличные и отлично подходят для первых шагов с PowerShell. Чтобы получить примеры для Get-ChildItem, выполните

Get-Help Get-ChildItem -Examples

и посмотрите пример 6 и пример 8

Скомбинируйте их, чтобы перечислить все текстовые файлы в текущем каталоге по имени.

Get-ChildItem . -Name -Include *.txt -Recurse -Force

Еще один пример показывает, как использовать атрибуты Powershell с Get-Date.

Help Get-Date -Online

Прокрутите окно браузера вниз до раздела примеров и найдите Пример 4.

Теперь вы можете начать играть. Например, вы можете изменить команду и заполнить свою дату рождения.

Совет: Введите (Get-Date). затем нажмите CTRL + SPACE. Удачи в исследовании атрибутов Get-Date

Примеры:

(Get-Date -Year 1976 -Month 03 -Date 23).IsDaylightSavingTime()
(Get-Date).AddDays(300)

или ищите пользователей, которые не входили в домен в течение года:

Get-ADUser -Filter * -Properties LastLogonDate | ? {$_.lastlogondate -ne $null -and $_.lastlogondate -le ((get-date).adddays(-365))} | Format-List Name,LastLogonDate

или поищите неактивные почтовые ящики:

Get-MailboxStatistics -server server01 | ? {$_.lastlogontime -ne $null -and $_.lastlogontime -le ((get-date).adddays(-365))} | Sort-Object {$_.lastlogontime}

Полная помощь

Чтобы получить полную помощь, выполните команду

Get-Help Get-Date -Full

Полная справка отображает целую тему справки. Это включает параметры, атрибуты и, наконец, примеры.

Подробная справка

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

Get-Help Get-Date -Detailed