File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/win_system.cpython-310.pyc
Back
o ;jҧ � @ s| d Z ddlZddlZddlZddlZddlmZ ddlZddlZddl Zddl Zddl Zddl m Z z ddlmZ ddlZddlZddlZddlZddlZdZW n ey[ dZY nw e�e�ZdZd d � Zdad d �Zd d� Z dbdd�Z dd� Z dbdd�Z dcdd�Z dddd�Z!dd� Z"d d � Z#d d � Z$d d!� Z%d"d#� Z&d$d%� Z'ded&d'�Z(ej)j*�+e(d(�Z,d)d*� Z-d+d,� Z.ej)j*�+e.d-�Z/d.d/� Z0d0d1� Z1 dfd2d3�Z2 dgd4d5�Z3 6 dhd7d8�Z4d9d:� Z5d;d<� Z6d=d>� Z7d?d@� Z8dAdB� Z9 didCdD�Z:dEdF� Z;dGdH� Z<dIdJ� Z=dKdL� Z>dMdN� Z?dOdP� Z@dQdR� ZAdSdT� ZBdUdV� ZCdWdX� ZDdYdZ� ZEd[d\� ZFd]d^� ZGd_d`� ZHdS )jz� Module for managing Windows systems and getting Windows system information. Support for reboot, shutdown, join domain, rename :depends: - pywintypes - win32api - win32con - win32net - wmi � N)�datetime)�CommandExecutionError)�windllTF�systemc C s t jj�� sdS ts dS tS )z: Only works on Windows Systems with Win32 Modules )Fz#Module win_system: Requires Windows)Fz(Module win_system: Missing win32 modules)�salt�utils�platformZ is_windows�HAS_WIN32NET_MODS�__virtualname__� r r �K/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/win_system.py� __virtual__. s r c C s |r| S | d S )z$ convert timeout to seconds �< r ��timeout� in_secondsr r r �_convert_minutes_seconds; s r c C s$ | � d�d } t�| d�}|�d�S )z, convert string to date time object �.r z %Y%m%d%H%M%Sz%Y-%m-%d %H:%M:%S)�splitr �strptime�strftime)Z dt_string�dt_objr r r �_convert_date_time_stringB s r � c C � t | |d�S )a Halt a running system. Args: timeout (:obj:`int`, optional): Number of minutes/seconds before halting the system. Default is 5 minutes. in_seconds (:obj:`bool`, optional): Whether to treat timeout as seconds or minutes. Default is ``True``. .. versionadded:: 2015.8.0 Returns: bool: ``True`` if successful, otherwise ``False``. CLI Example: .. code-block:: bash salt '*' system.halt 5 True r ��shutdownr r r r �haltK � r c C s dS )z� Change the system runlevel on sysV compatible systems. Not applicable to Windows CLI Example: .. code-block:: bash salt '*' system.init 3 z(Not implemented on Windows at this time.r )Zrunlevelr r r �initi s r c C r )a Power off a running system. Args: timeout (:obj:`int`, optional): Number of minutes/seconds before powering off the system. Default is 5 minutes. in_seconds (:obj:`bool`, optional): Whether to treat timeout as seconds or minutes. .. versionadded:: 2015.8.0 Default is ``False``. Returns: bool: ``True`` if successful, otherwise ``False``. CLI Example: .. code-block:: bash salt '*' system.poweroff 5 r r r r r r �poweroff~ r r c C s0 t | d||d�}|rt| |�}t�|d � |S )a� Reboot a running system. Args: timeout (:obj:`int`, optional): The number of minutes/seconds before rebooting the system. Use of minutes or seconds depends on the value of ``in_seconds``. Default is 5 minutes. in_seconds (:obj:`bool`, optional): ``True`` will cause the ``timeout`` parameter to be in seconds. ``False`` will be in minutes. Default is ``False``. .. versionadded:: 2015.8.0 wait_for_reboot (:obj:`bool`, optional): ``True`` will sleep for timeout + 30 seconds after reboot has been initiated. This is useful for use in a highstate. For example, you may have states that you want to apply only after the reboot. Default is ``False``. .. versionadded:: 2015.8.0 only_on_pending_reboot (:obj:`bool`, optional): If this is set to ``True``, then the reboot will only proceed if the system reports a pending reboot. Setting this parameter to ``True`` could be useful when calling this function from a final housekeeping state intended to be executed at the end of a state run (using *order: last*). Default is ``False``. Returns: bool: ``True`` if successful (a reboot will occur), otherwise ``False``. CLI Example: .. code-block:: bash salt '*' system.reboot 5 salt '*' system.reboot 5 True Invoking this function from a final housekeeping state: .. code-block:: yaml final_housekeeping: module.run: - name: system.reboot - only_on_pending_reboot: True - order: last T)r �rebootr �only_on_pending_reboot� )r r �time�sleep)r r Zwait_for_rebootr" �ret�secondsr r r r! � s ?� r! c C s� t ||�}|r t� s dS | rt| t�s| �d�} z t�d| |||� W dS tjyU } z$|j \}}} t �d� t �d|� t �d|� t �d| � W Y d }~dS d }~ww ) a� Shutdown a running system. Args: message (:obj:`str`, optional): The message to display to the user before shutting down. Default is ``None``. timeout (:obj:`int`, optional): The length of time (in seconds) that the shutdown dialog box should be displayed. While this dialog box is displayed, the shutdown can be aborted using the ``system.shutdown_abort`` function. If timeout is not zero, InitiateSystemShutdown displays a dialog box on the specified computer. The dialog box displays the name of the user who called the function, the message specified by the lpMessage parameter, and prompts the user to log off. The dialog box beeps when it is created and remains on top of other windows (system modal). The dialog box can be moved but not closed. A timer counts down the remaining time before the shutdown occurs. If timeout is zero, the computer shuts down immediately without displaying the dialog box and cannot be stopped by ``system.shutdown_abort``. Default is 5 minutes in_seconds (:obj:`bool`, optional): ``True`` will cause the ``timeout`` parameter to be in seconds. ``False`` will be in minutes. Default is ``False``. .. versionadded:: 2015.8.0 force_close (:obj:`bool`, optional): ``True`` will force close all open applications. ``False`` will display a dialog box instructing the user to close open applications. Default is ``True``. reboot (:obj:`bool`, optional): ``True`` restarts the computer immediately after shutdown. ``False`` powers down the system. Default is ``False``. only_on_pending_reboot (:obj:`bool`, optional): If ``True`` the shutdown will only proceed if there is a reboot pending. ``False`` will shutdown the system. To optionally shutdown in a highstate, consider using the shutdown state instead of this module. Default is ``False``. Returns: bool: ``True`` if successful (a shutdown or reboot will occur), otherwise ``False`` CLI Example: .. code-block:: bash salt '*' system.shutdown 'System will shutdown in 5 minutes' Fzutf-8� 127.0.0.1Tz Failed to shutdown the system�nbr: %s�ctx: %s�msg: %sN) r �get_pending_reboot� isinstance�str�decode�win32apiZInitiateSystemShutdown� pywintypes�error�args�log) �messager Z force_closer! r r" �exc�number�contextr r r r � s& L � ��r c C s t dd�S )z� Shutdown a running system with no timeout or warning. Returns: bool: ``True`` if successful, otherwise ``False``. CLI Example: .. code-block:: bash salt '*' system.shutdown_hard r )r r r r r r � shutdown_hardJ � r9 c C st zt �d� W dS tjy9 } z$| j\}}}t�d� t�d|� t�d|� t�d|� W Y d} ~ dS d} ~ ww ) aC Abort a shutdown. Only available while the dialog box is being displayed to the user. Once the shutdown has initiated, it cannot be aborted. Returns: bool: ``True`` if successful, otherwise ``False``. CLI Example: .. code-block:: bash salt 'minion-id' system.shutdown_abort r( Tz Failed to abort system shutdownr) r* r+ NF)r0 ZAbortSystemShutdownr1 r2 r3 r4 )r6 r7 r8 r5 r r r �shutdown_abortZ s ��r; c C s t j�� S )z� Lock the workstation. Returns: bool: ``True`` if successful, otherwise ``False``. CLI Example: .. code-block:: bash salt 'minion-id' system.lock )r Zuser32ZLockWorkStationr r r r �locku r: r< c C s@ t j�tj| �r ddt� ii}t� }|dvr ||d d< |S dS )a� Set the Windows computer name Args: name (str): The new name to give the computer. Requires a reboot to take effect. Returns: dict: Returns a dictionary containing the old and new names. bool: ``False`` if failed to set computer name CLI Example: .. code-block:: bash salt 'minion-id' system.set_computer_name 'DavesComputer' z Computer NameZCurrent)NFZPendingF)r �kernel32ZSetComputerNameExW�win32conZ ComputerNamePhysicalDnsHostname�get_computer_name�get_pending_computer_name)�namer& �pendingr r r �set_computer_name� s � rC c C � t jj�� S )aV Get a pending computer name. If the computer name has been changed, and the change is pending a system reboot, this function will return the pending computer name. Otherwise, ``None`` will be returned. If there was an error retrieving the pending computer name, ``False`` will be returned, and an error message will be logged to the minion log. Returns: str: Returns the pending name if pending restart. Returns ``None`` if not pending restart. CLI Example: .. code-block:: bash salt 'minion-id' system.get_pending_computer_name )r r � win_systemr@ r r r r r@ � s r@ c C rD )z� Get the Windows computer name Returns: str: Returns the computer name if found. Otherwise, returns ``False``. CLI Example: .. code-block:: bash salt 'minion-id' system.get_computer_name )r r rE r? r r r r r? � � r? c C s� t �dd�}| du r dS | |d< z t �dd|� W n1 t jyJ } z$|j\}}}t�d� t�d|� t�d|� t�d|� W Y d}~dS d}~ww d t� iS ) ag Set the Windows computer description. Args: desc (:obj:`str`, optional): The computer description. Default is ``None``. Returns: str: Description if successful, otherwise ``False``. CLI Example: .. code-block:: bash salt 'minion-id' system.set_computer_desc 'This computer belongs to Dave!' N�e FZcommentzFailed to update systemr) r* r+ zComputer Description)�win32netZNetServerGetInfoZNetServerSetInfor2 r3 r4 �get_computer_desc)�descZ system_infor6 r7 r8 r5 r r r �set_computer_desc� s �� rK �set_computer_descriptionc C sL dd� } dddd�}ddd d d d d �}ddddddd�}dddddddd d d � }t jj�� ��l t�� }|�� d }i d t� �d!|j�d"|j �d#|j �d$|j �d%|j �d&|j �d'|j�d(|j�d)|j�d*||j �d+|j�d,|j�d-|j�d.|j�d/|j�}|�� d }|�d0|ji� |�� d }t� � d1v r�||j } n |�d2d d3�� ||j } |�i d4|j �d5|j �d6||j �d7|j �d8|j!�d9||j" �d:|j �d;|j#�d<|j$�d=|j%�d>| �d?|j&�d@|j'�dA|j(�dB| |j)��dC|j)�dD||j* �dE|j+i�� |�,� } d |dF< d |dG< d |dH< d |dI< | d j |dJ< t-| d j.�dK |dL< | D ]5} |dF dM7 < |dG | j/7 < |dH | j07 < z |dI | j17 < W �q( t2t3f�y] Y �q(w |dI d k�rk|�4dIdN� |�5� d } |�| j6| j | j| j7| j | jdO�� t8|d" �|d"< t8|d# �|d#< W dP � |S 1 �s�w Y |S )Qa� Get system information. .. note:: Not all system info is available across all versions of Windows. If it is not available on an older version, it will be skipped Returns: dict: Dictionary containing information about the system to include name, description, version, etc... CLI Example: .. code-block:: bash salt 'minion-id' system.get_system_info c S st t | �} | dk r| d�d�S | dk r| d d�d�S | dk r&| d d�d�S | dk r2| d d�d �S | d d�d �S ) N� z.3f�Bi ZKBi @ZMBl ZGBZTB)�float)�valr r r � byte_calc s z"get_system_info.<locals>.byte_calcz Work StationzDomain ControllerZServer)� � � zStandalone WorkstationzMember WorkstationzStandalone Serverz Member ServerzBackup Domain ControllerzPrimary Domain Controller)r rR rS rT � r ZOtherZUnknownZSafe�WarningZCriticalzNon-recoverable)rR rS rT rU r � Z UnspecifiedZDesktopZMobileZ WorkstationzEnterprise Serverz SOHO Serverz Appliance PCzPerformance ServerZMaximum) r rR rS rT rU r rW � � r rA � descriptionZ install_dateZ last_bootZos_manufacturer�os_nameZusersZ organizationZos_architectureZprimary�os_typeZregistered_userZsystem_directoryZ system_drive� os_versionZwindows_directoryZchassis_sku_number)�Vista�7�8ZSlate)rY � Z bootup_stateZcaptionZchassis_bootup_stateZ dns_hostname�domain� domain_roleZhardware_manufacturerZhardware_modelZnetwork_server_mode_enabledZpart_of_domain�pc_system_typeZ power_state�statusZ system_typeZtotal_physical_memoryZtotal_physical_memory_rawZ thermal_state� workgroup� processorsZprocessors_logicalZprocessor_coresZprocessor_cores_enabledZprocessor_manufacturerZMHzZprocessor_max_clock_speedrR F)Zhardware_serialZbios_manufacturerZ bios_versionZ bios_detailsZ bios_captionZbios_descriptionN)9r r �winapi�Com�wmi�WMIZWin32_OperatingSystemr? Z DescriptionZ InstallDateZLastBootUpTimeZ ManufacturerZCaptionZ NumberOfUsersZ OrganizationZOSArchitectureZPrimaryZ ProductTypeZRegisteredUserZSystemDirectoryZ SystemDrive�VersionZWindowsDirectoryZWin32_ComputerSystemProduct�updateZ SKUNumber�Win32_ComputerSystemr �releaseZ PCSystemTypeZ BootupStateZChassisBootupStateZ DNSHostname�DomainZ DomainRoleZModelZNetworkServerModeEnabled� PartOfDomainZ PowerStateZStatusZ SystemTypeZTotalPhysicalMemoryZ ThermalState� WorkgroupZWin32_Processorr. Z MaxClockSpeedZNumberOfLogicalProcessorsZ NumberOfCoresZNumberOfEnabledCore�AttributeError� TypeError�popZ Win32_BIOSZ SerialNumberZ BIOSVersionr ) rQ r\ rc Zwarning_statesZpc_system_types�connr r& �productrd rg � processorZbiosr r r �get_system_info� s � � � �������� � � � � ���� �� ��� ��� � � � � �� �� ���� �� �[�[ry c C s t � d } | du r dS | S )z� Get the Windows computer description. Returns: str: Returns the computer description if found. Otherwise, returns ``False``. CLI Example: .. code-block:: bash salt 'minion-id' system.get_computer_desc rZ NF)ry )rJ r r r rI � s rI �get_computer_descriptionc C s d} t d | d�}|S )z� Get the hostname of the windows minion. .. versionadded:: 2016.3.0 Returns: str: Returns the hostname of the windows minion CLI Example: .. code-block:: bash salt 'minion-id' system.get_hostname �hostnamezcmd.run)�cmd�Z__salt__)r| r& r r r � get_hostname� s r~ c C sP t jj�� � t�� }|�� d }|j| d�W d � S 1 s!w Y dS )am Set the hostname of the windows minion, requires a restart before this will be updated. .. versionadded:: 2016.3.0 Args: hostname (str): The hostname to set. Returns: bool: ``True`` if successful, otherwise ``False``. CLI Example: .. code-block:: bash salt 'minion-id' system.set_hostname newhostname r ��NameN)r r rh ri rj rk rn ZRename)r{ rv �compr r r � set_hostname� s $�r� c C s� t � }d|v r|d | krd| � �S |r#d|vr#d|vr#|� d| � �}|r+|du r+dS t|t�r:|�d�}d�|�}t| ||||d�}|sS| d d �}|rQt� |d < |S tt� |�� � ��) a Join a computer to an Active Directory domain. Requires a reboot. Args: domain (str): The domain to which the computer should be joined, e.g. ``example.com``. username (:obj:`str`, optional): Username of an account which is authorized to join computers to the specified domain. Needs to be either fully qualified like ``user@domain.tld`` or simply ``user``. Default is ``None``. password (:obj:`str`, optional): Password of the specified user. Default is ``None``. account_ou (:obj:`str`, optional): The DN of the OU below which the account for this computer should be created when joining the domain, e.g. ``ou=computers,ou=departm_432,dc=my-company,dc=com``. Default is ``None``. account_exists (:obj:`bool`, optional): If set to ``True`` the computer will only join the domain if the account already exists. If set to ``False``, the computer account will be created if it does not exist, otherwise it will use the existing account. Default is ``False``. restart (:obj:`bool`, optional): ``True`` will restart the computer after a successful join. Default is ``False``. .. versionadded:: 2015.5.7,2015.8.2 Returns: dict: Returns a dictionary if successful, otherwise ``False`` CLI Example: .. code-block:: bash salt 'minion-id' system.join_domain domain='domain.tld' \ username='joinuser' password='joinpassword' \ account_ou='ou=clients,ou=org,dc=domain,dc=tld' \ account_exists=False, restart=True rp �Already joined to �\�@N�.Must specify a password if you pass a username� )rb �username�password� account_ou�account_existsF)rp �Restartr� ) �get_domain_workgroupr- r. r �join� _join_domainr! r r0 � FormatMessage�rstrip) rb r� r� r� r� �restartre �errr& r r r � join_domain� s0 ? � r� c C s� d}d}d}d}d} | |O } | |O } | |O } |s | |O } t jj�� � t�� } | �� d } | j| |||| d�d W d � S 1 sCw Y dS )a� Helper function to join the domain. Args: domain (str): The domain to which the computer should be joined, e.g. ``example.com``. username (:obj:`str`, optional): Username of an account which is authorized to join computers to the specified domain. Need to be either fully qualified like ``user@domain.tld`` or simply ``user``. Default is ``None``. password (:obj:`str`, optional): Password of the specified user. Default is ``None``. account_ou (:obj:`str`, optional): The DN of the OU below which the account for this computer should be created when joining the domain, e.g. ``ou=computers,ou=departm_432,dc=my-company,dc=com``. Default is ``None``. account_exists (:obj:`bool`, optional): If set to ``True`` the computer will only join the domain if the account already exists. If set to ``False``, the computer account will be created if it does not exist, otherwise it will use the existing account. Default is ``False``. Returns: int: Representing the success of failure of the domain join rR rS � rM r )r� �Password�UserNameZ AccountOUZ FJoinOptionsN)r r rh ri rj rk rn �JoinDomainOrWorkgroup) rb r� r� r� r� ZNETSETUP_JOIN_DOMAINZNETSETUP_ACCOUNT_CREATEZ NETSETUP_DOMAIN_JOIN_IF_JOINEDZNETSETUP_JOIN_WITH_NEW_NAMEZ join_optionsrv r� r r r r� A s. ) ��$�r� � WORKGROUPc C sp t � }d|v r|d |krd|� �S | r(d| vr(d| vr(|r&| � d|� �} ndS | r0|du r0dS d}d }|r:||O }tjj�� �n t�� } | �� d } | j|| |d �} | d s�| j |d �} | d sv|d d �} |rmt � | d< | W d � S t � t �| d ��� � t � d|� W d � d S t � t �| d ��� � t � d|d � W d � d S 1 s�w Y dS )a� Unjoin a computer from an Active Directory Domain. Requires a restart. Args: username (:obj:`str`, optional): Username of an account which is authorized to manage computer accounts on the domain. Needs to be a fully qualified name like ``user@domain.tld`` or ``domain.tld\user``. If the domain is not specified, the passed domain will be used. If the computer account doesn't need to be disabled after the computer is unjoined, this can be ``None``. Default is ``None``. password (:obj:`str`, optional): The password of the specified user. Default is ``None``. domain (:obj:`str`, optional): The domain from which to unjoin the computer. Can be ``None``. Default is ``None``. workgroup (:obj:`str`, optional): The workgroup to join the computer to. Default is ``WORKGROUP``. .. versionadded:: 2015.5.7,2015.8.2 disable (:obj:`bool`, optional): ``True`` to disable the computer account in Active Directory. Default is ``False`` restart (:obj:`bool`, optional): ``True`` will restart the computer after successful unjoin. Default is ``False``. .. versionadded:: 2015.5.7,2015.8.2 Returns: dict: Returns a dictionary if successful, otherwise ``False``. CLI Example: .. code-block:: bash salt 'minion-id' system.unjoin_domain restart=True salt 'minion-id' system.unjoin_domain username='unjoinuser' \ password='unjoinpassword' disable=True \ restart=True rr r� r� r� z/Must specify domain if not supplied in usernameNr� rU r )r� r� ZFUnjoinOptionsr F)rr r� r� z%Failed to unjoin the computer from %sz!Failed to unjoin computer from %srp )r� r r rh ri rj rk rn ZUnjoinDomainOrWorkgroupr� r! r4 r2 r0 r� r� ) r� r� rb rf �disabler� re ZNETSETUP_ACCT_DELETEZunjoin_optionsrv r� r� r& r r r � unjoin_domain� sH C � � �$�r� c C s� t jj�� �2 t�� } | �� D ] }|jr"d|ji W d � S d|ji W d � S W d � dS 1 s;w Y dS )a Get the domain or workgroup the computer belongs to. .. versionadded:: 2015.5.7 .. versionadded:: 2015.8.2 Returns: str: The name of the domain or workgroup. CLI Example: .. code-block:: bash salt 'minion-id' system.get_domain_workgroup rp Nrr ) r r rh ri rj rk rn rq rp )rv Zcomputerr r r r� � s � �"�r� c C s` t jj�� � t�� }|�� d }|j| �� d�}W d � n1 s#w Y |d s.dS dS )aa Set the domain or workgroup the computer belongs to. .. versionadded:: 3001 Args: workgroup (str): The name of the domain or workgroup. Returns: bool: ``True`` if successful, otherwise ``False``. CLI Example: .. code-block:: bash salt 'minion-id' system.set_domain_workgroup LOCAL r r NTF) r r rh ri rj rk rn r� �upper)rf rv r� �resr r r �set_domain_workgroup s �r� c C s8 d}|D ]}z t �| |�}W |S ty Y qw |S )a$ A helper function that attempts to parse the input time_str as a date. Args: time_str (str): A string representing the time fmts (list): A list of date format strings Returns: datetime: Returns a datetime object if parsed properly, otherwise None N)r r � ValueError)Ztime_str�fmts�result�fmtr r r �_try_parse_datetime1 s ��r� c C sp t �� } d}t| d �}|dkrd}n|dkrd}n |dkr$|d }d}|d�d| d d�d| d d�d |� �S ) z� Get the system time. Returns: str: Returns the system time in HH:MM:SS AM/PM format. CLI Example: .. code-block:: bash salt 'minion-id' system.get_system_time ZAMrU � ZPMr �02d�:r rW � )r0 � GetLocalTime�int)�nowZmeridian�hoursr r r �get_system_timeH s (r� c C �2 g d�}t | |�}|du rdS t|j|j|jd�S )a� Set the system time. Args: newtime (str): The time to set. Can be any of the following formats: - HH:MM:SS AM/PM - HH:MM AM/PM - HH:MM:SS (24 hour) - HH:MM (24 hour) Returns: bool: ``True`` if successful, otherwise ``False``. CLI Example: .. code-block:: bash salt 'minion-id' system.set_system_time 12:01 )z %I:%M:%S %pz%I:%M %pz%H:%M:%Sz%H:%MNF)r� �minutesr' )r� �set_system_date_time�hour�minute�second)Znewtimer� r r r r �set_system_timeb s �r� c C s� zt �� }W n1 t jy7 } z$|j\}} } t�d� t�d|� t�d| � t�d| � W Y d}~dS d}~ww | du r@|d } |du rH|d }|du rP|d }|du rX|d }|du r`|d }|du rh|d }zKG d d� dtj�} | � } t| �| _t|�| _ t|�| _ t|�| _ t|�| _ t|�| _ t�| �} tjj�| �}|dkr�W dS t�d� tt �|��� �� ty� } z t�d� t|��d}~ww )a: Set the system date and time. Each argument is an element of the date, but not required. If an element is not passed, the current system value for that element will be used. For example, if you don't pass the year, the current system year will be used. (Used by set_system_date and set_system_time) Args: years (:obj:`int`, optional): Years digit, ie: 2015 Default is ``None``. months (:obj:`int`, optional): Months digit: 1 - 12 Default is ``None``. days (:obj:`int`, optional): Days digit: 1 - 31 Default is ``None``. hours (:obj:`int`, optional): Hours digit: 0 - 23 Default is ``None``. minutes (:obj:`int`, optional): Minutes digit: 0 - 59 Default is ``None``. seconds (:obj:`int`, optional): Seconds digit: 0 - 59 Default is ``None``. Returns: bool: ``True`` if successful, otherwise ``False``. CLI Example: .. code-block:: bash salt '*' system.set_system_date_ time 2015 5 12 11 37 53 zFailed to get local timer) r* r+ NFr rR rT rU r rW c @ sP e Zd ZdejfdejfdejfdejfdejfdejfdejfdejfgZd S ) z(set_system_date_time.<locals>.SYSTEMTIME�wYear�wMonthZ wDayOfWeek�wDay�wHour�wMinute�wSecondZ wMillisecondsN)�__name__� __module__� __qualname__�ctypes�c_int16�_fields_r r r r � SYSTEMTIME� s �r� TzFailed to set local time)r0 r� r2 r3 r4 r� � Structurer� r� r� r� r� r� r� �pointerr r= Z SetLocalTimer r� r� �OSError)�years�months�daysr� r� r' Z date_timer6 r7 r8 r5 r� Z system_timeZsystem_time_ptrZ succeededr� r r r r� � sV - �� ��r� c C s. t �� } | d d�d| d d�d| d d��S )z� Get the Windows system date Returns: str: Returns the system date. CLI Example: .. code-block:: bash salt '*' system.get_system_date rR r� �/rT r Z04d)r0 r� )r� r r r �get_system_date� s &r� c C r� )a� Set the Windows system date. Use <mm-dd-yy> format for the date. Args: newdate (str): The date to set. Can be any of the following formats - YYYY-MM-DD - MM-DD-YYYY - MM-DD-YY - MM/DD/YYYY - MM/DD/YY - YYYY/MM/DD Returns: bool: ``True`` if successful, otherwise ``False``. CLI Example: .. code-block:: bash salt '*' system.set_system_date '03-28-13' )z%Y-%m-%dz%m-%d-%Yz%m-%d-%yz%m/%d/%Yz%m/%d/%yz%Y/%m/%dNF)r� r� r� )r� r� �year�month�day)Znewdater� r r r r �set_system_date� s r� c C � t d d�S )z� Start the Windows time service. Returns: bool: ``True`` if successful, otherwise ``False``. CLI Example: .. code-block:: bash salt '*' system.start_time_service z service.start�w32timer} r r r r �start_time_service! rF r� c C r� )z� Stop the Windows time service. Returns: bool: ``True`` if successful, otherwise ``False``. CLI Example: .. code-block:: bash salt '*' system.stop_time_service z service.stopr� r} r r r r �stop_time_service1 rF r� c C rD )af Determine whether there are pending Component Based Servicing tasks that require a reboot. .. versionadded:: 2016.11.0 Returns: bool: ``True`` if there are pending Component Based Servicing tasks, otherwise ``False``. CLI Example: .. code-block:: bash salt '*' system.get_pending_component_servicing )r r rE � get_pending_component_servicingr r r r r� A � r� c C rD )aG Determine whether there is a pending domain join action that requires a reboot. .. versionadded:: 2016.11.0 Returns: bool: ``True`` if there is a pending domain join action, otherwise ``False``. CLI Example: .. code-block:: bash salt '*' system.get_pending_domain_join )r r rE �get_pending_domain_joinr r r r r� U r� r� c C rD )aL Determine whether there are pending file rename operations that require a reboot. .. versionadded:: 2016.11.0 Returns: bool: ``True`` if there are pending file rename operations, otherwise ``False``. CLI Example: .. code-block:: bash salt '*' system.get_pending_file_rename )r r rE �get_pending_file_renamer r r r r� i r� r� c C rD )aJ Determine whether there are pending Server Manager tasks that require a reboot. .. versionadded:: 2016.11.0 Returns: bool: ``True`` if there are pending Server Manager tasks, otherwise ``False``. CLI Example: .. code-block:: bash salt '*' system.get_pending_servermanager )r r rE �get_pending_servermanagerr r r r r� } r� r� c C rD )a Determine whether there are pending updates that require a reboot. .. versionadded:: 2016.11.0 Returns: bool: ``True`` if there are pending updates, otherwise ``False``. CLI Example: .. code-block:: bash salt '*' system.get_pending_update )r r rE �get_pending_updater r r r r� � � r� c C rD )am This function is used to remember that an event indicating that a reboot is required was witnessed. This function relies on the salt-minion's ability to create the following volatile registry key in the *HKLM* hive: *SYSTEM\\CurrentControlSet\\Services\\salt-minion\\Volatile-Data* Because this registry key is volatile, it will not persist beyond the current boot session. Also, in the scope of this key, the name *'Reboot required'* will be assigned the value of *1*. For the time being, this function is being used whenever an install completes with exit code 3010 and can be extended where appropriate in the future. .. versionadded:: 2016.11.0 Returns: bool: ``True`` if successful, otherwise ``False``. CLI Example: .. code-block:: bash salt '*' system.set_reboot_required_witnessed )r r rE � set_reboot_required_witnessedr r r r r� � r r� c C rD )aA Determine if at any time during the current boot session the salt minion witnessed an event indicating that a reboot is required. This function will return ``True`` if an install completed with exit code 3010 during the current boot session and can be extended where appropriate in the future. .. versionadded:: 2016.11.0 Returns: bool: ``True`` if the ``Requires reboot`` registry flag is set to ``1``, otherwise ``False``. CLI Example: .. code-block:: bash salt '*' system.get_reboot_required_witnessed )r r rE � get_reboot_required_witnessedr r r r r� � s r� c C rD )a Determine whether there is a reboot pending. .. versionadded:: 2016.11.0 Returns: bool: ``True`` if the system is pending reboot, otherwise ``False``. CLI Example: .. code-block:: bash salt '*' system.get_pending_reboot )r r rE r, r r r r r, � r� r, c C rD )a� Determine which check is signalling that the system is pending a reboot. Useful in determining why your system is signalling that it needs a reboot. .. versionadded:: 3001 Returns: dict: A dictionary of the results of each system that would indicate a pending reboot. CLI Example: .. code-block:: bash salt '*' system.get_pending_reboot_details )r r rE �get_pending_reboot_detailsr r r r r� � r� r� c C rD )a� Check the Windows Update system for a pending reboot state. This leverages the Windows Update System to determine if the system is pending a reboot. .. versionadded:: 3001 Returns: bool: ``True`` if the Windows Update system reports a pending update, otherwise ``False``. CLI Example: .. code-block:: bash salt '*' system.get_pending_windows_update )r r rE �get_pending_windows_updater r r r r� s r� )F)r F)r FFF)Nr TFFF)N)NNNFF)NNNF)NNNr� FF)NNNNNN)I�__doc__r� �loggingr r$ r Zsalt.utils.functoolsr Zsalt.utils.localesZsalt.utils.platformZsalt.utils.win_systemZsalt.utils.winapiZsalt.exceptionsr r r1 r0 r> rH rj r � ImportError� getLoggerr� r4 r r r r r r r r! r r9 r; r< rC r@ r? rK r � functoolsZalias_functionrL ry rI rz 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 �<module> s� � �N �a ,� � �a �F �r $ �h#
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings