Get-Help
Отображает сведения о командах и концепциях PowerShell.
Синтаксис
Get-Help
[[-Name] <String>]
[-Path <String>]
[-Category <String[]>]
[-Full]
[-Component <String[]>]
[-Functionality <String[]>]
[-Role <String[]>]
[<CommonParameters>]Get-Help
[[-Name] <String>]
[-Path <String>]
[-Category <String[]>]
-Detailed
[-Component <String[]>]
[-Functionality <String[]>]
[-Role <String[]>]
[<CommonParameters>]Get-Help
[[-Name] <String>]
[-Path <String>]
[-Category <String[]>]
-Examples
[-Component <String[]>]
[-Functionality <String[]>]
[-Role <String[]>]
[<CommonParameters>]Get-Help
[[-Name] <String>]
[-Path <String>]
[-Category <String[]>]
-Parameter <String[]>
[-Component <String[]>]
[-Functionality <String[]>]
[-Role <String[]>]
[<CommonParameters>]Get-Help
[[-Name] <String>]
[-Path <String>]
[-Category <String[]>]
[-Component <String[]>]
[-Functionality <String[]>]
[-Role <String[]>]
-Online
[<CommonParameters>]Get-Help
[[-Name] <String>]
[-Path <String>]
[-Category <String[]>]
[-Component <String[]>]
[-Functionality <String[]>]
[-Role <String[]>]
-ShowWindow
[<CommonParameters>]Описание
Командлет Get-Help отображает сведения о концепциях и командах PowerShell, включая командлеты, функции, команды Common Information Model (CIM), рабочие процессы, поставщики, псевдонимы и скрипты.
Чтобы получить справку для командлета PowerShell, введите Get-Help имя командлета, например: Get-Help Get-Process
Основные статьи справки в PowerShell начинаются с about_, например about_Comparison_Operators. Чтобы просмотреть все about_ статьи, введите Get-Help about_*. Чтобы просмотреть определенную статью, введите Get-Help about_<article-name>, например Get-Help about_Comparison_Operators.
Чтобы получить справку для поставщика PowerShell, введите Get-Help имя поставщика. Например, чтобы получить справку для поставщика сертификатов, введите Get-Help Certificate.
Вы также можете ввести help или manотобразить один экран текста одновременно. Или, это идентичноGet-Help, <cmdlet-name> -?но работает только для командлетов.
Get-Help получает содержимое справки, отображаемое из файлов справки на компьютере. Без файлов Get-Help справки отображаются только основные сведения о командлетах. Некоторые модули PowerShell включают файлы справки. Начиная с PowerShell 3.0, модули, которые входят в операционную систему Windows, не включают файлы справки. Чтобы скачать или обновить файлы справки для модуля в PowerShell 3.0, используйте Update-Help командлет.
Вы также можете просмотреть документы справки PowerShell в Интернете. Чтобы получить веб-версию файла справки, используйте параметр Online, например: Get-Help Get-Process -Online
Если вы вводите Get-Help точное имя статьи справки или слово, уникальное для статьи справки, Get-Help отображает содержимое статьи. Если указать точное имя псевдонима команды, Get-Help отобразится справка для исходной команды. Если ввести слово или шаблон слова, отображаемый в нескольких заголовках статьи справки, Get-Help отобразится список соответствующих названий. Если ввести текст, который не отображается в заголовках статей справки, Get-Help отобразится список статей, которые включают этот текст в их содержимое.
Get-Help можно получить справочные статьи для всех поддерживаемых языков и языковых стандартов. Get-Help Сначала ищет файлы справки в языковом стандарте Windows, а затем в родительском языковом стандарте, например pt для pt-BR, а затем в резервном языковом стандарте. Начиная с PowerShell 3.0, если Get-Help не найти справку в резервном языковом стандарте, он ищет статьи справки на английском языке, en-US, прежде чем он возвращает сообщение об ошибке или отображает автоматическую справку.
Сведения о символах, Get-Help отображаемых на схеме синтаксиса команд, см. в about_Command_Syntax. Сведения об атрибутах параметров, таких как "Обязательный" и "Позиция", см. в about_Parameters.
Примечание.
В PowerShell 3.0 и PowerShell 4.0 Get-Help не удается найти статьи в модулях, если модуль не импортируется в текущий сеанс. Чтобы получить статьи о модулях, импортируйте модуль с помощью Import-Module командлета или выполнив командлет, включенный в модуль.
Начиная с PSReadLine версии 2.2.2 модуль поставляется с двумя функциями, которые обеспечивают быстрый доступ к помощи при вводе команды в командной строке. Справка отображается в терминале в альтернативном буфере экрана с разбиением по страницам.
При нажатии клавиши F1 функция PSReadLineShowCommandHelp вызывает Get-Help -Full имя командлета, ближайшее к левой части курсора. Когда курсор сразу же находится слева от параметра, функция переходит к описанию этого параметра в разделе полной справки. При нажатии Q для выхода из представления справки возвращается в командную строку в той же позиции курсора, чтобы продолжить ввод команды.
При использовании сочетания клавиш Alt+h функция PSReadLineShowParameterHelp отображает сведения о справке для параметра сразу слева от курсора. Текст справки отображается под командной строкой. Это позволяет просмотреть описание параметра и продолжить ввод команды.
Дополнительные сведения см. в разделе "Использование динамической справки".
Примеры
Пример 1. Отображение основных сведений о справке о командлете
В этих примерах отображаются основные сведения о командлете Format-Table .
Get-Help Format-Table
Get-Help -Name Format-Table
Format-Table -?Get-Help <cmdlet-name> — это самый простой и стандартный синтаксис командлета Get-Help . Параметр Name можно опустить.
Синтаксис <cmdlet-name> -? работает только для командлетов.
Пример 2. Отображение основных сведений на одной странице за раз
В этих примерах отображаются основные справочные сведения о командлете Format-Table по одной странице за раз.
help Format-Table
man Format-Table
Get-Help Format-Table | Out-Host -Paginghelp — это функция, которая выполняет Get-Help командлет внутри системы и отображает результат на одной странице одновременно.
man — это псевдоним функции help .
Get-Help Format-Table отправляет объект вниз конвейера. Out-Host -Paging получает выходные данные из конвейера и отображает его одну страницу за раз. Дополнительные сведения см. в разделе "Out-Host".
Пример 3. Отображение дополнительных сведений для командлета
В этих примерах отображаются более подробные сведения о командлете Format-Table .
Get-Help Format-Table -Detailed
Get-Help Format-Table -FullПодробный параметр отображает подробное представление статьи справки, включающее описания параметров и примеры.
Полный параметр отображает полное представление статьи справки, включающее описания параметров, примеры, типы входных и выходных объектов и дополнительные заметки.
Подробныеи полные параметры эффективны только для команд, которые имеют файлы справки, установленные на компьютере. Параметры не эффективны для статей справки по концептуальной (about_).
Пример 4. Отображение выбранных частей командлета с помощью параметров
В этих примерах отображаются выбранные части справки командлета Format-Table .
Get-Help Format-Table -Examples
Get-Help Format-Table -Parameter *
Get-Help Format-Table -Parameter GroupByПараметр Examples отображает разделы NAME и SYNOPSIS файла справки и все примеры. Невозможно указать номер примера, так как параметр Examples является параметром switch.
Параметр параметра отображает только описания указанных параметров. Если указать только символ звездочки (*) дикий карта, он отображает описания всех параметров.
Если параметр задает имя параметра, например GroupBy, отображаются сведения об этом параметре.
Эти параметры не эффективны для статей справки по концептуальной (about_).
Пример 5. Отображение веб-версии справки
В этом примере отображается интерактивная версия справки для командлета Format-Table в веб-браузере по умолчанию.
Get-Help Format-Table -OnlineПример 6. Отображение справки о системе справки
Командлет Get-Help без параметров отображает сведения о системе справки PowerShell.
Get-HelpПример 7. Отображение доступных статей справки
В этом примере отображается список всех статей справки, доступных на компьютере.
Get-Help *Пример 8. Отображение списка концептуальных статей
В этом примере отображается список концептуальных статей, включенных в справку PowerShell. Все эти статьи начинаются с символов about_. Чтобы отобразить определенный файл справки, введите Get-Help \<about_article-name\>, например Get-Help about_Signing.
Отображаются только концептуальные статьи с файлами справки, установленными на компьютере. Сведения о скачивании и установке файлов справки в PowerShell 3.0 см. в разделе Update-Help.
Get-Help about_*Пример 9. Поиск слова в справке командлета
В этом примере показано, как найти слово в статье справки по командлету.
Get-Help Add-Member -Full | Out-String -Stream | Select-String -Pattern Clixml
the Export-Clixml cmdlet to save the instance of the object, including the additional members...
can use the Import-Clixml cmdlet to re-create the instance of the object from the information...
Export-Clixml
Import-ClixmlGet-Helpиспользует полный параметр для получения сведений о Add-Memberсправке. Объект MamlCommandHelpInfo отправляется по конвейеру. Out-Stringиспользует параметр Stream для преобразования объекта в строку. Select-Stringиспользует параметр Pattern для поиска строки для Clixml.
Пример 10. Отображение списка статей, включающих слово
В этом примере отображается список статей, включающих удаленное взаимодействие с словом.
При вводе слова, которое не отображается в заголовке статьи, Get-Help отображается список статей, включающих это слово.
Get-Help -Name remoting
Name Category Module Synopsis
---- -------- ------ --------
Install-PowerShellRemoting.ps1 External Install-PowerShellRemoting.ps1
Disable-PSRemoting Cmdlet Microsoft.PowerShell.Core Prevents remote users...
Enable-PSRemoting Cmdlet Microsoft.PowerShell.Core Configures the computer...Пример 11. Справка для конкретного поставщика
В этом примере показаны два способа получения справки Get-Itemдля конкретного поставщика. Эти команды помогают в использовании Get-Item командлета в узле DataCollection поставщика SQLShell.
В первом примере используется Get-Helpпараметр Path для указания пути поставщика SQL Server.
Так как указан путь поставщика, можно выполнить команду из любого расположения пути.
Второй пример используется Set-Location для перехода к пути поставщика SQL Server. В этом расположении параметр Path не требуется для Get-Help получения справки для конкретного поставщика.
Get-Help Get-Item -Path SQLSERVER:\DataCollection
NAME
Get-Item
SYNOPSIS
Gets a collection of Server objects for the local computer and any computers
to which you have made a SQL Server PowerShell connection.
...
Set-Location SQLSERVER:\DataCollection
SQLSERVER:\DataCollection> Get-Help Get-Item
NAME
Get-Item
SYNOPSIS
Gets a collection of Server objects for the local computer and any computers
to which you have made a SQL Server PowerShell connection.
...Пример 12. Отображение справки по скрипту
В этом примере показано, как помочь MyScript.ps1 script. Сведения о том, как написать справку по функциям и сценариям, см. в about_Comment_Based_Help.
Get-Help -Name C:\PS-Test\MyScript.ps1Параметры
-Category
Выводит справку только для элементов, относящихся к указанной категории, и их псевдонимы. Концептуальные статьи находятся в категории HelpFile .
Допустимые значения для этого параметра приведены следующим образом:
- Псевдоним
- Командлет
- Provider
- Общие
- Вопросы и ответы
- Глоссарий
- HelpFile
- ScriptCommand
- Function
- Фильтр
- ExternalScript
- Все
- DefaultHelp
- Рабочий процесс
- DscResource
- Класс
- Настройка
| Type: | String[] |
| Accepted values: | Alias, Cmdlet, Provider, General, FAQ, Glossary, HelpFile, ScriptCommand, Function, Filter, ExternalScript, All, DefaultHelp, Workflow, DscResource, Class, Configuration |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Component
Отображает команды с указанным значением компонента, например Exchange. Введите название компонента. Можно использовать подстановочные знаки. Этот параметр не влияет на отображение концептуальной справки (About_).
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Detailed
Добавляет описания параметров и и примеры к основным справочным сведениям. Этот параметр действует только при установке файлов справки на компьютере. Он не влияет на отображение концептуальной (About_) справки.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Examples
Выводит только имя, краткий обзор и параметры. Этот параметр действует только при установке файлов справки на компьютере. Он не влияет на отображение концептуальной (About_) справки.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Full
Отображает всю статью справки для командлета. Полный включает описания параметров и атрибуты, примеры, типы входных и выходных объектов и дополнительные заметки.
Этот параметр действует только при установке файлов справки на компьютере. Он не влияет на отображение концептуальной (About_) справки.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Functionality
Выводит справку по элементам с указанными функциями. Введите функцию. Можно использовать подстановочные знаки. Этот параметр не влияет на отображение концептуальной справки (About_).
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Name
Возвращает справку по указанной команде или понятию. Введите имя командлета, функции, поставщика, скрипта или рабочего процесса, например Get-Member, концептуальное имя статьи, например about_Objectsпсевдоним или lsпсевдоним. Дикие карта символы разрешены в именах командлетов и поставщиков, но вы не можете использовать дикие символы карта для поиска имен справки по функциям и статей справки по скрипту.
Чтобы получить справку по скрипту, который не находится в пути, указанном в $env:Path переменной среды, введите путь к скрипту и имя файла.
Если ввести точное имя статьи справки, Get-Help отобразится содержимое статьи.
Если ввести слово или шаблон слова, отображаемый в нескольких заголовках статьи справки, Get-Help отобразится список соответствующих названий.
Если ввести текст, который не соответствует заголовкам статей справки, Get-Help отобразится список статей, которые включают этот текст в их содержимое.
Имена концептуальных статей, например about_Objects, должны быть введены на английском языке, даже в версиях PowerShell, отличных от английского языка.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-Online
Отображает веб-версию статьи справки в браузере по умолчанию. Этот параметр действителен только для статей справки по командлетам, функциям, рабочим процессам и скриптам. Невозможно использовать параметр Online в Get-Help удаленном сеансе.
Сведения о поддержке этой функции в статьях справки, которые вы пишете, см. в статьях about_Comment_Based_Help и поддержке справки по сети и написанию справки по командлетам PowerShell.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Parameter
Выводит только подробное описание указанных параметров. Разрешено использовать подстановочные знаки. Этот параметр не влияет на отображение концептуальной справки (About_).
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Path
Возвращает справку с описанием того, как командлет работает по указанному пути к поставщику. Введите путь поставщика PowerShell.
Этот параметр получает настраиваемую версию справки командлета, которая объясняет, как командлет работает в указанном пути поставщика PowerShell. Этот параметр действует только для справки о командлете поставщика и только если поставщик включает пользовательскую версию справки командлета поставщика в файле справки. Для использования этого параметра установите файл справки для модуля, включающего поставщик.
Чтобы просмотреть справку по пользовательскому командлету для пути поставщика, перейдите в расположение пути поставщика и введите Get-Help команду или в любом расположении пути используйте параметр Path для Get-Help указания пути поставщика. Вы также можете найти справку по пользовательским командлетам в интернете в разделе справки поставщика статей справки.
Дополнительные сведения о поставщиках PowerShell см. в about_Providers.
Примечание.
Поставщик для указанного пути должен установить файл справки поставщика PowerShell. Если файл справки поставщика недоступен, информация о справке не возвращается. Файлы справки поставщика недоступны для поставщиков, включенных в эту версию PowerShell.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Role
Выводит справку, настроенную для указанной роли пользователя. Введите роль. Можно использовать подстановочные знаки.
Введите роль, которую пользователь имеет в организации. Для некоторых командлетов в файлах справки содержится разный текст в зависимости от значения этого параметра. Этот параметр не влияет на справку по основным командлетам.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-ShowWindow
Выводит раздел справки в окне для более удобного чтения. Окно включает функцию поиска поиска и поле Параметры, позволяющее задать параметры для отображения, включая параметры для отображения только выбранных разделов справки.
Параметр ShowWindow поддерживает разделы справки для команд (командлетов, функций, команд CIM, скриптов) и концептуальных статей о статьях. Он не поддерживает справку поставщика.
Этот параметр был повторно введен в PowerShell 7.0. Этот параметр доступен только в Windows.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Входные данные
None
Невозможно передать объекты в этот командлет.
Выходные данные
ExtendedCmdletHelpInfo
Если вы выполняете Get-Help команду, у которой нет файла справки, Get-Help возвращает объект ExtendedCmdletHelpInfo, представляющий автоматическую справку.
Если вы получите концептуальную статью справки, Get-Help возвращает ее в виде строки.
MamlCommandHelpInfo
Если вы получите команду с файлом справки, Get-Help возвращает объект MamlCommandHelpInfo .
Примечания
PowerShell 3.0 не включает файлы справки. Чтобы скачать и установить файлы справки, которые Get-Help считываются, используйте Update-Help командлет. Командлет можно использовать Update-Help для скачивания и установки файлов справки для основных команд, которые входят в PowerShell и для всех установленных модулей. С его помощью можно также обновлять файлы справки на компьютере, чтобы они всегда были актуальны.
Вы также можете ознакомиться со статьями справки о командах, которые входят в PowerShell в Интернете, начиная с начала работы с Windows PowerShell.
Get-Help отображает справку в языковом стандарте для операционной системы Windows или на резервном языке для этого языкового стандарта. Если у вас нет файлов справки для основного или резервного языкового стандарта, ведет себя так, Get-Help как если на компьютере нет файлов справки. Чтобы получить справку по другому языковому стандарту, используйте регион и язык в панель управления для изменения параметров. В Windows 10 или более поздней версии Параметры, время и язык.
Полное представление справки содержит таблицу сведений о параметрах. В таблице содержатся указанные ниже поля.
Необходимые. Показывает, является ли параметр необходимым (true) или необязательным (false).
Позиция. Указывает, является ли параметр именованным или позициальным (числовым). Позиционные параметры должны появляться в указанном месте команды.
Имя указывает, что имя параметра является обязательным, но параметр может отображаться в любом месте команды.
Числовой указывает, что имя параметра является необязательным, но если имя опущено, параметр должен находиться в месте, указанном номером. Например, указывает,
2что при опущении имени параметра параметр должен быть вторым или единственным неименованным параметром в команде. Если используется имя параметра, параметр может располагаться в любом месте команды.Значение по умолчанию. Значение параметра или поведение по умолчанию, используемое PowerShell, если параметр не включен в команду.
Принимает входные данные конвейера. Указывает, можно ли (true) или не (false) отправлять объекты в параметр через конвейер. По имени свойства означает, что конвейерный объект должен иметь свойство, которое имеет то же имя, что и имя параметра.
Принимает дикие карта символы. Указывает, может ли значение параметра включать в себя дикие карта символы, такие как звездочка (
*) или вопросительный знак (?).
Связанные ссылки
PowerShell
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по