File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/utils/__pycache__/win_update.cpython-310.pyc
Back
o ;j,� � @ s� d Z ddlZddlZddlZddlZddlZddlmZ z ddl Z ddl Z dZ W n e y3 dZ Y nw e�e�Zdddd �Zd Zd d � ZG d d� d�ZG dd� d�Zdd� ZdS )z/ Classes for working with Windows Update Agent � N)�CommandExecutionErrorTFzNever Requires RebootzAlways Requires RebootzCan Require Reboot)r � � Z win_updatec C s t jj�� sdS ts dS tS )N)Fz%win_update: Only available on Windows)Fzwin_update: Missing pywin32)�salt�utils�platformZ is_windows� HAS_PYWIN32�__virtualname__� r r �I/opt/saltstack/salt/lib/python3.10/site-packages/salt/utils/win_update.py� __virtual__ s r c @ s: e Zd ZdZddd�Zdd� Zdd� Zd d � Zd d � Zd S )�Updatesa] Wrapper around the 'Microsoft.Update.UpdateColl' instance Adds the list and summary functions. For use by the WindowUpdateAgent class. Code Example: .. code-block:: python # Create an instance updates = Updates() # Bind to the collection object found = updates.updates # This exposes Collections properties and methods # https://msdn.microsoft.com/en-us/library/windows/desktop/aa386107(v=vs.85).aspx found.Count found.Add # To use custom functions, use the original instance # Return the number of updates inside the collection updates.count() # Return a list of updates in the collection and details in a dictionary updates.list() # Return a summary of the contents of the updates collection updates.summary() ZSoftwareZDriver)r r c C s@ t jj�� � tj�d�| _W d � dS 1 sw Y dS )zd Initialize the updates collection. Can be accessed via ``Updates.updates`` �Microsoft.Update.UpdateCollN)r r �winapi�Com�win32com�client�Dispatch�updates��selfr r r �__init__I s "�zUpdates.__init__c C s | j jS )aN Return how many records are in the Microsoft Update Collection Returns: int: The number of updates in the collection Code Example: .. code-block:: python import salt.utils.win_update updates = salt.utils.win_update.Updates() updates.count() )r �Countr r r r �countQ s z Updates.countc C s | � � dkrdS t�d� i }| jD ]s}zt|jj�}W n ty, t�d� d}Y nw z|jj}W n tyC t�d� d}Y nw |j j t |j �| j |j |jt|j�t|j�t|j�t|j�t|j�t |j�|t| dd� |jD �d d� |jD �|jd �||j j < q|S ) a� Create a dictionary with the details for the updates in the collection. Returns: dict: Details about each update .. 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>', ... ] }} Code Example: .. code-block:: python import salt.utils.win_update updates = salt.utils.win_update.Updates() updates.list() r �Nothing to returnz*Building a detailed report of the results.�=Windows Update: Error reading InstallationBehavior COM ObjectFr c S � g | ]}d | �qS �ZKBr ��.0�itemr r r � <listcomp>� � z Updates.list.<locals>.<listcomp>c S s g | ]}|j �qS r )�Namer r r r r! � s )Zguid�Title�Type� Description� Downloaded� InstalledZ MandatoryZ EULAAccepted� NeedsReboot�SeverityZ UserInput�RebootBehaviorZKBs� Categories� SupportUrl)r �log�debugr �bool�InstallationBehaviorZCanRequestUserInput�AttributeErrorr+ �Identity�UpdateID�strr$ � update_typesr% r& � IsDownloaded� IsInstalled� IsMandatory� EulaAccepted�RebootRequired� MsrcSeverity�REBOOT_BEHAVIOR� KBArticleIDsr, r- )r �results�updateZ user_input�requires_rebootr r r �listb sL & �� �� �z Updates.listc C s< | � � dkrdS ddddi i d�}| jD ]�}|d d7 < tjj�|j�s6tjj�|j�s6|d d7 < tjj�|j�rNtjj�|j�sN|d d7 < tjj�|j�r^|d d7 < |jD ] }|j |d v rv|d |j d7 < qad|d |j < qa|j r�|j |d v r�|d |j d7 < qd|d |j < q|S ) ah Create a dictionary with a summary of the updates in the collection. Returns: dict: Summary of the contents of the collection .. code-block:: cfg 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>, ... } } Code Example: .. code-block:: python import salt.utils.win_update updates = salt.utils.win_update.Updates() updates.summary() r r )�Total� Availabler' r( r, r* rC r rD r' r( r, r* ) r r r r �data�is_truer7 r8 r, r# r< )r r? r@ �categoryr r r �summary� sF � ���� �zUpdates.summaryN) �__name__� __module__� __qualname__�__doc__r6 r r rB rH r r r r r ( s Yr c @ s� e Zd ZdZi dd�dd�dd�dd �d d �d d �dd�dd�dd�dd�dd�dd�dd�d d �d d �d d!�d"d#�d$d%d&d'd(d)d*d+d,��ZdDd.d/�Zd0d1� ZdDd2d3�Zd4d5� Z - - 6 6 - - 7 7dEd8d9�Z d:d;� Z d<d=� Z d>d?� Z d@dA� Z dBdC� Zd7S )F�WindowsUpdateAgentz9 Class for working with the Windows update agent i,@$�z'WinHTTP Send/Receive failed: 0x8024402Ci4 $�zDownload failed: 0x80240034i2 $�z#Invalid search criteria: 0x80240032i/ $�z Cancelled by policy: 0x8024002Fi- $�zMissing source: 0x8024002Di, $�zMissing source: 0x8024002C�( $�z!Uninstall not allowed: 0x80240028i% $�z Prevented by policy: 0x80240025i$ $�zNo Updates: 0x80240024i $�z"Service being shutdown: 0x8024001Ei $�z#Self Update in Progress: 0x8024001Bi $�z&Exclusive Install Conflict: 0x80240019i $�z Install not allowed: 0x80240016i $�zDuplicate item: 0x80240013i $�z Operation cancelled: 0x8024000Bi $�z!Operation in progress: 0x80240009iD $�zAccess Denied: 0x8024044z$Unsupported search scope: 0x80240045z Access is denied: 0x80070005z Setup in progress: 0x8024004Az!Install still pending: 0x00242015z Already downloaded: 0x00240008z Already uninstalled: 0x00240007z Already installed: 0x00240006zReboot required: 0x00240005)iE $�i �l����J H l�����_� l������ l������ l������ l������ Tc C sX t jj�� � tj�d�| _tj�d�| _W d � n1 s w Y | j |d� dS )aT Initialize the session and load all updates into the ``_updates`` collection. This collection is used by the other class functions instead of querying Windows update (expensive). Args: 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 Need to look at the possibility of loading this into ``__context__`` zMicrosoft.Update.Sessionr N��online) r r r r r r r �_session�_updates�refresh)r rP r r r r 1 s �zWindowsUpdateAgent.__init__c C s& t � }|j}| jD ]}|�|� q |S )aV Get the contents of ``_updates`` (all updates) and puts them in an Updates class to expose the list and summary functions. Returns: Updates: An instance of the Updates class with all updates for the system. Code Example: .. code-block:: python import salt.utils.win_update wua = salt.utils.win_update.WindowsUpdateAgent() updates = wua.updates() # To get a list updates.list() # To get a summary updates.summary() )r r rR �Add)r r �foundr@ r r r r M s zWindowsUpdateAgent.updatesc C s� d}| j �� }||_d| j _z|�|�}|jjdkr&t�d|� d|� �W S W n7 t j y^ } z*|j \}}}} z | j |d } W n t yN d|� �} Y nw t�d| |� t| ��d }~ww |j| _d S ) a� Refresh the contents of the ``_updates`` collection. This gets all updates in the Windows Update system and loads them into the collection. This is the part that is slow. Args: 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 Code Example: .. code-block:: python import salt.utils.win_update wua = salt.utils.win_update.WindowsUpdateAgent() wua.refresh() z Type='Software' or Type='Driver'zSalt: Load Updatesr zNo Updates found for: %szNo Updates found: � �Unknown Failure: zSearch Failed: %s %sN)rQ ZCreateUpdateSearcherZOnline�ClientApplicationIDZSearchr r r. r/ � pywintypes� com_error�args� fail_codes�KeyError�errorr rR ) r rP � search_stringZsearcherr? r^ �hr�msg�exc�arg� failure_coder r r rS n s, � ��� zWindowsUpdateAgent.refreshc C s2 t � }| jD ]}tjj�|j�r|j�|� q|S )a� Gets a list of all updates available on the system that have the ``IsInstalled`` attribute set to ``True``. Returns: Updates: An instance of Updates with the results. Code Example: .. code-block:: python import salt.utils.win_update wua = salt.utils.win_update.WindowsUpdateAgent(online=False) installed_updates = wua.installed() ) r rR r r rE rF r8 r rT )r r r@ r r r � installed� s �z WindowsUpdateAgent.installedFNc C s( t � } | j} | jD ]�} z&tjj�| j�r|rW q tjj�| j�r$|r$W q tjj�| j �r0|r0W q W n t y: Y q w z tjj�| j j �} W n t yV t �d� d} Y nw | r\|r\q |sd| jdkrdq |sl| jdkrlq |dur�d} | jD ] }|j|v r~d} qu| s�q |dur�| j|vr�q | �| � q | S )a� Gets a list of all updates available on the system that match the passed criteria. Args: skip_hidden (bool): Skip hidden updates. Default is ``True`` skip_installed (bool): Skip installed updates. Default is ``True`` skip_mandatory (bool): Skip mandatory updates. Default is ``False`` skip_reboot (bool): Skip updates that can or do require reboot. Default is ``False`` software (bool): Include software updates. Default is ``True`` drivers (bool): Include driver updates. Default is ``True`` categories (list): Include updates that have these categories. Default is none (all categories). 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 severities (list): Include updates that have these severities. Default is none (all severities). Severities include the following: * Critical * Important .. note:: All updates are either software or driver updates. If both ``software`` and ``drivers`` is ``False``, nothing will be returned. Returns: Updates: An instance of Updates with the results of the search. Code Example: .. code-block:: python import salt.utils.win_update wua = salt.utils.win_update.WindowsUpdateAgent() # Gets all updates and shows a summary updates = wua.available() updates.summary() # Get a list of Critical updates updates = wua.available(categories=['Critical Updates']) updates.list() r Tr r NF)r r rR r r rE rF ZIsHiddenr8 r9 r2 r1 r+ r. r/ r% r, r# r< rT )r Z skip_hiddenZskip_installedZskip_mandatoryZ skip_rebootZsoftwareZdrivers� categoriesZ severitiesr rU r@ rA �matchrG r r r � available� sV U � �� �� � z WindowsUpdateAgent.availablec C s� t � }|j}t|t�r|g}t|t�rt|�g}| jD ]>}|D ]9}||jjkr-|�|� q |dd� |j D �v r=|�|� q |dd� |j D �v rM|�|� q ||j v rX|�|� q q q|S )a; Search for either a single update or a specific list of updates. GUIDs are searched first, then KB numbers, and finally Titles. Args: search_string (str, list): The search string to use to find the update. This can be the GUID or KB of the update (preferred). It can also be the full Title of the update or any part of the Title. A partial Title search is less specific and can return multiple results. Returns: Updates: An instance of Updates with the results of the search Code Example: .. code-block:: python import salt.utils.win_update wua = salt.utils.win_update.WindowsUpdateAgent() # search for a single update and show its details updates = wua.search('KB3194343') updates.list() # search for a list of updates and show their details updates = wua.search(['KB3195432', '12345678-abcd-1234-abcd-1234567890ab']) updates.list() c S r r r r r r r r! z r" z-WindowsUpdateAgent.search.<locals>.<listcomp>c S s g | ]}|�qS r r r r r r r! s ) r r � isinstancer5 �intrR r3 r4 rT r> r$ )r r_ r rU r@ �findr r r �searchH s. ��zWindowsUpdateAgent.searchc C sn |� � dkr ddd�}|S | j�� }d| j_tjj�� �� tj � d�}di i}|j D ]M}|j j }i |d |< |j|d | d< t|j�|d | d < tjj�|j�s^t�d |j� |�� tjj�|j�sxt�d |� t�d |j� |�|� q+|jdkr�d dd�}|W d � S ||_z t�d� |�� }W n6 tj y� } z)|j \} } } } z | j | d } W n t y� d|� �} Y nw t� d| � t!| ��d}~ww ddddddd�}t�d� t�||j" � ||j" |d< |j"d v r�t�d � d |d < n t�d� d|d < t#|j�D ]}|�$|�j j }||�%|�j" |d | d < �q W d � |S 1 �s0w Y |S ) a� Download the updates passed in the updates collection. Load the updates collection using ``search`` or ``available`` Args: updates (Updates): An instance of the Updates class containing a the updates to be downloaded. Returns: dict: A dictionary containing the results of the download Code Example: .. code-block:: python import salt.utils.win_update wua = salt.utils.win_update.WindowsUpdateAgent() # Download KB3195454 updates = wua.search('KB3195454') results = wua.download(updates) r FzNothing to download��Successr zSalt: Download Updater r r$ ZAlreadyDownloadedzAccepting EULA: %szTo Be Downloaded: %s� Title: %sTNzDownloading UpdatesrV rW zDownload Failed: %szDownload Not StartedzDownload In ProgresszDownload Succeededz Download Succeeded With ErrorszDownload FailedzDownload Aborted�r r r � � rV zDownload Complete�Message�r rq zDownloaded Successfullyrn �Result)&r rQ ZCreateUpdateDownloaderrX r r r r r r r r r3 r4 r$ r0 r7 rE rF r: r. r/ Z AcceptEularT r r ZDownloadrY rZ r[ r\ r] r^ r � ResultCode�range�Item�GetUpdateResult)r r �retZ downloaderZ download_listr@ �uid�resultr^ r` ra rb rc rd � result_code�ir r r �download� s� � � � �� � �� �M�MzWindowsUpdateAgent.downloadc C s� |� � dkr ddd�}|S | j�� }d| j_tjj�� ��' tj � d�}di i}|j D ]:}|j j }i |d |< |j|d | d< t|j�|d | d < tjj�|j�set�d |� t�d |j� |�|� q+|jdkryd dd�}|W d � S ||_z t�d� |�� }W n6 tjy� } z)|j\} } } } z | j | d } W n t y� d|� �} Y nw t� d| � t | ��d }~ww ddddddd�}t�d� t�||j � ||j |d< |j dv r�d |d < |j!|d < t�d |j!� n t�d � d|d < t"|j�D ]<}|�#|�j j }||�$|�j |d | d < z |�#|�j%j&}W n t'�y0 t�d!� d"}Y nw t(| |d | d#< q�W d � |S 1 �sHw Y |S )$a# Install the updates passed in the updates collection. Load the updates collection using the ``search`` or ``available`` functions. If the updates need to be downloaded, use the ``download`` function. Args: updates (Updates): An instance of the Updates class containing a the updates to be installed. Returns: dict: A dictionary containing the results of the installation Code Example: .. code-block:: python import salt.utils.win_update wua = salt.utils.win_update.WindowsUpdateAgent() # install KB3195454 updates = wua.search('KB3195454') results = wua.download(updates) results = wua.install(updates) r FzNothing to installrm zSalt: Install Updater r r$ ZAlreadyInstalledzTo Be Installed: %sro TNzInstalling UpdatesrV rW zInstall Failed: %szInstallation Not StartedzInstallation In ProgresszInstallation Succeededz"Installation Succeeded With ErrorszInstallation FailedzInstallation Abortedrp zInstall Completers rt rn r) �NeedsReboot: %szInstall Failedru r r r+ ))r rQ �CreateUpdateInstallerrX r r r r r r r r r3 r4 r$ r0 r8 rE rF r. r/ rT r r ZInstallrY rZ r[ r\ r] r^ r rv r; rw rx ry r1 r+ r2 r= )r r rz � installerZ install_listr@ r{ r| r^ r` ra rb rc rd r} r~ �reboot_behaviorr r r �install� s� � � � �� � ������ �V�VzWindowsUpdateAgent.installc C s� |� � dkr ddd�}|S | j�� }d| j_tjj�� ��" tj � d�}di i}|j D ];}|j j }i |d |< |j|d | d< t|j� |d | d < tjj�|j�rft�d |� t�d |j� |�|� q+|jdkrzddd�}|W d � S ||_z t�d � |�� }W �n- tj�y� } �z |j\} } } } z | j | d } W n t y� d|� �} Y nw | d dk�r�t�d� zB|D ]=}|j D ]7}g d�}| � |�d � � }|D ]%}d| |�!� v r�|�"d�d }||d< dddd|� �dd g}| � |� q�q�q�W n( t#�y) } zt�d � t�d d �$|�� t�d | � t#d!| � ���d } ~ ww t�d"� d#|d$< d%|d&< t%� |d'< t�d(|d' � | j&dd)� | j'D ]K}|j j }|D ]A}|j j |k�r�|j�skd*|d | d+< nd,|d | d+< z|j(j)}W n t*�y� t�d-� d.}Y nw t+| |d | d/< �qU�qM|W Y d }~W d � S t�,d0| � t#| ��d }~ww d1d2d*d3d,d4d5�}t�d6� t�||j- � ||j- |d&< |j-d7v �r�d#|d$< |j.|d'< t�d(|j.� n t�d8� d|d$< t/|j�D ]=}|�0|�j j }||�1|�j- |d | d+< z |�0|�j(j)}W n t*�y* t�d-� d.}Y nw t+| |d | d/< �q�W d � |S 1 �sCw Y |S )9ah Uninstall the updates passed in the updates collection. Load the updates collection using the ``search`` or ``available`` functions. .. note:: Starting with Windows 10 the Windows Update Agent is unable to uninstall updates. An ``Uninstall Not Allowed`` error is returned. If this error is encountered this function will instead attempt to use ``dism.exe`` to perform the un-installation. ``dism.exe`` may fail to to find the KB number for the package. In that case, removal will fail. Args: updates (Updates): An instance of the Updates class containing a the updates to be uninstalled. Returns: dict: A dictionary containing the results of the un-installation Code Example: .. code-block:: python import salt.utils.win_update wua = salt.utils.win_update.WindowsUpdateAgent() # uninstall KB3195454 updates = wua.search('KB3195454') results = wua.uninstall(updates) r FzNothing to uninstallrm zSalt: Uninstall Updater r r$ ZAlreadyUninstalledzTo Be Uninstalled: %sro NzUninstalling UpdatesrV rW rN z/Uninstall Failed with WUA, attempting with DISM)�dism�/Onlinez /Get-Packages�kbz : r Z DismPackager� r� z/Remove-Packagez /PackageName:z/Quietz /NoRestartzUninstall using DISM failedz Command: %s� � Error: %sz Uninstall using DISM failed: z Uninstall Completed using DISMTrn zUninstalled using DISMrs r) r� rO zUninstallation Succeededru zUninstallation Failedr r r+ zUninstall Failed: %szUninstallation Not StartedzUninstallation In Progressz$Uninstallation Succeeded With ErrorszUninstallation Abortedrp zUninstall Completert zUninstall Failed)2r rQ r� rX r r r r r r r r r3 r4 r$ r0 r8 rE rF r. r/ rT r r Z UninstallrY rZ r[ r\ r] r> �_run� splitlines�lower�splitr �join� needs_rebootrS rR r1 r+ r2 r= r^ rv r; rw rx ry )r r rz r� Zuninstall_listr@ r{ r| r^ r` ra rb rc rd r r� �cmdZpkg_listZpkgrA r} r~ r� r r r � uninstallu s( ( � � � � ���� ��� �� �������� � ��f� ������ � � 0 �� 0z WindowsUpdateAgent.uninstallc C s� t |t�r tjj�|�}zt�|� tj |tj tj d�}|� � W S t y? } zt�dd� |�� t�d|� t|��d}~ww )z� Internal function for running commands. Used by the uninstall function. Args: cmd (str, list): The command to run Returns: str: The stdout of the command )�stdout�stderrzCommand Failed: %sr� r� N)ri r5 r r r[ Z shlex_splitr. r/ � subprocess�Popen�PIPE� communicate�OSErrorr� r )r r� �prb r r r r� T s ��zWindowsUpdateAgent._run)T)TTFFTTNN)rI rJ rK rL r\ r r rS re rh rl r r� r� r� r r r r rM s� �������� � � � � ������ !2 � Bqz `rM c C s� t jj�� �@ ztj�d�} W n' tjy6 } z|j \}}}}t � d|� W Y d}~W d � dS d}~ww t jj � | j�W d � S 1 sIw Y dS )a Determines if the system needs to be rebooted. Returns: bool: ``True`` if the system requires a reboot, ``False`` if not CLI Examples: .. code-block:: bash import salt.utils.win_update salt.utils.win_update.needs_reboot() zMicrosoft.Update.SystemInfoz&Failed to create SystemInfo object: %sNF)r r r r r r r rY rZ r[ r. r/ rE rF r; )Zobj_sysrb �_ra r r r r� n s ��$�r� )rL �loggingr� Zsalt.utils.argsr Zsalt.utils.dataZsalt.utils.winapiZsalt.exceptionsr rY Zwin32com.clientr r � ImportError� getLoggerrI r. r= r r r rM r� r r r r �<module> s> � � f g
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings