Как обновить справку PowerShell, за минуту

Как обновить справку PowerShell, за минуту

Powershell logoДобрый день! Уважаемые читатели и гости IT портала Pyatilistnik.org. В предыдущем знакомстве с PowerShell, мы его обновили до версии 5.1. Все это хорошо и мы получили огромное количество новых командлетов, но есть один нюанс, у вас может быть не обновлена справка PowerShell. Делать, это нужно, чтобы всегда иметь под рукой свежую документацию с примерами и изменениями, к сожалению она сама не обновляется. В данной заметке мы это научимся делать.

Обновить справку можно несколькими методами:

  • Онлайн из интернета
  • И оффлайн, когда выхода в интернет нет, и нужно воспользоваться выгруженным заранее модулем

Если доступ в интернет на компьютере есть, то откройте PowerShell от имени администратора и введите команду:

Update-Help

У вас начнется скачивание свежей справки для каждого встроенного модуля.

обновление справки PowerShell 5.1

Если у вас есть нестандартные модули, вроде тех, что мы добавляли при поиске ID сеанса пользователя(/how-to-determine-the-user-id-and-session-number-on-rds/), то на них справка может не обновиться и вы получите ошибку:

Update-Help : Не удалось обновить справку для одного или нескольких модулей "WinSCP" с культурами пользовательского интерфейса {ru-RU}: Не удалось подключиться к содержимому справки. Возможно, сервер, на котором оно хранится, недоступен. Убедитесь, что он доступен, или дождитесь его подключения к сети и выполните команду еще раз.

Как обновить справку PowerShell-02

Если по какой-то причине у вас на рабочей станции, где требуется обновить справку PowerShell, нет выхода в интернет, то я предлагаю вам создать на компьютере с интернетом, автономную, локальную копию, в виде выгрузки XML пакетов со справкой. В оснастке PowerShell, открытой обязательно от имени администратора введите команду:

Save-Help -DestinationPath E:\Help -Module * -Force

Убедитесь, что путь куда будут заливаться ваши файлы есть.

Выгрузка справки PowerShell

В результате у вас скачается порядка 200 файлов cab и XML. Каждый соответствует своему командлету.

Как обновить справку PowerShell-04

Далее вы копируете эту папку или подключаетесь к ней по сети, тут не важно. На сервере или компьютере без интернета, открываем PowerShell и применяем команду, единственное укажите ваш путь.

Update-Help -SourcePath C:\Temp\Help -Module * -Force

В тоге вы получаете самую свежую информацию по командам. Напоминаю, что так же можно посмотреть Online справку в PowerShell, для этого выполните:

Get-Help Format-Table -Online

Подробнее про справку можете почитать на Microsoft (https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/get-help?view=powershell-6).

В некоторых случаях, обновить справку можно и через Proxy, выполните код:

$wc = New-Object System.Net.WebClient
$wc.Proxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials
update-help -force

или вот такая конструкция


$c = Get-Credential
$web = New-Object System.Net.WebClient
$web.Proxy.Credentials = $c
update-help -force

На этом я думаю все, остались вопросы, жду их в комментариях. С вами был Иван Семин, автор и создатель IT блога Pyatilistnik.org.

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *