ad_campus平台如何快速批量关闭接入交换机的空闲端口，

您好，参考

05-AD-Campus 6.5 自动化配置指导-新华三集团-H3C

无法快速关闭

# AD‑Campus 批量关闭接入交换机空闲端口

>
> 重要前置说明：**AD‑Campus 原生没有 “自动识别空闲端口并一键 shutdown” 的内置按钮**。控制器无法自动识别物理 Down 的空闲端口做自动关闭，提供 4 种实施方案，按工程推荐优先级排序。

>
> 区分两个概念：

1. **静态批量关闭**：按端口编号范围批量下发 shutdown（适合新交付、已知哪些端口空闲）
2. **动态识别空闲端口**：先采集端口物理状态，筛选物理 Down 端口，再下发 shutdown；AD‑Campus 页面无原生能力，需要响应编排 / 外部脚本。

## 方案一：接口模板批量下发（AD‑Campus 原生界面，优先推荐，静态范围）

适用：接入交换机端口规划固定，明确哪些端口是预留空闲端口，**按端口号范围批量下发 shutdown**，上行 / 堆叠口避开不处理。

>
> 路径：`网络配置→站点配置→批量配置→交换机接口批量配置`

1. 创建接口模板，模板内配置命令：

```
shutdown
```

>
> 注意：上行口、堆叠成员口、AP 接入端口不要选入该范围。

2. 选择设备对象（全部接入交换机），选择接口范围，例如`GigabitEthernet1/0/25 to GigabitEthernet1/0/48`，下发模板。
3. 下发后配置通过 NETCONF 推送到交换机；**保存设备配置，防止重启丢失**。

>
> 缺点：只能按端口编号范围，**不能自动识别物理 Down 空闲端口**；后期如果要启用端口，需要再次批量下发`undo shutdown`。

>
> ⚠️AD‑Campus 场景禁忌：交换机本地 CLI 手动 shutdown 端口，控制器下发模板会覆盖；尽量全部配置由控制器统一发放。

## 方案二：使用【响应编排】组件（AD‑Campus 内置，实现 “识别物理 Down 端口再关闭”）

>
> 前提：部署了**分析组件 + 响应编排组件**（部分精简版 AD‑Campus 没有该组件）
> 实现逻辑：

1. 通过 NETCONF 采集所有接入交换机接口物理状态（if‑oper‑status）；
2. 筛选出物理状态为`down`的普通 access 端口，过滤上行、trunk、堆叠口；
3. 对筛选出的端口自动下发`shutdown`配置；
4. 可配置定时任务周期执行。

>
> 限制：

- 需要购买响应编排组件许可；
- 只识别**物理层 Down**；端口插网线但终端未开机，端口 PHY 为 Up，不会判定为空闲；
- 风险：运维插网线还未接终端，端口短暂物理 Down，会被脚本直接 shutdown，容易误封端口，生产建议增加延时判断，不要高频自动执行。

## 方案三：设备自动化模板（新开局场景）

新开局接入交换机，在自动化模板内对预留端口直接写死`shutdown`命令。
设备上线自动加载模板，空闲端口直接关闭。

>
> 适合新项目；**已上线存量交换机不适用**。

## 方案四：外部脚本（无响应编排组件时兜底方案）

外部 Python 脚本调用 AD‑Campus 北向 API：

1. API 获取所有接入交换机列表；
2. NETCONF 读取每台交换机所有接口的`display interface brief`；
3. 过滤物理 Down、排除上行 / 堆叠口；
4. NETCONF 下发`shutdown`到对应接口。

>
> 优点：灵活；缺点：需要自己维护脚本，不属于原厂标准交付。

## 重要业务风险点（生产务必注意）

1. **物理 Down≠业务空闲**：网线插上、设备未上电，端口 PHY 就是 Down，会被判定空闲，自动 shutdown；后续设备上电也不会自动打开端口，需要人工`undo shutdown`。

>
> 不建议生产环境做全自动周期自动关闭空闲端口，容易误封端口。

2. **上行口、堆叠口、IRF 物理口必须过滤**，一旦 shutdown 直接设备离线。
3. AD‑Campus 控制器下发配置之后，**务必执行设备配置保存**，否则交换机重启后配置丢失。

## 运维最佳实践建议

1. 存量网络优先使用【方案一】，按端口号范围静态批量关闭预留端口，可控风险最低。
2. 不建议无条件自动检测物理 Down 端口自动 shutdown；如果要做自动，建议增加人工确认步骤，或者仅在夜间维护窗口执行。
3. 预留端口后期需要启用：在批量配置页面下发`undo shutdown`模板。

## 补充排查命令（交换机侧验证）

```
display interface brief
display current‑configuration interface GigabitEthernet 1/0/x
```

看到`shutdown`代表端口管理关闭。