unhall0w3d/ruckus-backup-retriever

This project is a PowerShell script that downloads configuration backups from RUCKUS SmartZone and vSZ network controller environments. It is built for network administrators who need a way to pull backups down to a Windows machine, rather than the more common approach of opening an inbound FTP or SFTP connection so the controller can push backups out on its own. The script logs into the SmartZone or vSZ web interface over HTTPS, lists the backup records that are available, and downloads whichever ones it can retrieve. It handles three kinds of backups: system configuration, switch configuration, and cluster backups. Cluster backups are treated as best effort, since RUCKUS does not offer as clean a scheduled export path for them as it does for the other two types. If a cluster backup fails partway through, the script deletes the incomplete file and does not let that failure block the rest of the backup run. On first run the script asks for the SmartZone host address, a folder to save backups into, and login credentials, then remembers those settings for future runs. Credentials are encrypted using a Windows feature called DPAPI, which normally means they can only be decrypted by the same Windows user account on the same machine. Each run creates a folder named with a timestamp, containing the downloaded files along with status and log files describing what happened, including which categories succeeded, failed, or came back empty from the controller. The script has many optional settings, letting an administrator skip cluster backups entirely, change how many historical switch configuration records to keep per device, adjust retry counts, or run diagnostics against the cluster backup endpoint without downloading large files. A separate test script is included that checks the script's internal logic against sample data without performing a real backup. Requirements are Windows PowerShell 5.1 or newer, HTTPS access from the Windows host to the SmartZone controller, and an account on that controller with permission to view and download backups.