модуль microsoft.ad.offline_join — получение BLOB-объекта автономного присоединения к домену

Примечание

Этот модуль входит в коллекцию microsoft.ad (версия 1.10.0).

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

Для установки используйте: ansible-galaxy collection install microsoft.ad. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: microsoft.ad.offline_join.

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

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

Используется для получения BLOB-объекта автономного присоединения к домену.
Этот BLOB-объект используется для присоединения компьютеров к домену без доступа к сети.

Требования

На узле, выполняющем этот модуль, должны быть установлены следующие компоненты.

ActiveDirectory модуль PowerShell

Параметры

Параметр	Комментарии
blob_path string	Если задано, байты BLOB-объекта будут сохранены в файл по указанному пути. Если родительский каталог не существует, он не будет создан. Наличие этого файла также используется для проверки идемпотентности: если файл уже существует, BLOB-объект не будет создан повторно. Если параметр задан, возвращаемое модулем значение blob будет равно null.
domain_server string	Указывает экземпляр доменных служб Active Directory, к которому нужно подключиться. Можно указать полное доменное имя (FQDN) или имя NetBIOS. Если параметр не задан, используется значение домена по умолчанию компьютера, на котором запущен PowerShell.
identity string	Идентификатор объекта компьютера, для которого создаётся BLOB-объект автономного присоединения. Этот параметр нельзя использовать одновременно с name и (path). Идентификатор можно указать в виде GUID, представляющего значение `objectGUID`, `sAMAccountName`, `objectSid` или `distinguishedName`. Необходимо указать этот параметр или name.
name string	Имя объекта компьютера, для которого создаётся BLOB-объект автономного присоединения. Этот параметр нельзя использовать одновременно с identity. Имя объединяется с path, чтобы найти объект компьютера AD, соответствующий значению DistinguishedName `CN={{ name}},{{ path }}`. Необходимо указать этот параметр или identity.
path string	Путь, по которому хранится объект компьютера, указанный с помощью `name`. По умолчанию используется путь компьютеров, заданный в AD, например `CN=Computers,DC=domain,DC=com`.
provision_root_ca_certs boolean	Добавляет все сертификаты корневых центров сертификации на локальном компьютере в BLOB-объект. Допустимые значения: `false` ← (по умолчанию) `true`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Модуль может работать в режиме check_mode и возвращать прогноз изменения состояния, не изменяя целевой узел; если режим не поддерживается, действие будет пропущено.
diff_mode	Поддержка: нет	В режиме diff будут возвращены сведения об изменениях (или о возможных изменениях в режиме check_mode).
platform	Платформа: windows	Целевая ОС или семейства ОС, с которыми можно выполнять операции

Примечания

Примечание

Дополнительные сведения об автономном присоединении к домену см. в пошаговом руководстве.
При создании BLOB-объекта нельзя указать конкретные учётные данные для связи с контроллером домена. Используйте become с сетевыми учётными данными, если текущий пользователь не может пройти аутентификацию самостоятельно, чтобы обойти проблему двойного перехода.
Данные, возвращаемые этим модулем, крайне важны для безопасности. Если параметр blob_path не используется, задаче следует указать no_log=True, чтобы не допустить утечки данных.
Этот модуль всегда сообщает об изменении, если не задан параметр blob_path. Если путь указан, наличие файла по этому пути используется для проверки идемпотентности.
Создание нового BLOB-объекта сбрасывает пароль объекта компьютера. Не запускайте модуль от имени учётной записи компьютера, который уже присоединён к домену.
Этот модуль необходимо запускать на целевом узле Windows с установленным модулем ActiveDirectory.

См. также

microsoft.ad.domain: Обеспечивает существование домена Windows.
microsoft.ad.membership: Управление членством узла Windows в домене или рабочей группе.
microsoft.ad.computer: Управление объектами компьютеров Active Directory.

Примеры

- name: create computer object
  microsoft.ad.computer:
    name: MyComputer
    state: present
  register: computer_obj

- name: create offline blob
  microsoft.ad.offline_join:
    identity: '{{ computer_obj.object_guid }}'
  when: computer_obj is changed
  register: offline_blob
  no_log: true

- name: join host by offline blob
  microsoft.ad.membership:
    offline_join_blob: '{{ offline_blob.blob }}'
    state: domain
    reboot: true
  delegate_to: member-host

- name: create blob and store it in a file on the target host
  microsoft.ad.offline_join:
    name: MyComputer
    path: OU=Production,DC=domain,DC=com
    blob_path: C:\Windows\TEMP\offline_blob

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

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

Ключ	Описание
blob string	BLOB-объект в виде строки base64. При запуске в режиме check mode это значение пустое. Если задан параметр blob_path, это значение равно null. Это значение крайне важно для безопасности, так как оно содержит учётные данные и другие сведения аутентификации, необходимые для автономного присоединения. Возвращается: всегда Пример: `"ARAIAMzMzMygCAAAAAAAAAAAAgABAAAA"`

Ключ

Описание

blob

string

BLOB-объект в виде строки base64.

При запуске в режиме check mode это значение пустое.

Если задан параметр blob_path, это значение равно null.

Это значение крайне важно для безопасности, так как оно содержит учётные данные и другие сведения аутентификации, необходимые для автономного присоединения.

Возвращается: всегда

Пример: "ARAIAMzMzMygCAAAAAAAAAAAAgABAAAA"

Авторы

Jordan Borean (@jborean93)

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

© 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/microsoft/ad/offline_join_module.html