community.windows.win_region 模块 – 设置区域和格式设置

注意

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

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

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

要在剧本中使用它，请指定： community.windows.win_region。

概要

  • 设置Windows服务器的区域设置。

  • 设置Windows服务器的格式设置。

  • 设置Windows服务器的Unicode语言设置。

  • 将这些设置复制到默认配置文件。

参数

参数

注释

copy_settings

布尔值

这会将当前格式和位置值复制到新的用户配置文件和欢迎屏幕。这只有在 location、format 或 unicode_language 导致更改时才会运行。如果此过程运行，则始终会导致更改。

选项

  • false ← (默认)

  • true

format

字符串

要为当前用户设置的语言格式，有关可使用的区域性名称列表，请参阅 https://msdn.microsoft.com/en-us/library/system.globalization.cultureinfo.aspx。

如果未设置 location 或 unicode_language，则需要设置此项。

location

字符串

要为当前用户设置的位置，有关可使用的 GeoID 列表及其相关位置，请参阅 https://msdn.microsoft.com/en-us/library/dd374073.aspx。

如果未设置 format 或 unicode_language，则需要设置此项。

unicode_language

字符串

要为所有用户设置的 Unicode 语言格式，有关可使用的区域性名称列表，请参阅 https://msdn.microsoft.com/en-us/library/system.globalization.cultureinfo.aspx。

如果未设置 location 或 format，则需要设置此项。设置此值后，需要重新启动才能生效。

另请参阅

另请参阅

community.windows.win_timezone

设置Windows机器时区。

示例

- name: Set the region format to English United States
  community.windows.win_region:
    format: en-US

- name: Set the region format to English Australia and copy settings to new profiles
  community.windows.win_region:
    format: en-AU
    copy_settings: true

- name: Set the location to United States
  community.windows.win_region:
    location: 244

# Reboot when region settings change
- name: Set the unicode language to English Great Britain, reboot if required
  community.windows.win_region:
    unicode_language: en-GB
  register: result

- ansible.windows.win_reboot:
  when: result.restart_required

# Reboot when format, location or unicode has changed
- name: Set format, location and unicode to English Australia and copy settings, reboot if required
  community.windows.win_region:
    location: 12
    format: en-AU
    unicode_language: en-AU
  register: result

- ansible.windows.win_reboot:
  when: result.restart_required

返回值

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

键

描述

restart_required

布尔值

更改是否需要重新启动才能生效。

返回：成功

示例： true

作者

  • Jordan Borean (@jborean93)