community.windows.win_timezone 模块 – 设置 Windows 机器时区

注意

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

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

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

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

概要

• 将机器时间设置为指定的时区。

参数

参数	注释
timezone 字符串 / 必需	要设置的时区。 示例：中部标准时间 要禁用夏令时，请在支持此功能的时区添加后缀 _dstoff。

备注

注意

• 该模块将检查机器是否支持提供的时区。

• 可从 tzutil.exe /l 和 https://msdn.microsoft.com/en-us/library/ms912391.aspx 获取可能的时区列表

• 如果在 Server 2008 上运行，则需要安装修补程序 https://support.microsoft.com/en-us/help/2556308/tzutil-command-line-tool-is-added-to-windows-vista-and-to-windows-server-2008 才能运行此模块。

另请参阅

另请参阅

community.windows.win_region

设置区域和格式设置。

示例

- name: Set timezone to 'Romance Standard Time' (GMT+01:00)
  community.windows.win_timezone:
    timezone: Romance Standard Time

- name: Set timezone to 'GMT Standard Time' (GMT)
  community.windows.win_timezone:
    timezone: GMT Standard Time

- name: Set timezone to 'Central Standard Time' (GMT-06:00)
  community.windows.win_timezone:
    timezone: Central Standard Time

- name: Set timezime to Pacific Standard time and disable Daylight Saving time adjustments
  community.windows.win_timezone:
    timezone: Pacific Standard Time_dstoff

返回值

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

键	描述
previous_timezone 字符串	如果时区已更改，则为之前的时区，否则为现有时区。 返回: 成功 示例: "中部标准时间"
timezone 字符串	当前时区（可能已更改）。 返回: 成功 示例: "中部标准时间"

作者

• Phil Schwartz (@schwartzmx)

集合链接

• 问题跟踪器
• 存储库（源代码）
• 通信