Модуль community.windows.win_domain_ou – Управление организационными единицами Active Directory

Примечание

Этот модуль является частью коллекции community.windows (версия 2.3.0).

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

Для установки используйте: ansible-galaxy collection install community.windows. Для использования этого модуля требуются дополнительные компоненты, см. Требования для получения подробной информации.

Для использования в playbook, укажите: community.windows.win_domain_ou.

Новое в community.windows 1.8.0

УСТАРЕВШИЙ
Краткое описание
Требования
Параметры
Примеры
Возвращаемые значения
Статус

УСТАРЕВШИЙ

Удалено в:: версия 3.0.0
Почему:: Этот модуль был перемещен в коллекцию microsoft.ad.
Альтернатива:: Вместо этого используйте модуль microsoft.ad.ou.

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

Управление организационными единицами Active Directory
Добавление, удаление и изменение организационных единиц Active Directory
Задача должна быть делегирована контроллеру домена Windows Active Directory

Требования

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

Этот модуль требует Windows Server 2012 или новее
Модуль PowerShell ActiveDirectory

Параметры

Параметр	Комментарии
domain_password string	Пароль для доступа к домену
domain_server string	Указывает экземпляр служб домена Active Directory для подключения. Может быть в виде полного доменного имени или имени NetBIOS. Если не указано, то значение основано на домене компьютера, на котором запущен PowerShell.
domain_username string	Имя пользователя, используемое при взаимодействии с AD. Если это не установлено, то вместо этого будет использоваться пользователь Ansible, который использовался для входа при использовании CredSSP или Kerberos с делегированием учетных данных.
filter string	Фильтр для поиска ou. По умолчанию: `"*"`
name string / обязательно	Имя организационной единицы
path string	Указывает путь X.500 OU или контейнера, где создается новый объект. по умолчанию добавляет ou в основании домена, к которому подключено.
properties dictionary	Свободный словарь свойств для организационной единицы. Следует именам свойств LDAP, например `StreetAddress` или `PostalCode`.
protected boolean	Указывает, следует ли предотвращать удаление объекта. Когда protected=true, вы не можете удалить соответствующий объект, не изменив значение свойства. Варианты: `false` ← (по умолчанию) `true`
recursive boolean	Удаляет OU и все дочерние элементы, которые он содержит. Вы должны указать этот параметр, чтобы удалить OU, который не пуст. Варианты: `false` ← (по умолчанию) `true`
state string	Указывает желаемое состояние OU. Когда state=present, модуль попытается создать указанный OU, если он еще не существует. Когда state=absent, модуль удалит указанный OU. Когда state=absent и recursive=true, модуль удалит все OU и все дочерние OU. Варианты: `"present"` ← (по умолчанию) `"absent"`

Примеры

---
- name: Ensure OU is present & protected
  community.windows.win_domain_ou:
    name: AnsibleFest
    state: present

- name: Ensure OU is present & protected
  community.windows.win_domain_ou:
    name: EUC Users
    path: "DC=euc,DC=vmware,DC=lan"
    state: present
    protected: true
  delegate_to: win-ad1.euc.vmware.lab

- name: Ensure OU is absent
  community.windows.win_domain_ou:
    name: EUC Users
    path: "DC=euc,DC=vmware,DC=lan"
    state: absent
  delegate_to: win-ad1.euc.vmware.lab

- name: Ensure OU is present with specific properties
  community.windows.win_domain_ou:
    name: WS1Users
    path: "CN=EUC Users,DC=euc,DC=vmware,DC=lan"
    protected: true
    properties:
      city: Sandy Springs
      state: Georgia
      StreetAddress: 1155 Perimeter Center West
      country: US
      description: EUC Business Unit
      PostalCode: 30189
  delegate_to: win-ad1.euc.vmware.lab

- name: Ensure OU updated with new properties
  community.windows.win_domain_ou:
    name: WS1Users
    path: DC=euc,DC=vmware,DC=lan
    protected: false
    properties:
      city: Atlanta
      state: Georgia
      managedBy: jzollo@vmware.com
  delegate_to: win-ad1.euc.vmware.lab

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

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

Ключ	Описание
ou dictionary	Параметры новой/обновленной организационной единицы Возвращается: Когда state=present Пример: {"AddedProperties": [], "City": "Sandy Springs", "Country": null, "DistinguishedName": "OU=VMW Atlanta,DC=ansible,DC=test", "LinkedGroupPolicyObjects": [], "ManagedBy": null, "ModifiedProperties": [], "Name": "VMW Atlanta", "ObjectClass": "organizationalUnit", "ObjectGUID": "3e987e30-93ad-4229-8cd0-cff6a91275e4", "PostalCode": null, "PropertyCount": 11, "PropertyNames": "City Country DistinguishedName LinkedGroupPolicyObjects ManagedBy Name ObjectClass ObjectGUID PostalCode State StreetAddress", "RemovedProperties": [], "State": "Georgia", "StreetAddress": "1155 Perimeter Center West"}
path string	Базовый путь ou, используемый модулем, либо при указании path=DC=Ansible,DC=Test, либо полученный модулем. Возвращается: всегда Пример: `"{'path': 'DC=ansible,DC=test'}"`

Ключ

Описание

dictionary

Параметры новой/обновленной организационной единицы

Возвращается: Когда state=present

Пример: {"AddedProperties": [], "City": "Sandy Springs", "Country": null, "DistinguishedName": "OU=VMW Atlanta,DC=ansible,DC=test", "LinkedGroupPolicyObjects": [], "ManagedBy": null, "ModifiedProperties": [], "Name": "VMW Atlanta", "ObjectClass": "organizationalUnit", "ObjectGUID": "3e987e30-93ad-4229-8cd0-cff6a91275e4", "PostalCode": null, "PropertyCount": 11, "PropertyNames": "City Country DistinguishedName LinkedGroupPolicyObjects ManagedBy Name ObjectClass ObjectGUID PostalCode State StreetAddress", "RemovedProperties": [], "State": "Georgia", "StreetAddress": "1155 Perimeter Center West"}

path

string

Базовый путь ou, используемый модулем, либо при указании path=DC=Ansible,DC=Test, либо полученный модулем.

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

Пример: "{'path': 'DC=ansible,DC=test'}"

Статус

Этот модуль будет удален в версии 3.0.0. [устаревший]
Для получения дополнительной информации см. УСТАРЕВШИЙ.

Авторы

Joe Zollo (@joezollo)
Larry Lane (@gamethis)

Ссылки на сборник

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