Files
napalm-windows/CHANGELOG.md
T
Christian Manivong a508b872b0
driver / standard (pull_request) Successful in 14s
driver / lint (pull_request) Successful in 15s
driver / test (3.12) (pull_request) Failing after 14s
driver / types (pull_request) Failing after 23s
driver / test (3.13) (pull_request) Failing after 13s
driver / lowest (pull_request) Failing after 14s
driver / security (pull_request) Failing after 32s
driver / build (pull_request) Successful in 25s
CI / driver (pull_request) Failing after 1m21s
driver / publish (pull_request) Skipped
feat(scheduled-jobs): the Task Scheduler as scheduled jobs (#8)
netOrk shows and controls every scheduled job of a host; on Windows that
is the Task Scheduler. The driver now implements napalm-device-types'
ScheduledJobsMixin over PowerShell Remoting, one script per call as every
getter does.

get_scheduled_jobs reads every task with its run info in one script
(Get-ScheduledTask, Get-ScheduledTaskInfo) as task:<path><name>, its
triggers summarised. Tasks under \Microsoft\ are the platform's, others
the admin's: Windows does not record which software installed a task.
The time zone is mapped to IANA for the common Windows zones, else None.
A reading cut short, or holding fewer tasks than it counted, raises.

manage_scheduled_job switches the task's own flag or starts it;
Start-ScheduledTask returns once the task has started, so the result says
that and no more. A disabled task, or one that refuses a start on demand,
is not offered run.

put_scheduled_job registers an application's task \<name> in the root
folder from XML, so a create and a change write the whole definition the
same way: the command runs in cmd.exe /d /s /c, the principal is SYSTEM
or a local user without a stored password (S4U), and the cron expression
becomes triggers only where Task Scheduler can say it exactly; any other
shape is refused, naming why. The description keeps the job's name and
cron expression, so the reading gives back what was written, and the
digest also covers the triggers, so a change by hand is seen.
delete_scheduled_job unregisters such a task and no other. Every write
reads the task again first, and every value goes into PowerShell
single-quoted with its quotes doubled.

Requires napalm-device-types 4.26.0.

Closes #8
2026-11-03 05:49:12 +01:00

3.0 KiB
Raw Blame History

Changelog

All notable changes to this driver. The format follows Keep a Changelog, versions follow Semantic Versioning.

[Unreleased]

Added

  • Scheduled jobs: the Task Scheduler as napalm-device-types' ScheduledJobsMixin (#8). get_scheduled_jobs reads every task with its last and next run in one script (Get-ScheduledTask, Get-ScheduledTaskInfo) as task:<path><name>: a task under \Microsoft\ is the platform's, any other the admin's, and a task in the root folder whose description starts with napalm-scheduled-job: <name> an application's. The time zone comes as an IANA name for the common Windows zones, else None. manage_scheduled_job enables, disables (Enable-/Disable-ScheduledTask) or starts one (Start-ScheduledTask, which returns once the task has started). put_scheduled_job registers an application's task \<name> from XML: the command runs in cmd.exe /d /s /c, SYSTEM or a local user without a stored password (S4U), and the cron expression becomes triggers where Task Scheduler can express it exactly; any other shape is refused, naming why. delete_scheduled_job unregisters it. Every write reads the task again first and refuses over a change it did not see. Fixture synthetic.

Changed

  • The floor on napalm-device-types is 4.26.0, which declares the scheduled-jobs contract.
  • Python 3.12 is the floor (requires-python = ">=3.12"): netOrk runs every driver on 3.12, so 3.10 and 3.11 are no longer tested (NAPALM/driver-standard#6).
  • The floor on napalm is 5.1: older releases import pkg_resources, which a Python 3.12 venv no longer has.

Fixed

  • get_arp_table() reports an unknown age as -1.0 (napalm-device-types' ARP_AGE_UNKNOWN) instead of 0.0, which means "confirmed just now": Get-NetNeighbor has a state but no age (NetOrk/netork#1327).

[0.2.0] - 2026-10-23

The first release on PyPI.

Added

  • PowerShell Remoting transport over WinRM (pypsrp), one runspace pool per connection.
  • get_facts, get_interfaces, get_interfaces_ip, get_arp_table, get_route_to.
  • get_services and manage_service (start, stop, restart, enable, disable).
  • get_listening_sockets: every listening TCP and bound UDP socket with its process and, where the process runs one Windows service, that service (netOrk #673). Fixture synthetic.
  • Discovery fingerprints: WinRM ports 5985/5986, Microsoft-HTTPAPI / Microsoft-IIS server headers, Windows SNMP sysDescr, OpenSSH-for-Windows banner.
  • tools/harvest.py to record real script output as test fixtures.

Changed

  • The driver follows the NAPALM driver standard (https://git.netork.io/NAPALM/driver-standard): CI on Gitea runs ruff, mypy, the tests on Python 3.10–3.13 and at the lowest declared versions, bandit, pip-audit and a build check, and a release tag publishes to PyPI. The package now ships py.typed and a LICENSE file. Python 3.9 is no longer supported; napalm-device-types never ran on it, and 4.21.1 from PyPI is now the oldest it accepts.