Использование документации по PowerShell

  • Статья

Добро пожаловать в интерактивную документацию по PowerShell. Этот сайт содержит справочник по командлетам для следующих версий PowerShell:

  • PowerShell 7.5 (предварительная версия)
  • PowerShell 7.4 (LTS-current)
  • PowerShell 7.2 (текущая LTS)
  • PowerShell 5.1

Снимок экрана: различные элементы веб-страницы.

Веб-страница содержит несколько элементов, которые помогут вам перейти к документации.

  • Навигация на уровне сайта — навигация на уровне сайта отображается в верхней части страницы. Он содержит ссылки на другое содержимое на платформе Microsoft Learn.
  • Связанная навигация по содержимому— связанная панель содержимого непосредственно под навигацией на уровне сайта. Он содержит ссылки на содержимое, связанное с текущим набором документации, который является PowerShell в данном случае.
  • Селектор версий — селектор версий отображается над оглавлением (TOC) и управляет версией ссылки на командлет в TOC.
  • Оглавление — TOC слева от страницы делится на два раздела: концептуальные и справочные материалы. Обратите внимание на линию между ссылочным узлом toC. Концептуальные документы отображаются над строкой. Содержимое ссылки отображается в узле ссылок под строкой.
  • Кнопки действий — кнопки действия предоставляют способ добавления содержимого в коллекцию, предоставления отзывов, редактирования содержимого или предоставления общего доступа к содержимому другим пользователям.

Выбор версии PowerShell

Используйте селектор версий, расположенный над toC, чтобы выбрать нужную версию PowerShell. По умолчанию страница загружается с самой текущей версией стабильного выпуска. Селектор версий определяет, какая версия ссылки на командлета отображается в toC под узлом ссылок . Некоторые командлеты работают по-разному в разных версиях PowerShell, которые вы используете. Убедитесь, что вы просматриваете документацию по используемой вами версии PowerShell.

Селектор версий не влияет на концептуальную документацию. Концептуальные документы отображаются над узлом ссылки в TOC. Для каждой выбранной версии отображаются те же концептуальные статьи. При наличии различий в конкретной версии они отмечаются в документации.

Анимация, показывающая, как использовать селектор версий.

Чтобы узнать используемую версию PowerShell, проверьте значение $PSversionTable.PSVersion. В следующем примере показаны выходные данные для Windows PowerShell 5.1.

$PSVersionTable.PSVersion

Major  Minor  Build  Revision
-----  -----  -----  --------
5      1      22621  963

Поиск статей

Существует два способа поиска содержимого в документах.

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

В следующем примере поиск на панели навигации на уровне сайта возвращает 840 результатов для слова idempotent. В поле фильтра TOC введите слово invoke , в котором отображается список статей, содержащих слово invoke в заголовке. Введите слово idempotent в фильтре TOC без статей. Щелкнув ссылку поиска, выполните поиск idempotent в документации по PowerShell. Этот поиск возвращает только 9 результатов.

Анимация, показывающая, как использовать функции поиска.

Скачивание документации в формате PDF

Чтобы скачать документацию в формате PDF, нажмите кнопку "Скачать PDF" в нижней части toC.

Снимок экрана: кнопка

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

Поиск статей для предыдущих версий

Документация по более старым версиям PowerShell архивируется на нашем сайте предыдущих версий . Вы можете выбрать предыдущие версии из селектора версий.

Снимок экрана: параметр

Этот сайт содержит документацию по следующим темам:

  • PowerShell 3.0
  • PowerShell 4.0
  • PowerShell 5.0
  • PowerShell 6
  • PowerShell 7.0
  • PowerShell 7.1
  • PowerShell 7.3
  • Рабочие процессы PowerShell
  • PowerShell Web Access