cisco.ios.ios_system 模块 – 用于管理系统属性的模块。

注意

此模块是 cisco.ios 集合 (版本 9.0.3) 的一部分。

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

要安装它，请使用： ansible-galaxy collection install cisco.ios。

要在 playbook 中使用它，请指定： cisco.ios.ios_system。

cisco.ios 1.0.0 中的新增功能

概要 

此模块提供对 Cisco IOS 设备上的节点系统属性的声明式管理。它提供了一个选项来配置主机系统参数或从设备活动配置中删除这些参数。

参数 

参数	注释
domain_name 列表 / 元素=任意	将远程设备上的 IP 域名配置为提供的 value。值应采用点分名称形式，并将附加到 `hostname` 以创建完全限定域名。
domain_search 列表 / 元素=任意	提供要附加到主机名以进行名称解析的域名后缀列表。此参数接受名称列表，并将与运行节点上的当前活动配置协调。
hostname 字符串	配置设备主机名参数。此选项采用 ASCII 字符串值。
lookup_enabled 布尔值	用于启用或禁用 DNS 查询的管理控制。当此参数设置为 True 时，将执行查询；当设置为 False 时，将不执行查询。选项 `false` `true`
lookup_source 字符串	提供一个或多个源接口，用于执行 DNS 查询。`lookup_source` 中提供的接口必须是设备上配置的有效接口。
name_servers 列表 / 元素=任意	要用于执行名称解析查询的 DNS 命名服务器的 IP 地址列表。此参数接受 DNS 服务器列表，请参见示例。
state 字符串	设备当前活动配置中配置值的 state。设置为 present 时，应在设备活动配置中配置这些值；设置为 absent 时，这些值不应在设备活动配置中。选项 `"present"` ← (默认) `"absent"`

备注 

注意

在 CML 上针对 Cisco IOS XE 版本 17.3 进行了测试。
此模块与连接 network_cli 协同工作。请参见 https://docs.ansible.org.cn/ansible/latest/network/user_guide/platform_ios.html
有关使用 Ansible 管理网络设备的更多信息，请参见：ref:`Ansible 网络指南 <network_guide>`
有关使用 Ansible 管理 Cisco 设备的更多信息，请参见 `Cisco 集成页面 <https://ansible.org.cn/integrations/networks/cisco>`_。

示例 

- name: Configure hostname and domain name
  cisco.ios.ios_system:
    hostname: ios01
    domain_name: test.example.com
    domain_search:
      - ansible.com
      - redhat.com
      - cisco.com

- name: Remove configuration
  cisco.ios.ios_system:
    state: absent

- name: Configure DNS lookup sources
  cisco.ios.ios_system:
    lookup_source: MgmtEth0/0/CPU0/0
    lookup_enabled: true

- name: Configure name servers
  cisco.ios.ios_system:
    name_servers:
      - 8.8.8.8
      - 8.8.4.4

返回值 

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

键	描述
commands 列表 / 元素=字符串	要发送到设备的配置模式命令列表已返回：始终示例： `["hostname ios01", "ip domain name test.example.com"]`

作者

Peter Sprygada (@privateip)