File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/win_wua.cpython-310.pyc
Back
o ;jǝ � @ s d Z ddlZddlZddlZddlZddlZddlmZ zddl Z dZ W n e y/ dZ Y nw e� e�ZddiZdd � Z d d d �Zd d d �Z d!dd�Zd"dd�Zdd� Zdd� Zdd� Z d#dd�Zdd� Zdd � Zd d � Z dS )$a� Module for managing Windows Updates using the Windows Update Agent. List updates on the system using the following functions: - :py:func:`win_wua.available <salt.modules.win_wua.available>` - :py:func:`win_wua.list <salt.modules.win_wua.list_>` This is an easy way to find additional information about updates available to to the system, such as the GUID, KB number, or description. Once you have the GUID or a KB number for the update you can get information about the update, download, install, or uninstall it using these functions: - :py:func:`win_wua.get <salt.modules.win_wua.get>` - :py:func:`win_wua.download <salt.modules.win_wua.download>` - :py:func:`win_wua.install <salt.modules.win_wua.install>` - :py:func:`win_wua.uninstall <salt.modules.win_wua.uninstall>` The get function expects a name in the form of a GUID, KB, or Title and should return information about a single update. The other functions accept either a single item or a list of items for downloading/installing/uninstalling a specific list of items. The :py:func:`win_wua.list <salt.modules.win_wua.list_>` and :py:func:`win_wua.get <salt.modules.win_wua.get>` functions are utility functions. In addition to returning information about updates they can also download and install updates by setting ``download=True`` or ``install=True``. So, with py:func:`win_wua.list <salt.modules.win_wua.list_>` for example, you could run the function with the filters you want to see what is available. Then just add ``install=True`` to install everything on that list. If you want to download, install, or uninstall specific updates, use :py:func:`win_wua.download <salt.modules.win_wua.download>`, :py:func:`win_wua.install <salt.modules.win_wua.install>`, or :py:func:`win_wua.uninstall <salt.modules.win_wua.uninstall>`. To update your system with the latest updates use :py:func:`win_wua.list <salt.modules.win_wua.list_>` and set ``install=True`` You can also adjust the Windows Update settings using the :py:func:`win_wua.set_wu_settings <salt.modules.win_wua.set_wu_settings>` function. This function is only supported on the following operating systems: - Windows Vista / Server 2008 - Windows 7 / Server 2008R2 - Windows 8 / Server 2012 - Windows 8.1 / Server 2012R2 As of Windows 10 and Windows Server 2016, the ability to modify the Windows Update settings has been restricted. The settings can be modified in the Local Group Policy using the ``lgpo`` module. .. versionadded:: 2015.8.0 :depends: salt.utils.win_update � N)�CommandExecutionErrorTFZlist_�listc C s� t jj�� sdS ts dS t jjjsdS t jj�d�d dkr dS t jj�d�d dkr-d S t jj�d �d dkr:d S t jj�d �d dkrGd S t jj�d�d dkrTdS dS )z4 Only works on Windows systems with PyWin32 )Fz&WUA: Only available on Windows systems)Fz WUA: Requires PyWin32 libraries)Fz8WUA: Missing Libraries required by salt.utils.win_updateZwuauservZ StartTypeZDisabled)Fz?WUA: The Windows Update service (wuauserv) must not be disabledZ msiserver)FzCWUA: The Windows Installer service (msiserver) must not be disabledZBITS)FzLWUA: The Background Intelligent Transfer service (bits) must not be disabledZCryptSvc)FzGWUA: The Cryptographic Services service (CryptSvc) must not be disabledZTrustedInstaller)FzQWUA: The Windows Module Installer service (TrustedInstaller) must not be disabledT)�salt�utils�platformZ is_windows� HAS_PYWIN32� win_updateZ win_service�info� r r �H/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/win_wua.py� __virtual__P s" r c C s> t jjj| d�} | j||||| |||d�} |r| �� S | �� S )a� .. versionadded:: 2017.7.0 List updates that match the passed criteria. This allows for more filter options than :func:`list`. Good for finding a specific GUID or KB. Args: software (:obj:`bool`, optional): Include software updates in the results. Default is ``True``. drivers (:obj:`bool`, optional): Include driver updates in the results. Default is ``True``. summary (:obj:`bool`, optional): - ``True``: Return a summary of updates available for each category. - ``False`` (default): Return a detailed list of available updates. Default is ``False``. skip_installed (:obj:`bool`, optional): Skip updates that are already installed. Default is ``True``. skip_hidden (:obj:`bool`, optional): Skip updates that have been hidden. Default is ``True``. skip_mandatory (:obj:`bool`, optional): Skip mandatory updates. Default is ``False``. skip_reboot (:obj:`bool`, optional): Skip updates that require a reboot. Default is ``False``. categories (:obj:`list`, optional): Specify the categories to list. Must be passed as a list. All categories returned by default. Categories include the following: * Critical Updates * Definition Updates * Drivers (make sure you set ``drivers=True``) * Feature Packs * Security Updates * Update Rollups * Updates * Update Rollups * Windows 7 * Windows 8.1 * Windows 8.1 drivers * Windows 8.1 and later drivers * Windows Defender Default is ``None``. severities (:obj:`list`, optional): Specify the severities to include. Must be passed as a list. All severities returned by default. Severities include the following: * Critical * Important Default is ``None``. online (:obj:`bool`, optional): Tells the Windows Update Agent go online to update its local update database. ``True`` will go online. ``False`` will use the local update database as is. Default is ``True`` .. versionadded:: 3001 Default is ``True``. Returns: dict: Returns a dict containing either a summary or a list of updates: .. code-block:: cfg Dict of Updates: {'<GUID>': { 'Title': <title>, 'KB': <KB>, 'GUID': <the globally unique identifier for the update>, 'Description': <description>, 'Downloaded': <has the update been downloaded>, 'Installed': <has the update been installed>, 'Mandatory': <is the update mandatory>, 'UserInput': <is user input required>, 'EULAAccepted': <has the EULA been accepted>, 'Severity': <update severity>, 'NeedsReboot': <is the update installed and awaiting reboot>, 'RebootBehavior': <will the update require a reboot>, 'Categories': [ '<category 1>', '<category 2>', ... ] }} Summary of Updates: {'Total': <total number of updates returned>, 'Available': <updates that are not downloaded or installed>, 'Downloaded': <updates that are downloaded but not installed>, 'Installed': <updates installed (usually 0 unless installed=True)>, 'Categories': { <category 1>: <total for that category>, <category 2>: <total for category 2>, ... } } CLI Examples: .. code-block:: bash # Normal Usage (list all software updates) salt '*' win_wua.available # List all updates with categories of Critical Updates and Drivers salt '*' win_wua.available categories='["Critical Updates","Drivers"]' # List all Critical Security Updates salt '*' win_wua.available categories='["Security Updates"]' severities='["Critical"]' # List all updates with a severity of Critical salt '*' win_wua.available severities='["Critical"]' # A summary of all available updates salt '*' win_wua.available summary=True # A summary of all Feature Packs and Windows 8.1 Updates salt '*' win_wua.available categories='["Feature Packs","Windows 8.1"]' summary=True ��online)� skip_hidden�skip_installed�skip_mandatory� skip_reboot�software�drivers� categories� severities)r r r �WindowsUpdateAgent� available�summaryr ) r r r r r r r r r r �wua�updatesr r r r � s � r c C sV t jjj|d�}|�| �}i }|s|r|�|�|d< |r#|�|�|d< |r'|S |�� S )a .. versionadded:: 2017.7.0 Returns details for the named update Args: name (str): The name of the update you're searching for. This can be the GUID, a KB number, or any part of the name of the update. GUIDs and KBs are preferred. Run ``list`` to get the GUID for the update you're looking for. download (:obj:`bool`, optional): Download the update returned by this function. Run this function first to see if the update exists, then set ``download=True`` to download the update. Default is ``False``. install (:obj:`bool`, optional): Install the update returned by this function. Run this function first to see if the update exists, then set ``install=True`` to install the update. Default is ``False``. online (:obj:`bool`, optional): Tells the Windows Update Agent go online to update its local update database. ``True`` will go online. ``False`` will use the local update database as is. Default is ``True``. .. versionadded:: 3001 Returns: dict: Returns a dict containing a list of updates that match the name if download and install are both set to False. Should usually be a single update, but can return multiple if a partial name is given. If download or install is set to true it will return the results of the operation. .. code-block:: cfg Dict of Updates: {'<GUID>': { 'Title': <title>, 'KB': <KB>, 'GUID': <the globally unique identifier for the update>, 'Description': <description>, 'Downloaded': <has the update been downloaded>, 'Installed': <has the update been installed>, 'Mandatory': <is the update mandatory>, 'UserInput': <is user input required>, 'EULAAccepted': <has the EULA been accepted>, 'Severity': <update severity>, 'NeedsReboot': <is the update installed and awaiting reboot>, 'RebootBehavior': <will the update require a reboot>, 'Categories': [ '<category 1>', '<category 2>', ... ] }} CLI Examples: .. code-block:: bash # Recommended Usage using GUID without braces # Use this to find the status of a specific update salt '*' win_wua.get 12345678-abcd-1234-abcd-1234567890ab # Use the following if you don't know the GUID: # Using a KB number # Not all updates have an associated KB salt '*' win_wua.get KB3030298 # Using part or all of the name of the update # Could possibly return multiple results # Not all updates have an associated KB salt '*' win_wua.get 'Microsoft Camera Codec Pack' r �Download�Install)r r r r �search�download�installr )�namer r r r r �retr r r �get1 s Y r# c C sl t jjj|d�} | j|| |||d�} i } |s|r | �| �| d< |r(| �| �| d< | s4|r0| �� S | �� S | S )ae .. versionadded:: 2017.7.0 Returns a detailed list of available updates or a summary. If ``download`` or ``install`` is ``True`` the same list will be downloaded and/or installed. Args: software (:obj:`bool`, optional): Include software updates in the results. Default is ``True``. drivers (:obj:`bool`, optional): Include driver updates in the results. Default is ``False`` summary (:obj:`bool`, optional): - ``True``: Return a summary of updates available for each category. - ``False`` (default): Return a detailed list of available updates. Default is ``False``. skip_installed (:obj:`bool`, optional): Skip installed updates in the results. Default is ``True``. categories (list): Specify the categories to list. Must be passed as a list. All categories returned by default. Categories include the following: * Critical Updates * Definition Updates * Drivers (make sure you set ``drivers=True``) * Feature Packs * Security Updates * Update Rollups * Updates * Update Rollups * Windows 7 * Windows 8.1 * Windows 8.1 drivers * Windows 8.1 and later drivers * Windows Defender Default is ``None``. severities (list): Specify the severities to include. Must be passed as a list. All severities returned by default. Severities include the following: * Critical * Important Default is ``None``. download (bool): (Overrides reporting functionality) Download the list of updates returned by this function. Run this function first with ``download=False`` to see what will be downloaded, then set ``download=True`` to download the updates. Default is ``False``. install (bool): (Overrides reporting functionality) Install the list of updates returned by this function. Run this function first with ``install=False`` to see what will be installed, then set ``install=True`` to install the updates. Default is ``False``. online (bool): Tells the Windows Update Agent go online to update its local update database. ``True`` will go online. ``False`` will use the local update database as is. Default is ``True``. .. versionadded:: 3001 Returns: dict: Returns a dict containing either a summary or a list of updates: .. code-block:: cfg Dict of Updates: {'<GUID>': { 'Title': <title>, 'KB': <KB>, 'GUID': <the globally unique identifier for the update>, 'Description': <description>, 'Downloaded': <has the update been downloaded>, 'Installed': <has the update been installed>, 'Mandatory': <is the update mandatory>, 'UserInput': <is user input required>, 'EULAAccepted': <has the EULA been accepted>, 'Severity': <update severity>, 'NeedsReboot': <is the update installed and awaiting reboot>, 'RebootBehavior': <will the update require a reboot>, 'Categories': [ '<category 1>', '<category 2>', ... ] }} Summary of Updates: {'Total': <total number of updates returned>, 'Available': <updates that are not downloaded or installed>, 'Downloaded': <updates that are downloaded but not installed>, 'Installed': <updates installed (usually 0 unless installed=True)>, 'Categories': { <category 1>: <total for that category>, <category 2>: <total for category 2>, ... } } CLI Examples: .. code-block:: bash # Normal Usage (list all software updates) salt '*' win_wua.list # List all updates with categories of Critical Updates and Drivers salt '*' win_wua.list categories='["Critical Updates","Drivers"]' # List all Critical Security Updates salt '*' win_wua.list categories='["Security Updates"]' severities='["Critical"]' # List all updates with a severity of Critical salt '*' win_wua.list severities='["Critical"]' # A summary of all available updates salt '*' win_wua.list summary=True # A summary of all Feature Packs and Windows 8.1 Updates salt '*' win_wua.list categories='["Feature Packs","Windows 8.1"]' summary=True r )r r r r r r r ) r r r r r r r r r ) r r r r r r r r r r r r" r r r r � s" �c C s^ t jjjdd�}|�� }|�� }|r't� }|D ] }|�|| d � qt|�S | r-|� � S |S )a3 .. versionadded:: 3001 Get a list of all updates that are currently installed on the system. .. note:: This list may not necessarily match the Update History on the machine. This will only show the updates that apply to the current build of Windows. So, for example, the system may have shipped with Windows 10 Build 1607. That machine received updates to the 1607 build. Later the machine was upgraded to a newer feature release, 1803 for example. Then more updates were applied. This will only return the updates applied to the 1803 build and not those applied when the system was at the 1607 build. Args: summary (:obj:`bool`, optional): Return a summary instead of a detailed list of updates. ``True`` will return a Summary, ``False`` will return a detailed list of installed updates. Default is ``False``. kbs_only (:obj:`bool`, optional): Only return a list of KBs installed on the system. If this parameter is passed, the ``summary`` parameter will be ignored. Default is ``False``. Returns: dict: Returns a dictionary of either a Summary or a detailed list of updates installed on the system when ``kbs_only=False`` list: Returns a list of KBs installed on the system when ``kbs_only=True`` CLI Examples: .. code-block:: bash # Get a detailed list of all applicable updates installed on the system salt '*' win_wua.installed # Get a summary of all applicable updates installed on the system salt '*' win_wua.installed summary=True # Get a simple list of KBs installed on the system salt '*' win_wua.installed kbs_only=True Fr ZKBs) r r r r � installedr �set�update�sortedr )r Zkbs_onlyr r �resultsZlist_kbs�itemr r r r$ T s 7r$ c C �p t jj�� }|�| �}|�� dkrtd��t| t�r | g} t| t �r't| �g} |�� t | �kr3td��|� |�S )a+ .. versionadded:: 2017.7.0 Downloads updates that match the list of passed identifiers. It's easier to use this function by using list_updates and setting ``download=True``. Args: names (str, list): A single update or a list of updates to download. This can be any combination of GUIDs, KB numbers, or names. GUIDs or KBs are preferred. .. note:: An error will be raised if there are more results than there are items in the names parameter Returns: dict: A dictionary containing the details about the downloaded updates CLI Example: .. code-block:: bash # Normal Usage salt '*' win_wua.download names=['12345678-abcd-1234-abcd-1234567890ab', 'KB2131233'] r �No updates found�6Multiple updates found, names need to be more specific) r r r r r �countr � isinstance�str�int�lenr ��namesr r r r r r � � � r c C r* )a� .. versionadded:: 2017.7.0 Installs updates that match the list of identifiers. It may be easier to use the list_updates function and set ``install=True``. Args: names (str, list): A single update or a list of updates to install. This can be any combination of GUIDs, KB numbers, or names. GUIDs or KBs are preferred. .. note:: An error will be raised if there are more results than there are items in the names parameter Returns: dict: A dictionary containing the details about the installed updates CLI Examples: .. code-block:: bash # Normal Usage salt '*' win_wua.install KB12323211 r r+ r, ) r r r r r r- r r. r/ r0 r1 r r2 r r r r � r4 r c C s4 t jj�� }|�| �}|�� dkrtd��|�|�S )aV .. versionadded:: 2017.7.0 Uninstall updates. Args: names (str, list): A single update or a list of updates to uninstall. This can be any combination of GUIDs, KB numbers, or names. GUIDs or KBs are preferred. Returns: dict: A dictionary containing the details about the uninstalled updates CLI Examples: .. code-block:: bash # Normal Usage salt '*' win_wua.uninstall KB3121212 # As a list salt '*' win_wua.uninstall guid=['12345678-abcd-1234-abcd-1234567890ab', 'KB1231231'] r r+ )r r r r r r- r � uninstallr2 r r r r5 s r5 c C s` ddi}t jj�� � tj�d�}|j} W d � n1 s w Y | durAt| �| _ | � � } | du r9| |d< nd|d< d|d< |dur]|| _ | � � } | du rU||d < nd|d< d|d< |dury|| _ | � � } | du rq||d < nd|d< d|d< |dur�|| _ | � � } | du r�||d < nd|d< d|d< |dur�d d ddddddd�} || vr�d|d< d|d< n| | | _| � � } | du r�||d< nd|d< d|d< |du�rt|t�s�d�|�|d< d|d< n0d|vr�d�|�|d< d|d< n |�d�} | d | _ | � � } | du �r ||d< nd|d< d|d< |du�r�t jj�� �� tj�d�} d | _|�r^z | �d dd � ||d < W nb t�y] } z|j\}}}}d |d � �|d< d|d< W Y d}~n@d}~ww t� �r�z | �d � ||d < W n+ t�y� } z|j\}}}}d |d � �|d< d|d< W Y d}~n d}~ww ||d < W d � n 1 �s�w Y t� |d!< |S )"a� Change Windows Update settings. If no parameters are passed, the current value will be returned. Supported: - Windows Vista / Server 2008 - Windows 7 / Server 2008R2 - Windows 8 / Server 2012 - Windows 8.1 / Server 2012R2 .. note: Microsoft began using the Unified Update Platform (UUP) starting with Windows 10 / Server 2016. The Windows Update settings have changed and the ability to 'Save' Windows Update settings has been removed. Windows Update settings are read-only. See MSDN documentation: https://msdn.microsoft.com/en-us/library/aa385829(v=vs.85).aspx Args: level (:obj:`int`, optional): Number from 1 to 4 indicating the update level: 1. Never check for updates 2. Check for updates but let me choose whether to download and install them 3. Download updates but let me choose whether to install them 4. Install updates automatically Default is ``None``. recommended (:obj:`bool`, optional): Boolean value that indicates whether to include optional or recommended updates when a search for updates and installation of updates is performed. Default is ``None``. featured (:obj:`bool`, optional): Boolean value that indicates whether to display notifications for featured updates. Default is ``None``. elevated (:obj:`bool`, optional): Boolean value that indicates whether non-administrators can perform some update-related actions without administrator approval. Default is ``None``. msupdate (:obj:`bool`, optional): Boolean value that indicates whether to turn on Microsoft Update for other Microsoft products. Default is ``None``. day (:obj:`str`, optional): Days of the week on which Automatic Updates installs or uninstalls updates. Accepted values: - Everyday - Monday - Tuesday - Wednesday - Thursday - Friday - Saturday Default is ``None``. time (:obj:`str`, optional): Time at which Automatic Updates installs or uninstalls updates. Must be in the ##:## 24hr format, eg. 3:00 PM would be 15:00. Must be in 1 hour increments. Default is ``None``. Returns: dict: Returns a dictionary containing the results. CLI Examples: .. code-block:: bash salt '*' win_wua.set_wu_settings level=4 recommended=True featured=False ZSuccessT�Microsoft.Update.AutoUpdateNZLevelz+Settings failed to save. Check permissions.�CommentFZ RecommendedZFeaturedZElevatedr � � � � � � � )ZEveryday�Sunday�Monday�Tuesday� Wednesday�Thursday�Friday�SaturdayzfDay needs to be one of the following: Everyday, Monday, Tuesday, Wednesday, Thursday, Friday, SaturdayZDayzVTime argument needs to be a string; it may need to be quoted. Passed {}. Time not set.�:zCTime argument needs to be in 00:00 format. Passed {}. Time not set.ZTime� Microsoft.Update.ServiceManagerzMy Appz$7971f918-a847-4430-9279-4a52d1efe18d� �msupdatezFailed with failure code: ZReboot)r r �winapi�Com�win32com�client�Dispatch�Settingsr0 �NotificationLevelZSave�IncludeRecommendedUpdates�FeaturedUpdatesEnabled�NonAdministratorsElevated�ScheduledInstallationDayr. r/ �format�splitZClientApplicationIDZ AddService2� Exception�args�_get_msupdate_statusZ RemoveService�get_needs_reboot)�levelZ recommendedZfeaturedZelevatedrI �day�timer" �obj_au�obj_au_settings�result�days�t�obj_sm�error�hr�msg�exc�argr r r �set_wu_settings+ s� u � � � � � ��� ���� � 2ri c C s� i } g d�}t jj�� �_ tj�d�}|j}|j| d< |j | d< t � | d< t � | d< |j | d< |j | d< |j| d < |j| d < ||j | d < |jd k rSd �|j�| d< nd�|j�| d< W d � | S W d � | S 1 snw Y | S )ae Get current Windows Update settings. Returns: dict: A dictionary of Windows Update settings: Featured Updates: Boolean value that indicates whether to display notifications for featured updates. Group Policy Required (Read-only): Boolean value that indicates whether Group Policy requires the Automatic Updates service. Microsoft Update: Boolean value that indicates whether to turn on Microsoft Update for other Microsoft Products Needs Reboot: Boolean value that indicates whether the machine is in a reboot pending state. Non Admins Elevated: Boolean value that indicates whether non-administrators can perform some update-related actions without administrator approval. Notification Level: Number 1 to 4 indicating the update level: 1. Never check for updates 2. Check for updates but let me choose whether to download and install them 3. Download updates but let me choose whether to install them 4. Install updates automatically Read Only (Read-only): Boolean value that indicates whether the Automatic Update settings are read-only. Recommended Updates: Boolean value that indicates whether to include optional or recommended updates when a search for updates and installation of updates is performed. Scheduled Day: Days of the week on which Automatic Updates installs or uninstalls updates. Scheduled Time: Time at which Automatic Updates installs or uninstalls updates. CLI Examples: .. code-block:: bash salt '*' win_wua.get_wu_settings )z Every Dayr? r@ rA rB rC rD rE r6 zFeatured UpdateszGroup Policy Required�Microsoft Updatez Needs RebootzNon Admins ElevatedzNotification Levelz Read OnlyzRecommended Updatesz Scheduled Day� z0{}:00zScheduled Timez{}:00N)r r rJ rK rL rM rN rO rR ZRequiredrY rZ rS rP ZReadOnlyrQ rT ZScheduledInstallationTimerU )r" r\ r^ r_ r r r �get_wu_settingsC s8 < � � � � � � rl c C sj t jj�� �% tj�d�} | j}|D ]}|jdkr" W d � dS qW d � dS 1 s.w Y dS )zH Check to see if Microsoft Update is Enabled Return Boolean rG rj NTF) r r rJ rK rL rM rN ZServicesr! )rc Z col_servicesZservicer r r rY � s � � � � rY c C s t jj�� S )z� Determines if the system needs to be rebooted. Returns: bool: ``True`` if the system requires a reboot, otherwise ``False`` CLI Examples: .. code-block:: bash salt '*' win_wua.get_needs_reboot )r r r Z needs_rebootr r r r rZ � s rZ ) TTFTTFFNNT)FFT) TFFTNNFFT)FF)NNNNNNN) �__doc__�loggingZsalt.utils.platformr Zsalt.utils.win_serviceZsalt.utils.win_updateZsalt.utils.winapiZsalt.exceptionsr Zwin32com.clientrL r � ImportError� getLogger�__name__�logZ__func_alias__r r r# r r$ r r r5 ri rl rY rZ r r r r �<module> st 9 � �1 � 2l � 9D66( � i
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings