Current File : //usr/lib/python2.7/site-packages/salt/modules/win_groupadd.pyo
�
���^c @@ s. d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l Z y. d d l
Z
d d l Z d d l
Z
e Z Wn e k
r� e Z n Xe j e � Z d Z d � Z d � Z d � Z d � Z d � Z d
� Z d � Z d � Z e d
� Z d � Z d � Z d � Z! e d � Z" d S( u
Manage groups on Windows
.. important::
If you feel that Salt should be using this module to manage groups on a
minion, and it is using a different module (or gives an error similar to
*'group.info' is not available*), see :ref:`here
<module-provider-override>`.
i ( t absolute_importt unicode_literalst print_functionNu groupc C@ s& t j j j � r t r t St d f S( u7
Set the group module if the kernel is Windows
u9 Module win_groupadd: module only works on Windows systems( t saltt utilst platformt
is_windowst HAS_DEPENDENCIESt __virtualname__t False( ( ( s= /usr/lib/python2.7/site-packages/salt/modules/win_groupadd.pyt __virtual__! s c C@ s; t j j j � � t j j d � } Wd QX| j d d � S( u�
A helper function to get the object for the local machine
Returns:
object: Returns the computer object for the local machine
u
AdsNameSpacesNu u WinNT://.,computer( R R t winapit Comt win32comt clientt Dispatcht GetObject( t nt( ( s= /usr/lib/python2.7/site-packages/salt/modules/win_groupadd.pyt _get_computer_object* s c C@ sC t j j j � � t j j d � } Wd QX| j d d | d � S( u�
A helper function to get a specified group object
Args:
name (str): The name of the object
Returns:
object: The specified group object
u
AdsNameSpacesNu u
WinNT://./u ,group( R R R R R
R R R ( t nameR ( ( s= /usr/lib/python2.7/site-packages/salt/modules/win_groupadd.pyt _get_group_object6 s c C@ sM t j j j � � t j j d � } Wd QX| j d d � } d g | _ | S( u�
A helper function that gets a list of group objects for all groups on the
machine
Returns:
iter: A list of objects for all groups on the machine
u
AdsNameSpacesNu u WinNT://.u group( R R R R R
R R R t Filter( R t results( ( s= /usr/lib/python2.7/site-packages/salt/modules/win_groupadd.pyt _get_all_groupsF s
c C@ s | j j d d � j d d � S( u�
Resolve the username from the member object returned from a group query
Returns:
str: The username converted to domain\username format
u WinNT://u u /u \( t ADSPatht replace( t member( ( s= /usr/lib/python2.7/site-packages/salt/modules/win_groupadd.pyt
_get_usernameU s c K@ s� t | � s� t � } y6 | j d | � } | j � t j d j | � � Wq� t j k
r� } d j | t j | j
d � � } t j | � t SXn t j
d j | � � t St S( u�
Add the specified group
Args:
name (str):
The name of the group to add
Returns:
bool: ``True`` if successful, otherwise ``False``
CLI Example:
.. code-block:: bash
salt '*' group.add foo
u groupu Successfully created group {0}u Failed to create group {0}. {1}i u The group {0} already exists.( t infoR t Createt SetInfot logt formatt
pywintypest com_errort win32apit
FormatMessaget excepinfot errorR t warningt True( R t kwargst comp_objt new_groupt exct msg( ( s= /usr/lib/python2.7/site-packages/salt/modules/win_groupadd.pyt add` s
c K@ s� t | � r� t � } y* | j d | � t j d j | � � Wq� t j k
r� } d j | t j | j d � � } t j
| � t SXn t j d j | � � t St
S( u
Remove the named group
Args:
name (str):
The name of the group to remove
Returns:
bool: ``True`` if successful, otherwise ``False``
CLI Example:
.. code-block:: bash
salt '*' group.delete foo
u groupu Successfully removed group {0}u Failed to remove group {0}. {1}i u The group {0} does not exists.( R R t DeleteR R R! R" R# R$ R% R& R R' R( ( R R) R* R, R- ( ( s= /usr/lib/python2.7/site-packages/salt/modules/win_groupadd.pyt delete� s
c C@ s� y> t | � } | j } g | j � D] } t | � ^ q% } WnF t j k
r� } d j | t j | j d � � } t
j | � t SX| s� t Si | d 6d d 6d d 6| d 6S( u
Return information about a group
Args:
name (str):
The name of the group for which to get information
Returns:
dict: A dictionary of information about the group
CLI Example:
.. code-block:: bash
salt '*' group.info foo
u Failed to access group {0}. {1}i u nameu passwdu gidu membersN( R t Namet membersR R! R" R R# R$ R% R t debugR t None( R t groupObjt gr_namet xt gr_memR, R- ( ( s= /usr/lib/python2.7/site-packages/salt/modules/win_groupadd.pyR � s )
c C@ s� d t k r | r t d Sg } t � } xl | D]d } i t d | j � d 6g | j � D] } t | � ^ q[ d 6| j d 6d d 6} | j | � q1 W| t d <| S( u�
Return info on all groups
Args:
refresh (bool):
Refresh the info for all groups in ``__context__``. If False only
the groups in ``__context__`` will be returned. If True the
``__context__`` will be refreshed with current data and returned.
Default is False
Returns:
A list of groups and their information
CLI Example:
.. code-block:: bash
salt '*' group.getent
u group.getentu file.group_to_gidu gidu membersu nameu xu passwd( t __context__R t __salt__R1 R2 R t append( t refresht retR t resultR7 t group( ( s= /usr/lib/python2.7/site-packages/salt/modules/win_groupadd.pyt getent� s
&
c K@ sF y t | � } WnF t j k
rX } d j | t j | j d � � } t j | � t SXg | j
� D] } t | � ^ qf } t j
j j | � } yc | | k r� | j d | j d d � � t j d j | � � n t j d j | | � � t SWnI t j k
rA} d j | | t j | j d � � } t j | � t SXt S( uZ
Add a user to a group
Args:
name (str):
The name of the group to modify
username (str):
The name of the user to add to the group
Returns:
bool: ``True`` if successful, otherwise ``False``
CLI Example:
.. code-block:: bash
salt '*' group.adduser foo username
u Failed to access group {0}. {1}i u WinNT://u \u /u Added user {0}u# User {0} is already a member of {1}u# Failed to add {0} to group {1}. {2}( R R! R" R R# R$ R% R R& R R2 R R R t
win_functionst get_sam_namet AddR R R' R( ( R t usernameR) t group_objR, R- R7 t existing_members( ( s= /usr/lib/python2.7/site-packages/salt/modules/win_groupadd.pyt adduser� s*
%
c K@ s@ y t | � } WnF t j k
rX } d j | t j | j d � � } t j | � t SXg | j
� D] } t | � ^ qf } yr t j
j j | � | k r� | j d | j d d � � t j d j | � � n t j d j | | � � t SWnI t j k
r;} d j | | t j | j d � � } t j | � t SXt S( ud
Remove a user from a group
Args:
name (str):
The name of the group to modify
username (str):
The name of the user to remove from the group
Returns:
bool: ``True`` if successful, otherwise ``False``
CLI Example:
.. code-block:: bash
salt '*' group.deluser foo username
u Failed to access group {0}. {1}i u WinNT://u \u /u Removed user {0}u User {0} is not a member of {1}u( Failed to remove {0} from group {1}. {2}( R R! R" R R# R$ R% R R& R R2 R R R RA RB t RemoveR R R' R( ( R RD R) RE R, R- R7 RF ( ( s= /usr/lib/python2.7/site-packages/salt/modules/win_groupadd.pyt deluser! s(
%
c K@ sc g | j d � D] } t j j j | � ^ q } t | t � sQ t j d � t Sy t
| � } WnF t j k
r� } d j
| t j | j d � � } t j | � t SXg | j � D] } t | � ^ q� } | j � | j � | | k r t j d j
| � � t St } x� | D]� }
|
| k ry7 | j d |
j d d � � t j d j
|
� � Wq�t j k
r�} d
j
|
| t j | j d � � } t j | � t } q�XqqWx� | D]� }
|
| k r�y7 | j d |
j d d � � t j d j
|
� � Wq[t j k
rW} d j
|
| t j | j d � � } t j | � t } q[Xq�q�W| S(
u�
Ensure a group contains only the members in the list
Args:
name (str):
The name of the group to modify
members_list (str):
A single user or a comma separated list of users. The group will
contain only the users specified in this list.
Returns:
bool: ``True`` if successful, otherwise ``False``
CLI Example:
.. code-block:: bash
salt '*' group.members foo 'user1,user2,user3'
u ,u member_list is not a listu Failed to access group {0}. {1}i u {0} membership is correctu WinNT://u \u /u User added: {0}u Failed to add {0} to {1}. {2}u User removed: {0}u" Failed to remove {0} from {1}. {2}( t splitR R RA RB t
isinstancet listR R3 R R R! R" R R# R$ R% R& R2 R t sortR R( RC R RH ( R t members_listR) t mt obj_groupR, R- R7 RF t successR ( ( s= /usr/lib/python2.7/site-packages/salt/modules/win_groupadd.pyR2 P sN 1
%
c C@ sY d t k r | r t d St � } g } x | D] } | j | j � q1 W| t d <| S( u�
Return a list of groups
Args:
refresh (bool):
Refresh the info for all groups in ``__context__``. If False only
the groups in ``__context__`` will be returned. If True, the
``__context__`` will be refreshed with current data and returned.
Default is False
Returns:
list: A list of groups on the machine
CLI Example:
.. code-block:: bash
salt '*' group.list_groups
u group.list_groups( R9 R R; R1 ( R< R R= R> ( ( s= /usr/lib/python2.7/site-packages/salt/modules/win_groupadd.pyt list_groups� s
(# t __doc__t
__future__R R R t loggingt salt.utils.platformR t salt.utils.win_functionst salt.utils.winapiR# t win32com.clientR
R! R( R t ImportErrorR t getLoggert __name__R R R
R R R R R. R0 R R@ RG RI R2 RR ( ( ( s= /usr/lib/python2.7/site-packages/salt/modules/win_groupadd.pyt <module>
s6
# # % & 0 / H
Mini Shell