community.windows.win_domain_computer – Управление компьютерами в Active Directory

Примечание

Этот плагин входит в коллекцию community.windows (версия 1.2.0).

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

Чтобы использовать его в книге задач, укажите: community.windows.win_domain_computer.

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

Обзор

Создание, чтение, обновление и удаление компьютеров в Active Directory с использованием компьютера с мостом Windows для запуска команд PowerShell New-ADComputer, Get-ADComputer, Set-ADComputer, Remove-ADComputer и Move-ADObject.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
description строка	Значение по умолчанию: ""	Указывает описание объекта. Этот параметр задает значение свойства Description для объекта. Имя отображения LDAP (ldapDisplayName) для этого свойства — description.
dns_hostname строка		Указывает полное доменное имя (FQDN) компьютера. Этот параметр задает свойство DNSHostName для объекта компьютера. Имя отображения LDAP для этого свойства — dNSHostName. Требуется при state=present.
domain_password строка		Пароль для username.
domain_server строка		Указывает экземпляр служб доменных имен Active Directory для подключения. Может быть в формате FQDN или NetBIOS-имени. Если не указано, значение основано на домене компьютера, на котором выполняется PowerShell.
domain_username строка		Имя пользователя для взаимодействия с AD. Если не задано, будет использован пользователь, с помощью которого Ansible вошел в систему при использовании CredSSP или Kerberos с делегированием учетных данных.
enabled логическое	Варианты: no да ←	Указывает, включена ли учетная запись. Для включенной учетной записи требуется пароль. Этот параметр устанавливает свойство Enabled для объекта учетной записи. Этот параметр также устанавливает флаг ADS_UF_ACCOUNTDISABLE атрибута управления учетными записями Active Directory (UAC).
name строка / обязательно		Указывает имя объекта. Этот параметр задает свойство Name объекта Active Directory. Имя отображения LDAP (ldapDisplayName) для этого свойства — name.
odj_blob_path строка		Путь к файлу, в котором будет сохранен BLOB. Если не указан, будет использован временный файл. Если offline_domain_join=output, файл будет удален после возвращения его содержимого. Родительский каталог для файла BLOB должен существовать; промежуточные каталоги не будут созданы.
offline_domain_join строка	Варианты: none ← output path	Подготавливает компьютер в каталоге и предоставляет файл BLOB, который можно использовать на целевом компьютере/образе для присоединения к домену в автономном режиме. Значение `none` не выполняет никаких операций присоединения в автономном режиме. `output` возвращает BLOB в выходные данные. BLOB следует рассматривать как секрет (он содержит пароль машины), поэтому при использовании этого варианта используйте `no_log`. `path` сохраняет файл BLOB автономного присоединения к домену на целевой машине для последующего использования. Путь будет возвращен. Если компьютер уже существует, BLOB не будет создан/возвращен, и модуль будет работать так же, как и без автономного присоединения к домену.
ou строка		Указывает путь X.500 организационной единицы (OU) или контейнера, где создается новый объект. Требуется при state=present. Специальные символы должны быть экранированы, см. имена отличительных свойств для получения подробностей.
sam_account_name строка		Указывает имя учетной записи диспетчера безопасности (SAM) компьютера. Максимальная длина — 256 символов, 15 рекомендуется для совместимости со старыми операционными системами. Имя отображения LDAP (ldapDisplayName) для этого свойства — sAMAccountName. Если опущено, значение совпадает с `name`. Обратите внимание, что все имена компьютеров SAMAccountNames должны заканчиваться на `$`. Если `$` опущено, оно будет добавлено в конец.
state строка	Варианты: absent present ←	Указано, должен ли компьютер быть `present` или `absent` в Active Directory.

Примечания

Примечание

Дополнительную информацию об автономном присоединении к домену см. в пошаговом руководстве.
При использовании BLOB ODJ для присоединения компьютера к домену он должен быть записан в файл.
Файл должен быть закодирован в UTF-16 (в PowerShell этот код называется Unicode), и он должен заканчиваться нулевым символом. См. примеры.
Часть процесса автономного присоединения к домену djoin.exe не будет использовать domain_server, domain_username или domain_password.

См. также

ansible.windows.win_domain: Официальная документация по модулю ansible.windows.win_domain.
ansible.windows.win_domain_controller: Официальная документация по модулю ansible.windows.win_domain_controller.
community.windows.win_domain_group: Официальная документация по модулю community.windows.win_domain_group.
ansible.windows.win_domain_membership: Официальная документация по модулю ansible.windows.win_domain_membership.
community.windows.win_domain_user: Официальная документация по модулю community.windows.win_domain_user.

Примеры

- name: Add linux computer to Active Directory OU using a windows machine
  community.windows.win_domain_computer:
    name: one_linux_server
    sam_account_name: linux_server$
    dns_hostname: one_linux_server.my_org.local
    ou: "OU=servers,DC=my_org,DC=local"
    description: Example of linux server
    enabled: yes
    state: present
  delegate_to: my_windows_bridge.my_org.local

- name: Remove linux computer from Active Directory using a windows machine
  community.windows.win_domain_computer:
    name: one_linux_server
    state: absent
  delegate_to: my_windows_bridge.my_org.local

- name: Provision a computer for offline domain join
  community.windows.win_domain_computer:
    name: newhost
    dns_hostname: newhost.ansible.local
    ou: 'OU=A great\, big organizational unit name,DC=ansible,DC=local'
    state: present
    offline_domain_join: yes
    odj_return_blob: yes
  register: computer_status
  delegate_to: windc.ansible.local

- name: Join a workgroup computer to the domain
  vars:
    target_blob_file: 'C:\ODJ\blob.txt'
  ansible.windows.win_shell: |
    $blob = [Convert]::FromBase64String('{{ computer_status.odj_blob }}')
    [IO.File]::WriteAllBytes('{{ target_blob_file }}', $blob)
    & djoin.exe --% /RequestODJ /LoadFile '{{ target_blob_file }}' /LocalOS /WindowsPath "%SystemRoot%"

- name: Restart to complete domain join
  ansible.windows.win_restart:

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

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

Ключ		Возвращаемое значение	Описание
djoin словарь		при offline_domain_join True и компьютер не существовал	Информация о вызове djoin.exe.
	invocation строка	всегда	Полная командная строка, используемая для вызова djoin.exe Пример: djoin.exe /PROVISION /MACHINE compname /MACHINEOU OU=Hosts,DC=ansible,DC=local /DOMAIN ansible.local /SAVEFILE blobfile.txt
	rc целое число	при отсутствии режима проверки	Код возврата от djoin.exe Пример: 87
	stderr строка	при отсутствии режима проверки	Вывод stderr от djoin.exe Пример: Неправильная комбинация входных параметров.
	stdout строка	при отсутствии режима проверки	Вывод stdout от djoin.exe Пример: Присоединение компьютера выполнено успешно.
odj_blob строка		при offline_domain_join не 'none' и компьютер не существовал	BLOB автономного присоединения к домену. Пустая строка при включенном режиме проверки или при offline_domain_join 'path'. Это поле содержит закодированное в base64 сырое содержимое файла BLOB автономного присоединения к домену. Пример: <длинная строка base64>
odj_blob_file строка		при offline_domain_join 'path' и компьютер не существовал	Путь к файлу BLOB автономного присоединения к домену на целевом хосте. Если был указан odj_blob_path, этот путь будет совпадать. Пример: C:\Users\admin\AppData\Local\Temp\e4vxonty.rkb

Авторы

Даниэль Санчес Фабрегас (@Daniel-Sanchez-Fabregas)
Брайан Шолер (@briantist)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/windows/win_domain_computer_module.html