Администрирование контактов

Для администрирования контактов в домене Эллес с помощью утилиты samba-tool используется группа подкоманд сontact.

Добавление контакта

Для добавления контакта в домене Эллес используется следующий формат вызова:

  • с помощью подкоманды add:

    samba-tool contact add <contactname> [options]

  • с помощью подкоманды create:

    samba-tool contact create <contactname> [options]

Имя нового контакта может быть указано с помощью первого аргумента contactname, соответствующего общему имени (CN) объекта, или с помощью аргументов --given-name, --initials и --surname. Если значение contactname не указано, имя контакта образуется путем объединения значений переданных аргументов. К инициалам, переданным с помощью аргумента --initials, автоматически добавляется точка ('.'). Для создания контакта достаточно передать хотя бы один аргумент.

Параметры

Параметры вызова:

  • -H URL|--URL=URL — URL сервера LDAP; может содержать указание на протокол, имя хоста и номер порта;

  • --ou=OU — имя (DN) альтернативного расположения (без или с domainDN), в котором будет создан контакт (по умолчанию контакт создается на уровне домена);

  • --surname=SURNAME — фамилия контакта;

  • --given-name=GIVEN_NAME — имя контакта;

  • --initials=INITIALS — инициалы контакта;

  • --display-name=DISPLAY_NAME — отображаемое имя контакта;

  • --job-title=JOB_TITLE — должность контакта;

  • --department=DEPARTMENT — подразделение, к которому относится контакта;

  • --company=COMPANY — компания, в которой работает контакт;

  • --description=DESCRIPTION — информация о контакте;

  • --mail-address=MAIL_ADDRESS — адрес электронной почты контакта;

  • --internet-address=INTERNET_ADDRESS — URL домашней страницы контакта;

  • --telephone-number=TELEPHONE_NUMBER — номер телефона контакта;

  • --physical-delivery-office=PHYSICAL_DELIVERY_OFFICE — физический адрес офиса контакта.

Примеры

Пример добавления в домен нового контакта с указанием удаленного LDAP-сервера:

samba-tool contact add 'Ivan I. Ivanov' --job-title='Sales Manager' -H ldap://samba.samdom.example.com -U administrator

Пример добавления в домен нового контакта на локальном сервере:

samba-tool contact add --given-name=Anton --initials=A --surname=Antonov --job-title='Sales Manager'

Пример добавления нового контакта в подразделение OrgUnit:

samba-tool contact add 'Ivan S. Smirnov' --ou='OU=OrgUnit'

Изменение атрибутов контакта

Для изменения состава и значений атрибутов контакта в домене Эллес используется следующий формат вызова:

samba-tool contact edit <contactname> [options]

Переданное в команде имя контакта (contactname) интерпретируется как общее имя (CN) или уникальное имя (DN) объекта. Последнее может содержать или не содержать компонент domainDN.

В результате выполнения команды в системном текстовом редакторе или текстовом редакторе, переданном в качестве значения параметра --editor, открывается список атрибутов контакта. Редактирование и сохранение внесенных изменений выполняется средствами текстового редактора.

Параметры

Параметры вызова:

  • -H URL|--URL=URL — URL сервера LDAP; может содержать указание на протокол, имя хоста и номер порта;

  • --editor=EDITOR — текстовый редактор, который следует использовать вместо редактора, заданного в системе по умолчанию, либо вместо vi, если в системе не задан редактор по умолчанию.

Примеры

Пример запуска редактирования атрибутов контакта с общим именем Contact1 в домене с указанием удаленного LDAP-сервера:

samba-tool contact edit Contact1 -H ldap://samba.samdom.example.com -U administrator

Пример запуска редактирования атрибутов контакта Contact2 в подразделении Sales, заданного с помощью полного уникального доменного имени (DN):

samba-tool contact edit CN=Contact2,OU=Sales,DC=samdom,DC=example,DC=com

Пример запуска редактирования атрибутов контакта в домене с использованием редактора nano:

samba-tool contact edit Contact3 --editor=nano

Удаление контакта

Для удаления существующего контакта в домене Эллес используется следующий формат вызова:

samba-tool contact delete <contactname> [options]

Переданное в команде имя контакта (contactname) интерпретируется как общее имя (CN) или уникальное имя (DN) объекта. Последнее может содержать или не содержать компонент domainDN.

Параметры

Параметры вызова:

  • -H URL|--URL=URL — URL сервера LDAP; может содержать указание на протокол, имя хоста и номер порта.

Примеры

Пример удаления в домене контакта с указанием удаленного LDAP-сервера (значение параметра -H):

samba-tool contact delete Contact1 -H ldap://samba.samdom.example.com -U administrator

Пример удаления в домене контакта на локальном сервере:

sudo samba-tool contact delete Contact2

Получение списка контактов

Для получения полного списка контактов в домене Эллес используется следующий формат вызова:

samba-tool contact list [options]

По умолчанию выводится список общих имен (CN) контактов.

Параметры

Параметры вызова:

  • -H URL|--URL=URL — URL сервера LDAP; может содержать указание на протокол, имя хоста и номер порта;

  • --full-dn — выводить в списке вместо общих имен контактов уникальные составные имена (DN);

  • -b BASE_DN|--base-dn=BASE_DN — выводить в списке только контакты с указанным базовым уникальным именем (DN).

Примеры

Пример получения списка имен контактов:

samba-tool contact list

Пример получения списка уникальных составных имен контактов (DN):

samba-tool contact list --full-dn

Перемещение контакта в подразделение/контейнер

Для перемещения контакта в домене Эллес в указанное подразделение (OU) или контейнер используется следующий формат вызова:

samba-tool contact move <contactname> <new_parent_dn> [options]

Переданное в команде имя контакта (contactname) интерпретируется как общее имя (CN) или уникальное имя (DN) объекта. Последнее может содержать или не содержать компонент domainDN.

Имя подразделения или контейнера (DN) может содержать domainDN или указываться без него.

Параметры

Параметры вызова:

  • -H URL|--URL=URL — URL сервера LDAP; может содержать указание на протокол, имя хоста и номер порта.

Примеры

Пример перемещения контакта в подразделение OrgUnit с указанием удаленного LDAP-сервера:

samba-tool contact move Contact1 'OU=OrgUnit,DC=samdom,DC=example,DC=com' -H ldap://samba.samdom.example.com -U administrator

Пример перемещения контакта обратно в контейнер Contacts на локальном сервере:

samba-tool contact move Contact2 OU=Contacts,DC=samdom,DC=example,DC=com

Получение атрибутов контакта

Для получения атрибутов контакта в домене Эллес используется следующий формат вызова:

samba-tool contact show <contactname> [options]

Переданное в команде имя контакта (contactname) интерпретируется как общее имя (CN) или уникальное имя (DN) объекта. Последнее может содержать или не содержать компонент domainDN.

В параметре --attributes может передаваться список атрибутов (через запятую), значения которых требуется отобразить. Если параметр --attributes не задан или задан в формате --attributes=*, выводятся все доступные атрибуты учетной записи.

Если запрошенный в параметре --attributes атрибут отсутствует у указанной учетной записи, он опускается в выводе.

Параметры

Параметры вызова:

  • -H URL|--URL=URL — URL сервера LDAP; может содержать указание на протокол, имя хоста и номер порта;

  • --attributes=COMPUTER_ATTRS — список атрибутов (через запятую), которые требуется вывести.

Примеры

Пример получения атрибутов контакта в домене с указанием удаленного LDAP-сервера:

samba-tool contact show Contact1 -H ldap://samba.samdom.example.com -U administrator

Пример получения атрибутов контакта в домене на локальном сервере:

samba-tool contact show CN=Contact2,OU=People,DC=samdom,DC=example,DC=com

Пример получения значений атрибутов mail и mobile компьютера:

samba-tool contact show Contact3 --attributes=mail,mobile

Изменение имени контакта и связанных атрибутов

Для изменения имени контакта в домене Эллес и связанных с ним атрибутов (given-name, surname, initials) используется следующий формат вызова:

samba-tool contact rename <contactname> [options]

Новое общее имя контакта (CN) будет составлено путем комбинирования значений параметров given-name, initials и surname. При необходимости к инициалам будет автоматически добавлена точка ('.'). Используйте опцию --force-new-cn для задания нового значения CN вручную и опцию --reset-cn для отмены этого изменения.

Для удаления указанного атрибута задайте в нем пустое значение.

Переданное в команде имя контакта (contactname) интерпретируется как общее имя (CN) или уникальное имя (DN) объекта. Последнее может содержать или не содержать компонент domainDN.

Параметры

Параметры вызова:

  • -H URL|--URL=URL — URL сервера LDAP; может содержать указание на протокол, имя хоста и номер порта;

  • --surname=SURNAME — новое значение фамилии;

  • --given-name=GIVEN_NAME — новое значение имени;

  • --initials=INITIALS — новое значение инициалов;

  • --force-new-cn=NEW_CN — новое значение CN (RND) для использования вместо комбинации значений атрибутов given-name, initials и surname;

  • --reset-cn — использовать в качестве значения CN комбинацию значений атрибутов given-name, initials и surname; используйте данную опцию для отмены изменений, внесенных с помощью опции --force-new-cn;

  • --display-name=DISPLAY_NAME — новое отображаемое имя;

  • --mail-address=MAIL_ADDRESS — новое значение для адреса электронной почты.

Примеры

Пример изменения фамилии контакта с изменением общего имени объекта на локальном сервере:

samba-tool contact rename "Ivan Ivanov" --surname=Antonov --force-new-cn=Ivan

Пример изменения имени контакта с указанием удаленного LDAP-сервера:

samba-tool contact rename "I Ivanov" --given-name=Ivan -H ldap://samba.samdom.example.com -U administrator

Если предшествующее значение общего имени (CN) было образовано путем комбинирования стандартного набора атрибутов, в результате переименования будет автоматически сформировано новое значение общего имени.