community.network.cnos_factory 模块 – 将运行 Lenovo CNOS 的设备上的交换机启动配置重置为默认值(出厂设置)。
注意
此模块是 community.network 集合 (版本 5.1.0) 的一部分。
如果您正在使用 ansible
包,则可能已经安装了此集合。它不包含在 ansible-core
中。要检查它是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用: ansible-galaxy collection install community.network
。
要在 playbook 中使用它,请指定: community.network.cnos_factory
。
注意
community.network 集合已被弃用,并将从 Ansible 12 中移除。有关更多信息,请参见 讨论主题。
已弃用
- 在以下版本中移除:
6.0.0 版本
- 原因:
此集合及其中的所有内容均未维护且已弃用。
- 替代方案:
未知。
概要
此模块允许您重置交换机的启动配置。此方法提供了一种将启动配置重置为出厂设置的方法。当您想将交换机作为新的网络设备移动到另一个拓扑时,这将非常有用。此模块使用 SSH 来管理网络设备配置。操作结果可以在 results 目录中查看。
别名:network.cnos.cnos_factory
参数
参数 |
注释 |
---|---|
这指定了执行方法的设备类型。从 Ansible 2.4 开始添加了 NE1072T、NE1032、NE1032T、NE10032、NE2572 选项。从 2.8 开始添加了 NE0152T 选项。 选项
|
|
配置用于在交换机上进入全局配置命令模式的密码。如果交换机不需要此密码,则忽略此参数。虽然通常应从清单文件获取值,但您也可以将其指定为变量。此参数是可选的。如果未指定,则不使用默认值。 |
|
这是用于搜索 /etc/ansible/hosts 中的主机文件并识别要应用模板的设备的 IP 地址的变量。通常,Ansible 关键字 {{ inventory_hostname }} 在 playbook 中指定为需要配置的网络元素组的抽象。 |
|
这指定了保存每个命令执行输出的文件路径。合并的模板文件中的每个命令以及来自设备的每个响应都将保存在此处。通常位置是 results 文件夹,但您可以根据您的写入权限选择其他位置。 |
|
配置用于对远程设备进行身份验证的密码。password 参数的值用于对 SSH 会话进行身份验证。虽然通常应从清单文件获取值,但您也可以将其指定为变量。此参数是可选的。如果未指定,则不使用默认值。 |
|
配置用于对远程设备进行身份验证的用户名。username 参数的值用于对 SSH 会话进行身份验证。虽然通常应从清单文件获取值,但您也可以将其指定为变量。此参数是可选的。如果未指定,则不使用默认值。 |
备注
注意
有关使用 Ansible 管理 Lenovo 网络设备的更多信息,请参见 https://ansible.org.cn/ansible-lenovo。
示例
Tasks : The following are examples of using the module cnos_reload. These are
written in the main.yml file of the tasks directory.
---
- name: Test Reset to factory
community.network.cnos_factory:
deviceType: "{{ hostvars[inventory_hostname]['deviceType'] }}"
outputfile: "./results/test_factory_{{ inventory_hostname }}_output.txt"
返回值
常用的返回值已在 此处 记录,以下是此模块特有的字段
键 |
描述 |
---|---|
成功或失败消息 返回:始终 示例: |
状态
此模块将在 6.0.0 版本中移除。 *[已弃用]*
有关更多信息,请参见 已弃用。