Current File : //usr/lib/python2.7/site-packages/salt/modules/win_psget.pyc
�
���^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 d d l
Z d d l m Z e j
e � Z d Z d � Z d d d � Z d � Z e d
� Z e d � Z d d d d d � Z d d d
� Z d � Z d d � Z d � Z d S( u�
Module for managing PowerShell through PowerShellGet (PSGet)
:depends:
- PowerShell 5.0
- PSGet
Support for PowerShell
i ( t absolute_importt print_functiont unicode_literalsN( t CommandExecutionErroru psgetc C@ s� t j j j � s) t j d � t d f St d d � } | d sZ t j d � t d f St j j j | d d d � r� t j d � t d
f St
S( u8
Set the system module of the kernel is Windows
u/ Module PSGet: Only available on Windows systemsu cmd.shell_infou
powershellu installedu! Module PSGet: Requires PowerShellu versionu <u 5.0u, Module PSGet: Requires PowerShell 5 or neweru- Module PSGet: Requires PowerShell 5 or newer.( t saltt utilst platformt
is_windowst logt debugt Falset __salt__t versionst comparet __virtualname__( t powershell_info( ( s: /usr/lib/python2.7/site-packages/salt/modules/win_psget.pyt __virtual__ s
i c C@ s� d | j � k r' d j | | � } n t j d | � t d | d d d | d t �} d | k ro | d =n d
| k s� | d
d k r� t d j | � d
| �� n y# t j j j
| d d t �} Wn# t k
r� t d d
| �� n X| S( u}
Execute the desired powershell command and ensure that it returns data
in json format and load that into python
u convertto-jsonu {0} | ConvertTo-Json -Depth {1}u DSC: %su cmd.run_allt shellu
powershellt cwdt python_shellu pidu retcodei u Issue executing powershell {0}t infou stdoutt strictu No JSON results from powershell(
t lowert formatR R R t TrueR R R t jsont loadsR
t
ValueError( t cmdR t
json_deptht resultst ret( ( s: /usr/lib/python2.7/site-packages/salt/modules/win_psget.pyt _pshell5 s "
#
c C@ s d } t | � } | S( u�
Make sure that nuget-anycpu.exe is installed.
This will download the official nuget-anycpu.exe from the internet.
CLI Example:
.. code-block:: bash
salt 'win01' psget.bootstrap
u/ Get-PackageProvider -Name NuGet -ForceBootstrap( R ( R R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/win_psget.pyt bootstrapN s c C@ sk d } t | � } g } | r' i } n x= | D]5 } | rR | d | | d <q. n | j | d � q. W| S( u:
List available modules in registered Powershell module repositories.
:param desc: If ``True``, the verbose description will be returned.
:type desc: ``bool``
CLI Example:
.. code-block:: bash
salt 'win01' psget.avail_modules
salt 'win01' psget.avail_modules desc=True
u Find-Moduleu Descriptionu Name( R t append( t descR t modulest namest module( ( s: /usr/lib/python2.7/site-packages/salt/modules/win_psget.pyt
avail_modules^ s
c C@ s� d } t | � } t | t � ri g } | rT i } t j | � | | d <| } | S| j | d � | Sg } | r~ i } n x9 | D]1 } | r� | | | d <q� n | j | d � q� W| S( u)
List currently installed PSGet Modules on the system.
:param desc: If ``True``, the verbose description will be returned.
:type desc: ``bool``
CLI Example:
.. code-block:: bash
salt 'win01' psget.list_modules
salt 'win01' psget.list_modules desc=True
u Get-InstalledModuleu Name( R t
isinstancet dictt copyt deepcopyR" ( R# R R$ R t modules_retR% R& ( ( s: /usr/lib/python2.7/site-packages/salt/modules/win_psget.pyt list_modulesy s(
c
C@ s� d | f g } | d k r1 | j d | f � n | d k rS | j d | f � n | d k ru | j d | f � n | d k r� | j d | f � n d } x* | D]" \ } } | d j | | � 7} q� Wd j | � } t | � | t � k S(
u�
Install a Powershell module from powershell gallery on the system.
:param name: Name of a Powershell module
:type name: ``str``
:param minimum_version: The maximum version to install, e.g. 1.23.2
:type minimum_version: ``str``
:param required_version: Install a specific version
:type required_version: ``str``
:param scope: The scope to install the module to, e.g. CurrentUser, Computer
:type scope: ``str``
:param repository: The friendly name of a private repository, e.g. MyREpo
:type repository: ``str``
CLI Example:
.. code-block:: bash
salt 'win01' psget.install PowerPlan
u Nameu MinimumVersionu RequiredVersionu Scopeu
Repositoryu u -{0} {1} u Install-Module {0} -ForceN( t NoneR" R R R- (
t namet minimum_versiont required_versiont scopet
repositoryt flagst paramst flagt valueR ( ( s: /usr/lib/python2.7/site-packages/salt/modules/win_psget.pyt install� s
c C@ s� d | f g } | d k r1 | j d | f � n | d k rS | j d | f � n d } x* | D]" \ } } | d j | | � 7} q` Wd j | � } t | � | t � k S( u�
Update a PowerShell module to a specific version, or the newest
:param name: Name of a Powershell module
:type name: ``str``
:param maximum_version: The maximum version to install, e.g. 1.23.2
:type maximum_version: ``str``
:param required_version: Install a specific version
:type required_version: ``str``
CLI Example:
.. code-block:: bash
salt 'win01' psget.update PowerPlan
u Nameu MaximumVersionu RequiredVersionu u -{0} {1} u Update-Module {0} -ForceN( R. R" R R R- ( R/ t maximum_versionR1 R4 R5 R6 R7 R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/win_psget.pyt update� s
c C@ s( d j | � } t | � } | t � k S( u�
Remove a Powershell DSC module from the system.
:param name: Name of a Powershell DSC module
:type name: ``str``
CLI Example:
.. code-block:: bash
salt 'win01' psget.remove PowerPlan
u Uninstall-Module "{0}"( R R R- ( R/ R t no_ret( ( s: /usr/lib/python2.7/site-packages/salt/modules/win_psget.pyt remove� s c C@ s� d | f g } | j d | f � | d k rD | j d | f � n d } x* | D]" \ } } | d j | | � 7} qQ Wd j | � } t | � } | t � k S( u�
Register a PSGet repository on the local machine
:param name: The name for the repository
:type name: ``str``
:param location: The URI for the repository
:type location: ``str``
:param installation_policy: The installation policy
for packages, e.g. Trusted, Untrusted
:type installation_policy: ``str``
CLI Example:
.. code-block:: bash
salt 'win01' psget.register_repository MyRepo https://myrepo.mycompany.com/packages
u Nameu SourceLocationu InstallationPolicyu u -{0} {1} u Register-PSRepository {0}N( R" R. R R R- ( R/ t locationt installation_policyR4 R5 R6 R7 R R; ( ( s: /usr/lib/python2.7/site-packages/salt/modules/win_psget.pyt register_repository s c C@ s( d j | � } t | � } | t � k S( u�
Get the details of a local PSGet repository
:param name: Name of the repository
:type name: ``str``
CLI Example:
.. code-block:: bash
salt 'win01' psget.get_repository MyRepo
u Get-PSRepository "{0}"( R R R- ( R/ R R; ( ( s: /usr/lib/python2.7/site-packages/salt/modules/win_psget.pyt get_repository# s ( t __doc__t
__future__R R R R* t loggingt salt.utils.jsonR t salt.utils.platformt salt.utils.versionst salt.exceptionsR t getLoggert __name__R R R R. R R! R
R' R- R8 R: R< R? R@ ( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/win_psget.pyt <module>
s( $ ,# #
Mini Shell