win_toast — Отправка уведомлений тостом для залогиненных пользователей Windows 10 и новее

Новое в версии 2.4.

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Автор

Обзор

Отправка уведомлений, которые появляются в области Центра действий на рабочем столе Windows.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
expire	Значение по умолчанию: 45	Время в секундах, по истечении которого уведомление истекает.
group	Значение по умолчанию: "Powershell"	Группа уведомлений, к которой будет добавлено уведомление.
msg	Значение по умолчанию: "Привет, мир!"	Текст уведомления. Можно использовать \n для форматирования сообщения внутри Центра действий.
popup bool	Варианты: no да ←	Если `no`, уведомление не будет выведено всплывающим окном, а только появится в Центре действий.
tag	Значение по умолчанию: "Ansible"	Тег, который добавляется к уведомлению.
title	Значение по умолчанию: "Уведомление ЧЧ:мм"	Заголовок уведомления, отображаемый во всплывающем окне.

Примечания

Примечание

Этот модуль должен выполняться на хостах с Windows 10 или Server 2016, поэтому убедитесь, что ваши игровые цели — хосты Windows или делегированы на хост Windows.
Модуль не завершается ошибкой, если для уведомления нет залогиненных пользователей.
Сообщения отправляются только на локальный хост, где выполняется модуль.
Вы должны запустить этот модуль с помощью async, иначе он будет зависать до истечения срока действия expire.

Примеры

- name: Warn logged in users of impending upgrade (note use of async to stop the module from waiting until notification expires).
  win_toast:
    expire: 60
    title: System Upgrade Notification
    msg: Automated upgrade about to start.  Please save your work and log off before {{ deployment_start_time }}
  async: 60
  poll: 0

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
expire_at_utc строка	всегда	Вычисленная дата и время UTC, когда уведомление истекает. Пример: 07 июля 2017 04:50:54
no_toast_sent_reason строка	при отсутствии залогиненных пользователей	Текст, содержащий причину, по которой уведомление не было отправлено. Пример: Пользователи не залогинены для уведомления
sent_localtime строка	всегда	Дата и время отправки уведомления в локальном часовом поясе. Пример: 07 июля 2017 05:45:54
time_taken вещественное число	всегда	Время выполнения модуля на удаленном хосте Windows в секундах. Пример: 0.3706631999999997
toast_sent булево	всегда	Указывает, удалось ли отправить уведомление тостом или нет.

Статус

Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратной совместимости.

Техническое обслуживание

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

Список других модулей, которые также поддерживаются сообществом Ansible, см. здесь.

Автор

Jon Hawkesworth (@jhawkesworth)

Подсказка

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

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/win_toast_module.html