Руководство по миграции

Модуль win_domain

Перенесён в microsoft.ad.domain.

Известных несовместимых изменений нет, модуль должен работать как непосредственная замена. Добавлен параметр reboot, позволяющий модулю самостоятельно выполнять необходимые перезагрузки вместо отдельной задачи ansible.windows.win_reboot. Из-за операций, связанных с повышением контроллера домена, настоятельно рекомендуется использовать этот параметр.

Модуль win_domain_controller

Перенесён в microsoft.ad.domain_controller.

Удалены следующие параметры:

• log_path - Создание журнала отладки действий модуля не поддерживается

Добавлен параметр reboot, позволяющий модулю самостоятельно выполнять перезагрузки вместо отдельной задачи ansible.windows.win_reboot. Из-за операций, связанных с повышением контроллера домена, настоятельно рекомендуется использовать этот параметр.

Модуль win_domain_membership

Перенесён в microsoft.ad.membership.

Удалены следующие параметры:

• log_path - Создание журнала отладки действий модуля не поддерживается

Добавлен параметр reboot, позволяющий модулю самостоятельно выполнять перезагрузки вместо отдельной задачи ansible.windows.win_reboot.

Модуль win_domain_computer

Перенесён в microsoft.ad.computer.

Параметр dns_host_name не требуется при state: present: объект компьютера создаётся без установки атрибута LDAP dnsHostName, если он не задан.

По умолчанию значение enabled не задано; созданная группа всё равно будет включена, но если параметр не указан, будет использован её текущий статус.

Параметр ou теперь называется path, чтобы соответствовать стандарту, принятому в других модулях.

Параметры offline_domain_join и odj_blob_path удалены. Используйте новый модуль microsoft.ad.offline_join для создания автономного объекта присоединения. Например:

- 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

- name: display offline blob
  debug:
    var: offline_blob.blob
  when: computer_obj is changed

Модуль win_domain_group

Перенесён в microsoft.ad.group.

Изменились следующие параметры:

• attributes - формат изменён, как описано в разделе Руководство по атрибутам
• ignore_protection - удалён; state: absent также удаляет объекты независимо от состояния защиты
• organizational_unit и ou - удалены; вместо них используйте path
• protect - переименован в protect_from_deletion; теперь для удаления группы с помощью state: absent его не нужно отключать

Возвращаемые значения для win_domain_group также упрощены; возвращаются только:

• distinguished_name - различающееся имя (DN) управляемого OU
• object_guid - GUID объекта управляемого OU
• sid - идентификатор безопасности управляемого пользователя

Все остальные возвращаемые значения удалены. При необходимости используйте microsoft.ad.object_info, чтобы получить дополнительные значения.

Модуль win_domain_group_membership

Перенесён в microsoft.ad.group.

Функциональность этого модуля объединена с microsoft.ad.group. Используйте параметр members со значением add, remove или set, чтобы соответственно добавлять, удалять или задавать участников группы.

Одно из изменений касается win_domain_group_membership: он позволял указывать сервер для поиска участника, используя формат SERVER\member-name. Этот формат участника не поддерживается в microsoft.ad.group, но начиная с версии 1.6.0 этой коллекции того же результата можно добиться, передав словарь в качестве значения участника. Например:

- name: Add a domain user/group from another Domain in the multi-domain forest to a domain group
  community.windows.win_domain_group_membership:
    name: GroupinDomainAAA
    domain_server: DomainAAA.cloud
    members:
      - DomainBBB.cloud\UserInDomainBBB
    state: present

- name: Add a domain user/group from another Domain in the multi-domain forest to a domain group
  microsoft.ad.group:
    name: GroupinDomainAAA
    domain_server: DomainAAA.cloud
    members:
      add:
        - name: UserInDomainBBB
          server: DomainBBB.cloud
    state: present

Дополнительные сведения см. в разделе Атрибуты поиска по DN.

Модуль win_domain_object_info

Перенесён в microsoft.ad.object_info.

Известных несовместимых изменений нет, модуль должен работать как непосредственная замена.

Модуль win_domain_ou

Перенесён в microsoft.ad.ou.

Изменились следующие параметры:

• protected - переименован в protect_from_deletion; теперь для удаления OU с помощью state: absent его не нужно отключать
• recursive - удалён; state: absent также рекурсивно удаляет объекты
• filter - удалён; объект name ссылается на имя OU, а identity можно использовать для выбора OU по DistinguishedName или ObjectGUID, если необходимо переименовать или переместить объект
• properties - удалён; используйте новый параметр attributes

Возвращаемые значения для win_domain_ou также упрощены; возвращаются только:

• distinguished_name - различающееся имя (DN) управляемого OU
• object_guid - GUID объекта управляемого OU

Все остальные возвращаемые значения удалены. При необходимости используйте microsoft.ad.object_info, чтобы получить дополнительные значения.

Модуль win_domain_user

Перенесён в microsoft.ad.user.

Изменились следующие параметры:

• attributes - формат изменён, как описано в разделе Руководство по атрибутам
• delegates - формат изменён, как описано в разделе Задание значений списков
• groups - формат изменён, как описано в разделе Задание значений списков
• groups_action - удалён в пользу нового формата groups
• groups_missing_behaviour - перенесён в значение словаря group под именем missing_behaviour
• spn- формат изменён, как описано в разделе Задание значений списков
• spn_action - удалён в пользу нового формата spn
• state - параметра запроса нет; вместо него используйте microsoft.ad.object_info
• enabled - по умолчанию не устанавливается в true. При создании нового пользователя без пароля будет использоваться enabled=false, а при задании пароля — enabled=true

Значение set параметров groups_action и spn_action переименовано в соответствии с общепринятой практикой. Функциональность state=query удалена для упрощения модуля и в пользу microsoft.ad.object_info, предназначенного для получения сведений об объектах AD. Значение по умолчанию enabled удалено, чтобы можно было задавать другие атрибуты существующего объекта AD без необходимости каждый раз указывать enabled.

Возвращаемые значения для win_domain_user также упрощены; возвращаются только:

• distinguished_name - различающееся имя (DN) управляемого пользователя
• object_guid - GUID объекта управляемого пользователя
• sid - идентификатор безопасности управляемого пользователя

Все остальные возвращаемые значения удалены. При необходимости используйте microsoft.ad.object_info, чтобы получить дополнительные значения.