модуль microsoft.ad.object_info — сбор сведений об объекте Active Directory

domain_password

string

Пароль для domain_username.

Его можно задать в разделе значений модуля по умолчанию для сценария, в группе group/microsoft.ad.domain.

domain_server

string

Указывает экземпляр служб домена Active Directory, к которому необходимо подключиться.

Можно указать полное доменное имя (FQDN) или имя NetBIOS.

Если значение не указано, используется домен по умолчанию компьютера, на котором запущен PowerShell.

Его можно задать в разделе значений модуля по умолчанию для сценария, в группе group/microsoft.ad.domain.

domain_username

string

Имя пользователя, используемое при взаимодействии с AD.

Если значение не задано, для аутентификации используется пользователь подключения.

Ansible не сможет использовать пользователя подключения, если для аутентификации не используется Kerberos с делегированием учётных данных или CredSSP, либо если для задачи не используется become.

Его можно задать в разделе значений модуля по умолчанию для сценария, в группе group/microsoft.ad.domain.

filter

string

Задаёт строку запроса с использованием синтаксиса языка выражений PowerShell.

Действуют те же правила и форматирование, что и для параметра -Filter командлетов AD в PowerShell, за исключением отсутствия подстановки переменных.

Этот параметр нельзя использовать одновременно с identity и ldap_filter.

identity

string

Указывает один объект Active Directory по его различающемуся имени или GUID объекта.

Этот параметр нельзя использовать одновременно с filter и ldap_filter.

Его нельзя использовать с параметрами search_base или search_scope.

include_deleted

boolean

Выполнять поиск также среди удалённых объектов Active Directory.

Варианты:

• false ← (по умолчанию)
• true

ldap_filter

string

Аналог filter, но для фильтрации возвращаемых объектов используется традиционная строка запроса LDAP.

Этот параметр нельзя использовать одновременно с filter и identity.

properties

list / elements=string

Список возвращаемых свойств.

Если свойство имеет значение *, будут возвращены все свойства объекта AD, для которых заданы значения.

Если свойство допустимо для объекта, но не задано, оно возвращается только в том случае, если явно указано в этом списке параметров.

Свойства DistinguishedName, Name, ObjectClass и ObjectGUID возвращаются всегда.

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

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

search_base

string

Указывает путь Active Directory, в котором выполняется поиск объектов.

Нельзя задать вместе с identity.

По умолчанию в качестве базы поиска используется контекст именования по умолчанию целевого экземпляра AD — DN, возвращаемое командой Get-ADRootDSE | Select-Object -ExpandProperty defaultNamingContext.

search_scope

string

Указывает область поиска объекта в search_base.

Значение base ограничивает поиск базовым объектом, поэтому максимальное число возвращаемых объектов всегда равно одному. Объекты внутри контейнера искать не будет.

Значение one_level позволяет искать в текущем пути и среди непосредственных объектов в этом пути.

Значение subtree позволяет искать в текущем пути и рекурсивно среди всех объектов в этом пути.

Нельзя задать вместе с identity.

Варианты:

• "base"
• "one_level"
• "subtree"

check_mode

Поддержка: полная

Модуль может работать в режиме check_mode и возвращать прогноз изменения состояния, не изменяя целевой объект. Если режим не поддерживается, действие будет пропущено.

diff_mode

Поддержка: отсутствует

В режиме diff возвращает сведения об изменениях (или о возможных изменениях в режиме check_mode).

platform

Платформа: windows

Целевые операционные системы и семейства ОС, с которыми можно работать.

objects

list / elements=dictionary

Список словарей, содержащих найденные объекты Active Directory и запрошенные свойства.

Ключами словаря являются имена свойств, а значениями — значения этих свойств.

Все свойства с датами возвращаются в формате ISO 8601 и часовом поясе UTC.

Все свойства SID возвращаются в виде словаря с ключами Sid для строки SID и Name для переведённого имени учётной записи SID.

Все свойства с байтовыми данными возвращаются в виде строки base64.

Все свойства дескриптора безопасности возвращаются в виде строки SDDL этого дескриптора.

Свойства DistinguishedName, Name, ObjectClass и ObjectGUID возвращаются всегда.

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

Пример: "[{\n  \"accountExpires\": 0,\n  \"adminCount\": 1,\n  \"CanonicalName\": \"domain.com/Users/Administrator\",\n  \"CN\": \"Administrator\",\n  \"Created\": \"2020-01-13T09:03:22.0000000Z\",\n  \"Description\": \"Built-in account for administering computer/domain\",\n  \"DisplayName\": null,\n  \"DistinguishedName\": \"CN=Administrator,CN=Users,DC=domain,DC=com\",\n  \"memberOf\": [\n    \"CN=Group Policy Creator Owners,CN=Users,DC=domain,DC=com\",\n    \"CN=Domain Admins\",CN=Users,DC=domain,DC=com\"\n  ],\n  \"Name\": \"Administrator\",\n  \"nTSecurityDescriptor\": \"O:DAG:DAD:PAI(A;;LCRPLORC;;;AU)(A;;CCDCLCSWRPWPDTLOCRSDRCWDWO;;;SY)(A;;CCDCLCSWRPWPLOCRSDRCWDWO;;;BA)\",\n  \"ObjectCategory\": \"CN=Person,CN=Schema,CN=Configuration,DC=domain,DC=com\",\n  \"ObjectClass\": \"user\",\n  \"ObjectGUID\": \"c8c6569e-4688-4f3c-8462-afc4ff60817b\",\n  \"objectSid\": {\n    \"Sid\": \"S-1-5-21-2959096244-3298113601-420842770-500\",\n    \"Name\": \"DOMAIN\\Administrator\"\n  },\n  \"sAMAccountName\": \"Administrator\",\n}]\n"