---
title: Этапы пользователей
slug: help/neurons/ru_ru/etapy-polzovatelej
createdAt: 2026-09-08T08:52:12.727Z
---

Создавайте пользовательские этапы для настройки и сохранения этапов для использования во время создания бота. После создания этапы становятся доступны для повторного использования в [Редактор ботов](https://docs.ivanti.com/help/neurons/ru_ru/redaktor-botov) в разделе **Этапы** > **Пользователь.**

## Для создания этапа пользователя:

1. Перейдите в **Главное меню** > **Боты**.
   Появится главная страница **Боты**.
2. Откройте вкладку **основных ботов** или **ботов опроса**..
3. Выберите **Создать бот** или **Создать опрос**.
   Появится страница **Создать бот** или **Создать опрос**.
4. Выберите триггер бота: **Планируемый** или **Особое действие**.
5. Выберите тип цели: **Устройства** или **Люди**.
6. Введите **Имя** для бота. Если нужно, введите описание.
7. Нажмите **Создать**.
   Появится страница редактора ботов.
   Новый бот сохраняется как неактивная черновая версия.
8. На странице **редактора новых ботов** выберите **Управление этапами пользователей** для отображения страницы **Диспетчера этапов пользователей** .
9. На странице **Диспетчера этапов пользователей** нажмите раскрывающийся список **Создать** и выберите нужный этап:
   - Запрос PowerShell
   - Действие PowerShell
   - Действие Bash
   - Действие командной строки
   - OSQuery
10. На странице **редактора этапов пользователей** введите **имя этапа**. Например, Сжатие файла/папки.
11. Если нужно, введите описание. Описательный текст отображается, когда в редакторе бота и на панели **Настройки этапа** указана информация о нем. Например, На этом этапе исходные файлы из указанного пути сжимаются помещаются целевой путь.
12. Введите код сценария.
    **Пример**:
    `Compress-Archive -path C:\logs\file.txt `
    `-destinationpath C:\logs\file.zip `
    `-compressionlevel Optimal`

:::Paragraph{indent="1"}
Вы можете сделать этот сценарий более гибким, заменив часть неизменяемого кода переменными. Это позволит настраивать элементы во время использования этапа.
**Пример**:
`Compress-Archive -path ___Path to Source File or Folder__`
`-destinationpath __Destination Path__`
`-compressionlevel __Compression level|options:Fastest,Optimal,No ``Compression__`
:::

:::Paragraph{indent="1"}
Нажмите Ctrl + пробел для вставки **переменной параметров** или **переменной значения**:
:::

- **Переменная параметров** отображается в настройках в виде раскрывающегося списка - доступные параметры - это вводимые в сценарии параметры. В этом примере: Параметры уровня сжатия Fastest, Optimal, No Compression.
- **Переменная значения** отображается в настройках в виде текстового поля с меткой, вводимой в сценарии. В этом примере: Patch to Source File or Folder, Destination Path, and Compression level.

:::Paragraph{indent="1"}
В этом примере **настройки этапа** будут выглядеть так:
:::

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/HDmiha-yZ1nfp4Mgk328__bots-custom-stage.png" alt="custom stage settings " position="flex-start" size="35" width="346" height="602" initialPath="Images/bots-custom-stage.png" githubPath="RUS/Images/bots-custom-stage.png" showCaption="false" indent="1"}

13. Заполните **настройки этапа** - доступные настройки зависят от типа пользователя создаваемого этапа:

::::ExpandableHeading
## Запрос PowerShell

**Выполнить от имени**:

- Система
- От имени пользователя в системе
- Учетные данные

**Тип**:

- PowerShell
- Ядро
- Авто

**Вывод**: Добавьте выводные данные для каждого имени столбца, возвращаемого запросом PowerShell, который нужно использовать на этапе результатов последующего фильтра или в качестве переменной на другом этапе.

**Единичный результат**: Включение или выключение. Используйте одиночный или несколько результатов для определения, будет ли запрос возвращать один или несколько результатов для каждого устройства. Это определяет, доступны ли переменные в качестве входных маркеров непосредственно на последующих этапах (одиночные) или они доступны только для этапов в блоке результатов [для каждого](https://docs.ivanti.com/help/neurons/ru_ru/etapy-botov#for-each) (несколько) для зацикливания этих этапов для каждого результата.

**Пример запроса PowerShell:**

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

Для успешного выполнения запроса убедитесь, что:

- Выходные данные сценария имеют формат JSON (можно использовать команду ConvertTo-JSON).
- Вы можете присвоить имя каждому полю данных как записи вывода в **настройках этапа**.

:::hint{type="info"}
По умолчанию время ожидания вывода сценария - 25 минут.
:::

**Типы PowerShell:**

- Если будет выбран тип **PowerShell** со значением **Core**, сценарий PowerShell будет выполнен в ПО PowerShell Core .Net Core 3.1 Desktop Runtime - версия 24.64.28315 или выше должна быть установлена на вашем рабочем компьютере.
- Если будет выбран тип **PowerShell** со значением **Auto**, запрос выполнит поиск ПО Net Core 3.1 Desktop Runtime - версия 24.64.28315 или более поздней версии. Ниже представлены результаты:
  - Если среда выполнения уже установлена, сценарий будет выполнен с использованием **PowerShell Core**.
  - Если среда выполнения не установлена, сценарий будет выполнен с использованием **PowerShell**.

**Тип вывода:**

Включите, если нужно, чтобы отображались единичные результаты, и выключите, чтобы отображалось несколько результатов.

- Одиночный - если тип вывода указан как одиночный - только один объект будет возвращен в формате JSON.

```bash
$name = [System.Net.Dns]::GetHostName()
```

```bash
ConvertTo-Json @([customobject]@{Name = $name;})
```

- Несколько - если тип вывода указан как множественный - данные будут получены в виде массива объектов в формате JSON.
  Объекты в массиве содержат примитивные типы. В поле **Вывод** для **инспектора этапов** нужно подключить поле **Пример** и указать **Имя**.

  ```bash
  [{“Пример поля”: "A"}, {"Пример поля": “B”}]
  ```

  ```bash
  $processes = Get-Process | Select-Object Name
  ConvertTo-Json $processes
  ```
::::

:::ExpandableHeading
## Действие PowerShell

**Выполнить от имени**:

- Система
- От имени пользователя в системе
- Учетные данные

**Тип**:

- PowerShell
- Ядро
- Авто

Пример действия PowerShell:

**Действие PowerShell** подобно **запросу PowerShell** за исключением того, что для **действия PowerShell** выводные данные отсутствуют. Для получения дополнительной информации см. раздел [Пример запроса PowerShell](https://docs.ivanti.com/help/neurons/ru_ru/etapy-polzovatelej#PowerShell-query).
:::

:::ExpandableHeading
## Действие Bash

**Выполнить от имени**:

- Система
- От имени пользователя в системе

Пример действия Bash:

Для уменьшения размера посредством удаления первых 100 записей, используйте следующую команду:

```bash
sed 1,100d your-filename
```
:::

:::ExpandableHeading
## Действие командной строки

**Выполнить от имени**:

- Система
- От имени пользователя в системе

Пример действия команды:

- Для сканирования и восстановления поврежденных файлов:

```bash
sfc /scannow
```

- Для проверки и исправления статуса физического диска:

```bash
chkdsk /offlinescanandfix
```
:::

:::ExpandableHeading
## OSQuery

**Единичный результат**: Включение или выключение. Используйте одиночный или несколько результатов для определения, будет ли запрос возвращать один или несколько результатов для каждого устройства. Это определяет, доступны ли переменные в качестве входных маркеров непосредственно на последующих этапах (одиночные) или они доступны только для этапов в блоке результатов для каждого (несколько) для зацикливания этих этапов для каждого результата.

**Добавить назначение столбца**: Добавьте назначение столбцов для каждого имени столбца, возвращаемого osquery, которое нужно использовать на этапе результатов последующего фильтра или в качестве переменной на другом этапе.

Пример OSQuery:

Для обнаружения наиболее часто запускаемых на устройстве приложений, запустите сценарий:

```bash
select path,last_execution_time,count,
sid from userassist order by count desc
limit __Number of Apps to return|options:1,5,10__
```
:::

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

## Действия

Вы можете выполнять следующие действия для любого из этапов пользователей:

- **Клонировать**: Выберите этап пользователя, а затем **Действия** > **Клонировать**. Отобразится диалог **клонирования этапа**. Введите уникальное имя и нажмите **Клонировать**. Появится всплывающее сообщение с информацией об успешном создании этапа. Клонированный этап будет отображен в списке, и его можно выбрать и отредактировать.
- **Удалить**: Выберите один или несколько этапов пользователей и выберите **Действия** > **Удалить** . Отобразится диалог **удаления этапов**. Выберите **Удалить** для подтверждения удаления этапа. Это действие не может быть отменено, и данный этап станет устаревшим для любого бота, который его использует.**&#x20;Устаревшие этапы** помечаются красной рамкой.

### См. также:

[Этапы ботов](https://docs.ivanti.com/help/neurons/ru_ru/etapy-botov)
