community.windows.win_msg 模块 – 向 Windows 主机上已登录的用户发送消息

注意

此模块是 community.windows 集合 (版本 2.3.0) 的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.windows。

要在 playbook 中使用它，请指定：community.windows.win_msg。

概要

  • 包装 msg.exe 命令，以便向 Windows 主机发送消息。

参数

参数

注释

display_seconds

整数

等待接收者确认消息的时间，以秒为单位。

默认值： 10

msg

字符串

要显示的消息文本。

消息长度必须小于 256 个字符。

默认值： "Hello world!"

to

字符串

要将消息发送给谁。可以是用户名、会话名或会话 ID。

默认值： "*"

wait

布尔值

是否等待用户响应。模块将仅等待 display_seconds 中指定的秒数，如果未指定，则等待 10 秒。但是，如果 wait 为 yes，则消息将依次发送给每个已登录的用户，等待用户按下“确定”或超时时间过去，然后再继续下一个用户。

选择

  • false ← (默认)

  • true

注意

注意

  • 此模块必须在 Windows 主机上运行，因此请确保您的 Playbook 目标是 Windows 主机，或委托给 Windows 主机。

  • 消息仅发送到运行该模块的本地主机。

  • 该模块不支持发送给文件中列出的用户。

  • 将 wait 设置为 yes 可能会导致系统在有多个用户登录时运行时间过长。

另请参阅

另请参阅

community.windows.win_say

用于 Windows 的文本到语音模块，用于语音播报消息并可选择播放声音。

community.windows.win_toast

向 Windows 10 或更高版本主机上已登录的用户发送 Toast Windows 通知。

示例

- name: Warn logged in users of impending upgrade
  community.windows.win_msg:
    display_seconds: 60
    msg: Automated upgrade about to start.  Please save your work and log off before {{ deployment_start_time }}

返回值

常见的返回值记录在此处，以下是此模块特有的字段

键

描述

display_seconds

字符串

display_seconds 模块参数的值。

返回：成功

示例： "10"

msg

字符串

已发送的消息的测试。

返回：已更改

示例： "自动升级即将开始。 请保存您的工作并在 2016 年 7 月 22 日 18:00:00 前注销"

rc

整数

API 调用的返回代码。

返回：始终

示例： 0

runtime_seconds

字符串

模块在远程 Windows 主机上运行所花费的时间。

返回：成功

示例： "2016 年 7 月 22 日 17:45:51"

sent_localtime

字符串

发送消息时 Windows 主机的本地时间。

返回：成功

示例： "2016 年 7 月 22 日 17:45:51"

wait

布尔值

wait 模块参数的值。

返回：成功

示例： false

作者

  • Jon Hawkesworth (@jhawkesworth)