Module sysbot.modules.windows.wsus

Windows Server Update Services Module

This module provides methods for managing and querying Windows Server Update Services (WSUS) including server configuration, update approvals, computer groups, and synchronization using PowerShell WSUS cmdlets.

Classes

class Wsus

Windows Server Update Services management class using PowerShell WSUS cmdlets.

Ancestors

Methods

def get_classification(self, alias: str, **kwargs) ‑> list

Get available update classifications.

Args

alias
Session alias for the connection.
**kwargs
Additional command execution options.

Returns

List of dictionaries containing classification information including Classification and Id.

def get_computer(self, alias: str, computer_name: str = None, **kwargs) ‑> list

Get computers registered with WSUS.

Args

alias
Session alias for the connection.
computer_name
Optional computer name to filter by.
**kwargs
Additional command execution options.

Returns

List of dictionaries containing computer information including FullDomainName, IPAddress, LastReportedStatusTime, LastSyncTime, and OSDescription.

def get_product(self, alias: str, **kwargs) ‑> list

Get available products for updates.

Args

alias
Session alias for the connection.
**kwargs
Additional command execution options.

Returns

List of dictionaries containing product information including Product and Id.

def get_server(self, alias: str, **kwargs) ‑> dict

Get WSUS server information.

Args

alias
Session alias for the connection.
**kwargs
Additional command execution options.

Returns

Dictionary containing WSUS server details including Name, PortNumber, ServerProtocolVersion, and UpdateServer.

def get_status(self, alias: str, **kwargs) ‑> dict

Get WSUS server status and statistics.

Args

alias
Session alias for the connection.
**kwargs
Additional command execution options.

Returns

Dictionary containing WSUS server statistics and status information.

def get_update(self,
alias: str,
update_id: str = None,
classification: str = None,
approval: str = None,
status: str = None,
**kwargs) ‑> list

Get WSUS updates with optional filters.

Args

alias
Session alias for the connection.
update_id
Optional update ID to filter by.
classification
Optional classification to filter by.
approval
Optional approval status to filter by.
status
Optional status to filter by.
**kwargs
Additional command execution options.

Returns

List of dictionaries containing update information including Title, UpdateId, Classification, Approval, ComputersNeedingThisUpdate, and ComputersInstalledThisUpdate.