модуль dellemc.unity.cifsserver — управление CIFS-сервером в системе хранения Unity

Примечание

Этот модуль входит в коллекцию dellemc.unity (версия 2.1.0).

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

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

Чтобы использовать модуль в плейбуке, укажите: dellemc.unity.cifsserver.

Добавлено в dellemc.unity 1.4.0

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

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

Управление CIFS-сервером в системе хранения Unity включает создание CIFS-сервера, получение сведений о CIFS-сервере и его удаление.

Требования

Следующие требования должны быть выполнены на хосте, выполняющем этот модуль.

Устройство хранения Dell Unity версии 5.3 или новее.
Ansible-core 2.17 или новее.
Python 3.11, 3.12 или 3.13.
Python SDK Storops 1.2.12.

Параметры

Параметр	Комментарии
cifs_server_id string	Идентификатор CIFS-сервера.
cifs_server_name string	Имя CIFS-сервера.
domain string	Имя домена, в котором SMB-сервер зарегистрирован в Active Directory.
domain_password string	Пароль домена Active Directory.
domain_username string	Имя пользователя домена Active Directory.
interfaces list / elements=string	Список IP-интерфейсов файлового доступа, обслуживающих протокол CIFS SMB-сервера.
local_password string	Пароль администратора автономного SMB-сервера.
nas_server_id string	Идентификатор NAS-сервера, на котором будет размещен CIFS-сервер.
nas_server_name string	Имя NAS-сервера, на котором будет размещен CIFS-сервер.
netbios_name string	Имя компьютера SMB-сервера в сети Windows.
password string / обязательный	Пароль сервера управления Unity.
port integer	Номер порта для обмена данными с сервером управления Unity. По умолчанию: `443`
state string / обязательный	Определяет, должен ли CIFS-сервер существовать. Варианты: `"absent"` `"present"`
unispherehost string / обязательный	IP-адрес или полное доменное имя сервера управления Unity.
unjoin_cifs_server_account boolean	Оставить учетную запись SMB-сервера неотсоединенной от Active Directory после удаления. Значение `false` означает, что учетная запись SMB-сервера останется присоединенной после удаления. Значение `true` означает, что учетная запись SMB-сервера будет отсоединена от Active Directory перед удалением. Варианты: `false` `true`
username string / обязательный	Имя пользователя сервера управления Unity.
validate_certs псевдонимы: verifycert boolean	Логическая переменная, указывающая, следует ли проверять SSL-сертификат. `true` — указывает, что SSL-сертификат необходимо проверить. `false` — указывает, что SSL-сертификат проверять не следует. Варианты: `false` `true` ← (по умолчанию)
workgroup string	Рабочая группа автономного SMB-сервера.

Примечания

Примечание

Поддерживается режим check_mode.
Модули этой коллекции с именем «dellemc.unity» предназначены для поддержки платформы хранения Dell Unity.

Примеры

- name: Create CIFS server belonging to Active Directory
  cifsserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "test_nas1"
    cifs_server_name: "test_cifs"
    domain: "ad_domain"
    domain_username: "domain_username"
    domain_password: "domain_password"
    state: "present"

- name: Get CIFS server details using CIFS server ID
  cifsserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    cifs_server_id: "cifs_37"
    state: "present"

- name: Get CIFS server details using NAS server name
  cifsserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "test_nas1"
    state: "present"

- name: Delete CIFS server
  cifsserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    cifs_server_id: "cifs_37"
    unjoin_cifs_server_account: true
    domain_username: "domain_username"
    domain_password: "domain_password"
    state: "absent"

- name: Create standalone CIFS server
  cifsserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    netbios_name: "ANSIBLE_CIFS"
    workgroup: "ansible"
    local_password: "Password123!"
    nas_server_name: "test_nas1"
    state: "present"

- name: Get CIFS server details using netbios name
  cifsserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    netbios_name: "ANSIBLE_CIFS"
    state: "present"

- name: Delete standalone CIFS server
  cifsserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    cifs_server_id: "cifs_40"
    state: "absent"

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

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

Ключ	Описание
changed boolean	Изменился ли ресурс. Возвращается: всегда Пример: `true`
cifs_server_details dictionary	Сведения о CIFS-сервере. Возвращается: если CIFS-сервер существует Пример: {"description": null, "domain": "xxx.xxx.xxx.com", "existed": true, "file_interfaces": {"UnityFileInterfaceList": [{"UnityFileInterface": {"hash": -9223363258905013637, "id": "if_43"}}]}, "hash": -9223363258905010379, "health": {"UnityHealth": {"hash": 8777949765559}}, "id": "cifs_40", "is_standalone": false, "last_used_organizational_unit": "ou=Computers,ou=Dell NAS servers", "name": "ansible_cifs", "nas_server": {"UnityNasServer": {"hash": 8777949765531, "id": "nas_18"}}, "netbios_name": "ANSIBLE_CIFS", "smb_multi_channel_supported": true, "smb_protocol_versions": ["1.0", "2.0", "2.1", "3.0"], "smbca_supported": true, "workgroup": null}
description string	Описание SMB-сервера. Возвращается: при успешном выполнении
domain string	Имя домена, в котором SMB-сервер зарегистрирован в Active Directory. Возвращается: при успешном выполнении
file_interfaces dictionary	Файловые интерфейсы, связанные с NAS-сервером. Возвращается: при успешном выполнении
UnityFileInterfaceList list / elements=string	Список файловых интерфейсов, связанных с NAS-сервером. Возвращается: при успешном выполнении
UnityFileInterface dictionary	Сведения о файловом интерфейсе, связанном с NAS-сервером. Возвращается: при успешном выполнении
id string	Уникальный идентификатор файлового интерфейса. Возвращается: при успешном выполнении
id string	Уникальный идентификатор экземпляра CIFS-сервера. Возвращается: при успешном выполнении
is_standalone boolean	Указывает, является ли SMB-сервер автономным. Возвращается: при успешном выполнении
name string	Имя SMB-сервера, указанное пользователем. Возвращается: при успешном выполнении
nasServer dictionary	Сведения о NAS-сервере в системе хранения. Возвращается: при успешном выполнении
UnityNasServer dictionary	Сведения о NAS-сервере в системе хранения. Возвращается: при успешном выполнении
id string	Уникальный идентификатор экземпляра NAS-сервера. Возвращается: при успешном выполнении
netbios_name string	Имя компьютера SMB-сервера в сети Windows. Возвращается: при успешном выполнении
smb_multi_channel_supported boolean	Указывает, поддерживается ли функция многоканального подключения SMB 3.0+. Возвращается: при успешном выполнении
smb_protocol_versions list / elements=string	Поддерживаемые протоколы SMB, например 1.0, 2.0, 2.1, 3.0 и т. д. Возвращается: при успешном выполнении
smbca_supported boolean	Указывает, поддерживает ли SMB-сервер непрерывную доступность. Возвращается: при успешном выполнении
workgroup string	Рабочая группа сети Windows для SMB-сервера. Возвращается: при успешном выполнении

Авторы

Akash Shendge (@shenda1)

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

© 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/dellemc/unity/cifsserver_module.html