kaytus.ksmanage.ad_group 模块 – 管理活动目录组信息

注意

此模块是 kaytus.ksmanage 集合(版本 2.0.0)的一部分。

如果您使用的是 ansible 包,您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装,请运行 ansible-galaxy collection list

要安装它,请使用:ansible-galaxy collection install kaytus.ksmanage。您需要进一步的要求才能使用此模块,请参阅 要求 了解详细信息。

要在 playbook 中使用它,请指定:kaytus.ksmanage.ad_group

kaytus.ksmanage 1.0.0 中的新增功能

概要

  • 管理 kaytus 服务器上的活动目录组信息。

要求

在执行此模块的主机上需要以下要求。

  • Python 3.7+

  • inManage

参数

参数

注释

domain

字符串

输入角色组域。这是角色组所在的域。

host

字符串

指定用于通过指定的传输连接到远程设备的 DNS 主机名或地址。host 的值用作传输的目标地址。

kvm

字符串

此字段提供对 KVM 的访问权限,用于 AD 身份验证的角色组用户。

选项

  • "enable"

  • "disable"

name

字符串 / 必需

输入角色组名称。此名称标识 Active Directory 中的角色组。

password

字符串

指定用于验证与远程设备连接的密码。如果未在任务中指定该值,则将使用环境变量 ANSIBLE_NET_PASSWORD 的值。

pri

字符串

输入角色组特权。这是为此角色组分配的特权级别。

选项

  • "administrator"

  • "user"

  • "operator"

  • "oem"

  • "none"

provider

字典

包含连接详细信息的字典对象。

host

字符串

指定用于通过指定的传输连接到远程设备的 DNS 主机名或地址。host 的值用作传输的目标地址。

password

字符串

指定用于验证与远程设备连接的密码。如果未在任务中指定该值,则将使用环境变量 ANSIBLE_NET_PASSWORD 的值。

username

字符串

配置用于验证与远程设备连接的用户名。如果未在任务中指定该值,则将使用环境变量 ANSIBLE_NET_USERNAME 的值。

state

字符串

活动目录组是否应该存在,如果状态与声明的不同,则采取操作。

选项

  • "present" ← (默认)

  • "absent"

username

字符串

配置用于验证与远程设备连接的用户名。如果未在任务中指定该值,则将使用环境变量 ANSIBLE_NET_USERNAME 的值。

vm

字符串

此字段为 AD 身份验证的角色组用户提供对 VMedia 的访问权限。

选项

  • "enable"

  • "disable"

说明

注意

  • 不支持 check_mode

示例

- name: Ad group test
  hosts: ksmanage
  connection: local
  gather_facts: false
  vars:
    ksmanage:
      host: "{{ ansible_ssh_host }}"
      username: "{{ username }}"
      password: "{{ password }}"

  tasks:

  - name: "Add active directory group information"
    kaytus.ksmanage.ad_group:
      state: "present"
      name: "wbs"
      domain: "test.com"
      pri: "administrator"
      kvm: "enable"
      vm: "disable"
      provider: "{{ ksmanage }}"

  - name: "Set active directory group information"
    kaytus.ksmanage.ad_group:
      state: "present"
      name: "wbs"
      pri: "user"
      kvm: "disable"
      provider: "{{ ksmanage }}"

  - name: "Delete active directory group information"
    kaytus.ksmanage.ad_group:
      state: "absent"
      name: "wbs"
      provider: "{{ ksmanage }}"

返回值

常见的返回值记录在此处,以下是此模块特有的字段

描述

changed

布尔值

检查设备上是否进行了更改。

返回: 始终

message

字符串

模块执行后返回的消息。

返回: 始终

state

字符串

模块执行后的状态。

返回: 始终

作者

  • WangBaoshan (@ieisystem)