v2_set_port_pvid
Set a switch port's PVID to route untagged traffic into the correct VLAN, so laptops or rescue consoles work without extra configuration.
Instructions
Set a switch port's PVID — the VLAN an UNTAGGED frame lands on. This is what decides where a laptop plugged straight into the port ends up, and it is what makes a rescue/console port actually work without configuring the laptop. The tagged VLAN list is preserved unless you replace it. Refuses inter-switch trunks unless force:true. [READ-ONLY MODE: returns the exact payload instead of sending it]
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"switchMac": "<switchMac>",
"port": "<port>",
"pvidNetworkName": "<pvidNetworkName>"
},
"name": "v2_set_port_pvid"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| port | Yes | ||
| force | No | ||
| dryRun | No | ||
| siteId | No | ||
| portName | No | Optionally rename the port at the same time — useful when the existing label is wrong. | |
| switchMac | Yes | ||
| pvidNetworkName | Yes | VLAN name or tag number, e.g. "MGMT" or "40". |