Модуль ansible.windows.win_hostname — управление именем локального компьютера Windows

Примечание

Этот модуль входит в коллекцию ansible.windows (версия 3.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install ansible.windows.

Чтобы использовать коллекцию в плейбуке, укажите: ansible.windows.win_hostname.

Краткое описание
Параметры
См. также
Примеры
Возвращаемые значения

Краткое описание

Управляет именем локального компьютера Windows.
Чтобы новое имя компьютера вступило в силу, требуется перезагрузка.

Параметры

Параметр	Комментарии
name строка / обязательный	Имя узла, которое будет задано компьютеру.

См. также

ansible.windows.win_dns_client: Настраивает поиск DNS на узлах Windows.

Примеры

- name: Change the hostname to sample-hostname
  ansible.windows.win_hostname:
    name: sample-hostname
  register: res

- name: Reboot
  ansible.windows.win_reboot:
  when: res.reboot_required

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

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

Ключ	Описание
old_name строка	Исходное имя узла до его изменения. Возвращается: всегда Пример: `"old_hostname"`
reboot_required логический	Требуется ли перезагрузка для завершения изменения имени узла. Возвращается: всегда Пример: `true`

Авторы

Ripon Banik (@riponbanik)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/ansible/windows/win_hostname_module.html