Current File : //lib/python2.7/site-packages/salt/states/win_iis.pyc
�
���^c @@ s d Z d d l m Z m Z m Z d Z d � Z d d d d � Z d d d d d d
� Z d � Z d d d d d d � Z
d d d d
� Z d d d d d � Z d d d d � Z
d � Z d � Z d d � Z d d � Z d � Z d d � Z d d � Z d d � Z d S( u�
Microsoft IIS site management
This module provides the ability to add/remove websites and application pools
from Microsoft IIS.
.. versionadded:: 2016.3.0
i ( t absolute_importt unicode_literalst print_functionu win_iisc C@ s d t k r t St S( u<
Load only on minions that have the win_iis module.
u win_iis.create_site( t __salt__t __virtualname__t False( ( ( s7 /usr/lib/python2.7/site-packages/salt/states/win_iis.pyt __virtual__ s u u *iP c C@ s% d j | | | j d d � � } | S( u[
Combine the host header, IP address, and TCP port into bindingInformation format.
u {0}:{1}:{2}u u ( t formatt replace( t
hostheadert ipaddresst portt ret( ( s7 /usr/lib/python2.7/site-packages/salt/states/win_iis.pyt _get_binding_info s !u httpc C@ s� i | d 6i d 6d d 6d d 6} t d � } | | k r[ d j | � | d <t | d <n� t d r� d j | � | d <i d d
6| d 6| d <nQ d j | � | d <i d d
6| d 6| d <t d
| | | | | | | � | d <| S( u�
Ensure the website has been deployed.
.. note:
This function only validates against the site name, and will return True even
if the site already exists with a different configuration. It will not modify
the configuration of an existing site.
:param str name: The IIS site name.
:param str sourcepath: The physical path of the IIS site.
:param str apppool: The name of the IIS application pool.
:param str hostheader: The host header of the binding.
:param str ipaddress: The IP address of the binding.
:param str port: The TCP port of the binding.
:param str protocol: The application protocol of the binding.
.. note:
If an application pool is specified, and that application pool does not already exist,
it will be created.
Example of usage with only the required arguments. This will default to using the default application pool
assigned by IIS:
.. code-block:: yaml
site0-deployed:
win_iis.deployed:
- name: site0
- sourcepath: C:\inetpub\site0
Example of usage specifying all available arguments:
.. code-block:: yaml
site0-deployed:
win_iis.deployed:
- name: site0
- sourcepath: C:\inetpub\site0
- apppool: site0
- hostheader: site0.local
- ipaddress: '*'
- port: 443
- protocol: https
u nameu changesu resultu u commentu win_iis.list_sitesu Site already present: {0}u testu Site will be created: {0}u oldu newu Created site: {0}u win_iis.create_siteN( t NoneR R t Truet __opts__( t namet
sourcepatht apppoolR R
R t protocolR t
current_sites( ( s7 /usr/lib/python2.7/site-packages/salt/states/win_iis.pyt deployed& s& /
c C@ s� i | d 6i d 6d d 6d d 6} t d � } | | k r[ d j | � | d <t | d <nw t d r� d j | � | d <i | d
6d d 6| d <n? d j | � | d <i | d
6d d 6| d <t d
| � | d <| S( u�
Delete a website from IIS.
:param str name: The IIS site name.
Usage:
.. code-block:: yaml
defaultwebsite-remove:
win_iis.remove_site:
- name: Default Web Site
u nameu changesu resultu u commentu win_iis.list_sitesu" Site has already been removed: {0}u testu Site will be removed: {0}u oldu newu Removed site: {0}u win_iis.remove_siteN( R R R R R ( R R R ( ( s7 /usr/lib/python2.7/site-packages/salt/states/win_iis.pyt remove_sitem s"
c
C@ s� i | d 6i d 6t � d 6d
d 6} t | | | � } t d | � } | | k rs d j | � | d <t | d <n� t d r� d j | � | d <i d
d 6| d
6| d <nN d j | � | d <i d
d 6| d
6| d <t d | | | | | | � | d <| S( u�
Create an IIS binding.
.. note:
This function only validates against the binding ipaddress:port:hostheader combination,
and will return True even if the binding already exists with a different configuration.
It will not modify the configuration of an existing binding.
:param str site: The IIS site name.
:param str hostheader: The host header of the binding.
:param str ipaddress: The IP address of the binding.
:param str port: The TCP port of the binding.
:param str protocol: The application protocol of the binding.
:param str sslflags: The flags representing certificate type and storage of the binding.
Example of usage with only the required arguments:
.. code-block:: yaml
site0-https-binding:
win_iis.create_binding:
- site: site0
Example of usage specifying all available arguments:
.. code-block:: yaml
site0-https-binding:
win_iis.create_binding:
- site: site0
- hostheader: site0.local
- ipaddress: '*'
- port: 443
- protocol: https
- sslflags: 0
u nameu changesu commentu resultu win_iis.list_bindingsu Binding already present: {0}u testu Binding will be created: {0}u oldu newu Created binding: {0}u win_iis.create_bindingN( t strR R
R R R R (
R t siteR R
R R t sslflagsR t binding_infot current_bindings( ( s7 /usr/lib/python2.7/site-packages/salt/states/win_iis.pyt create_binding� s& &
c C@ s� i | d 6i d 6t � d 6d
d 6} t | | | � } t d | � } | | k rs d j | � | d <t | d <n� t d r� d j | � | d <i | d 6d
d
6| d <nH d j | � | d <i | d 6d
d
6| d <t d | | | | � | d <| S( u�
Remove an IIS binding.
:param str site: The IIS site name.
:param str hostheader: The host header of the binding.
:param str ipaddress: The IP address of the binding.
:param str port: The TCP port of the binding.
Example of usage with only the required arguments:
.. code-block:: yaml
site0-https-binding-remove:
win_iis.remove_binding:
- site: site0
Example of usage specifying all available arguments:
.. code-block:: yaml
site0-https-binding-remove:
win_iis.remove_binding:
- site: site0
- hostheader: site0.local
- ipaddress: '*'
- port: 443
u nameu changesu commentu resultu win_iis.list_bindingsu% Binding has already been removed: {0}u testu Binding will be removed: {0}u oldu newu Removed binding: {0}u win_iis.remove_bindingN( R R R
R R R R ( R R R R
R R R R ( ( s7 /usr/lib/python2.7/site-packages/salt/states/win_iis.pyt remove_binding� s&
i� c
C@ s8 i | d 6i d 6t � d 6d d 6} t | | | � } t d | � } | | k r� | | d } | | k r� d j | � | d <t | d <| Sd j | � | d <t | d <n� t d r� d
j | � | d <i d d 6| d 6| d <nN d
j | � | d <i d d 6| d 6| d <t d | | | | | | � | d <| S( u�
Assign a certificate to an IIS binding.
.. note:
The web binding that the certificate is being assigned to must already exist.
:param str name: The thumbprint of the certificate.
:param str site: The IIS site name.
:param str hostheader: The host header of the binding.
:param str ipaddress: The IP address of the binding.
:param str port: The TCP port of the binding.
:param str sslflags: Flags representing certificate type and certificate storage of the binding.
Example of usage with only the required arguments:
.. code-block:: yaml
site0-cert-binding:
win_iis.create_cert_binding:
- name: 9988776655443322111000AAABBBCCCDDDEEEFFF
- site: site0
Example of usage specifying all available arguments:
.. code-block:: yaml
site0-cert-binding:
win_iis.create_cert_binding:
- name: 9988776655443322111000AAABBBCCCDDDEEEFFF
- site: site0
- hostheader: site0.local
- ipaddress: 192.168.1.199
- port: 443
- sslflags: 1
.. versionadded:: 2016.11.0
u nameu changesu commentu resultu win_iis.list_cert_bindingsu certificatehashu( Certificate binding already present: {0}uD Certificate binding already present with a different thumbprint: {0}u testu( Certificate binding will be created: {0}u oldu newu Created certificate binding: {0}u win_iis.create_cert_bindingN( R R R
R R R R R (
R R R R
R R R R t current_cert_bindingst current_name( ( s7 /usr/lib/python2.7/site-packages/salt/states/win_iis.pyt create_cert_binding s2 '
c C@ s i | d 6i d 6t � d 6d d 6} t | | | � } t d | � } | | k rs d j | � | d <t | d <n� t d r� d j | � | d <i | d 6d d
6| d <nh | | d } | | k rd j | � | d <i | d 6d d
6| d <t d
| | | | | � | d <n | S( uU
Remove a certificate from an IIS binding.
.. note:
This function only removes the certificate from the web binding. It does
not remove the web binding itself.
:param str name: The thumbprint of the certificate.
:param str site: The IIS site name.
:param str hostheader: The host header of the binding.
:param str ipaddress: The IP address of the binding.
:param str port: The TCP port of the binding.
Example of usage with only the required arguments:
.. code-block:: yaml
site0-cert-binding-remove:
win_iis.remove_cert_binding:
- name: 9988776655443322111000AAABBBCCCDDDEEEFFF
- site: site0
Example of usage specifying all available arguments:
.. code-block:: yaml
site0-cert-binding-remove:
win_iis.remove_cert_binding:
- name: 9988776655443322111000AAABBBCCCDDDEEEFFF
- site: site0
- hostheader: site0.local
- ipaddress: 192.168.1.199
- port: 443
.. versionadded:: 2016.11.0
u nameu changesu commentu resultu win_iis.list_cert_bindingsu1 Certificate binding has already been removed: {0}u testu( Certificate binding will be removed: {0}u oldu newu certificatehashu Removed certificate binding: {0}u win_iis.remove_cert_bindingN( R R R
R R R R ( R R R R
R R R R R ( ( s7 /usr/lib/python2.7/site-packages/salt/states/win_iis.pyt remove_cert_bindingJ s* &
c C@ s� i | d 6i d 6d d 6d d 6} t d � } | | k r[ d j | � | d <t | d <nw t d r� d j | � | d <i d d
6| d 6| d <n? d j | � | d <i d d
6| d 6| d <t d
| � | d <| S( u�
Create an IIS application pool.
.. note:
This function only validates against the application pool name, and will return
True even if the application pool already exists with a different configuration.
It will not modify the configuration of an existing application pool.
:param str name: The name of the IIS application pool.
Usage:
.. code-block:: yaml
site0-apppool:
win_iis.create_apppool:
- name: site0
u nameu changesu resultu u commentu win_iis.list_apppoolsu% Application pool already present: {0}u testu% Application pool will be created: {0}u oldu newu Created application pool: {0}u win_iis.create_apppoolN( R R R R R ( R R t current_apppools( ( s7 /usr/lib/python2.7/site-packages/salt/states/win_iis.pyt create_apppool� s"
c C@ s� i | d 6i d 6d d 6d d 6} t d � } | | k r[ d j | � | d <t | d <nw t d r� d j | � | d <i | d
6d d 6| d <n? d j | � | d <i | d
6d d 6| d <t d
| � | d <| S( u�
Remove an IIS application pool.
:param str name: The name of the IIS application pool.
Usage:
.. code-block:: yaml
defaultapppool-remove:
win_iis.remove_apppool:
- name: DefaultAppPool
u nameu changesu resultu u commentu win_iis.list_apppoolsu. Application pool has already been removed: {0}u testu% Application pool will be removed: {0}u oldu newu Removed application pool: {0}u win_iis.remove_apppoolN( R R R R R ( R R R# ( ( s7 /usr/lib/python2.7/site-packages/salt/states/win_iis.pyt remove_apppool� s"
c C@ sw i d d 6d d 6d d 6d d 6d d
6} i | d 6i d 6t � d
6d d 6} | sl d | d
<t | d <| Si i d 6i d 6} t d d | d | d | j � � } x� | D]� } | d k r� | | | j � k r� | | | | | <n t | | � t | | � k r� i | | d 6| | d 6| d | <q� q� W| d sVd | d
<t | d <| St d rxd | d
<| | d <| St d d | d | d | � t d d | d | d | j � � } xi | D]a } t | | � t | | � k r�i | | d 6| | d 6| d | <| d j | d � q�q�W| d rQd | d
<| | d <t | d <n" d | d
<| d | d <t | d <| S( u�
Set the value of the setting for an IIS container.
:param str name: The name of the IIS container.
:param str container: The type of IIS container. The container types are:
AppPools, Sites, SslBindings
:param str settings: A dictionary of the setting names and their values.
Example of usage for the ``AppPools`` container:
.. code-block:: yaml
site0-apppool-setting:
win_iis.container_setting:
- name: site0
- container: AppPools
- settings:
managedPipelineMode: Integrated
processModel.maxProcesses: 1
processModel.userName: TestUser
processModel.password: TestPassword
processModel.identityType: SpecificUser
Example of usage for the ``Sites`` container:
.. code-block:: yaml
site0-site-setting:
win_iis.container_setting:
- name: site0
- container: Sites
- settings:
logFile.logFormat: W3C
logFile.period: Daily
limits.maxUrlSegments: 32
u LocalSystemi u LocalServicei u NetworkServicei u SpecificUseri u ApplicationPoolIdentityi u nameu changesu commentu resultu No settings to change provided.u failuresu win_iis.get_container_settingR t containert settingsu processModel.identityTypeu oldu newu- Settings already contain the provided values.u testu Settings will be changed.u win_iis.set_container_settingu Some settings failed to change.u, Set settings to contain the provided values.N( R R R R t keysR t popR ( R R& R' t identityType_map2stringR t ret_settingst current_settingst settingt new_settings( ( s7 /usr/lib/python2.7/site-packages/salt/states/win_iis.pyt container_setting� s\ %)
"
c C@ s� i | d 6i d 6t � d 6d
d 6} t d | � } | | k ra d j | � | d <t | d <n� t d r� d j | � | d <i d
d 6| d
6| d <nH d j | � | d <i d
d 6| d
6| d <t d | | | | � | d <| S( u�
Create an IIS application.
.. note:
This function only validates against the application name, and will return True
even if the application already exists with a different configuration. It will not
modify the configuration of an existing application.
:param str name: The IIS application.
:param str site: The IIS site name.
:param str sourcepath: The physical path.
:param str apppool: The name of the IIS application pool.
Example of usage with only the required arguments:
.. code-block:: yaml
site0-v1-app:
win_iis.create_app:
- name: v1
- site: site0
- sourcepath: C:\inetpub\site0\v1
Example of usage specifying all available arguments:
.. code-block:: yaml
site0-v1-app:
win_iis.create_app:
- name: v1
- site: site0
- sourcepath: C:\inetpub\site0\v1
- apppool: site0
u nameu changesu commentu resultu win_iis.list_appsu Application already present: {0}u testu Application will be created: {0}u oldu newu Created application: {0}u win_iis.create_appN( R R R R R R ( R R R R R t current_apps( ( s7 /usr/lib/python2.7/site-packages/salt/states/win_iis.pyt
create_app< s$ $
c C@ s� i | d 6i d 6t � d 6d
d 6} t d | � } | | k ra d j | � | d <t | d <nz t d r� d j | � | d <i | d 6d
d
6| d <nB d j | � | d <i | d 6d
d
6| d <t d | | � | d <| S( u
Remove an IIS application.
:param str name: The application name.
:param str site: The IIS site name.
Usage:
.. code-block:: yaml
site0-v1-app-remove:
win_iis.remove_app:
- name: v1
- site: site0
u nameu changesu commentu resultu win_iis.list_appsu) Application has already been removed: {0}u testu Application will be removed: {0}u oldu newu Removed application: {0}u win_iis.remove_appN( R R R R R R ( R R R R0 ( ( s7 /usr/lib/python2.7/site-packages/salt/states/win_iis.pyt
remove_appw s"
u /c C@ s� i | d 6i d 6t � d 6d
d 6} t d | | � } | | k rd d j | � | d <t | d <n� t d r� d j | � | d <i d
d 6| d
6| d <nH d j | � | d <i d
d 6| d
6| d <t d | | | | � | d <| S( u�
Create an IIS virtual directory.
.. note:
This function only validates against the virtual directory name, and will return
True even if the virtual directory already exists with a different configuration.
It will not modify the configuration of an existing virtual directory.
:param str name: The virtual directory name.
:param str site: The IIS site name.
:param str sourcepath: The physical path.
:param str app: The IIS application.
Example of usage with only the required arguments:
.. code-block:: yaml
site0-foo-vdir:
win_iis.create_vdir:
- name: foo
- site: site0
- sourcepath: C:\inetpub\vdirs\foo
Example of usage specifying all available arguments:
.. code-block:: yaml
site0-foo-vdir:
win_iis.create_vdir:
- name: foo
- site: site0
- sourcepath: C:\inetpub\vdirs\foo
- app: v1
u nameu changesu commentu resultu win_iis.list_vdirsu& Virtual directory already present: {0}u testu& Virtual directory will be created: {0}u oldu newu Created virtual directory: {0}u win_iis.create_vdirN( R R R R R R ( R R R t appR t
current_vdirs( ( s7 /usr/lib/python2.7/site-packages/salt/states/win_iis.pyt create_vdir� s$ $
c C@ s� i | d 6i d 6t � d 6d
d 6} t d | | � } | | k rd d j | � | d <t | d <n} t d r� d j | � | d <i | d 6d
d
6| d <nE d j | � | d <i | d 6d
d
6| d <t d | | | � | d <| S( uc
Remove an IIS virtual directory.
:param str name: The virtual directory name.
:param str site: The IIS site name.
:param str app: The IIS application.
Example of usage with only the required arguments:
.. code-block:: yaml
site0-foo-vdir-remove:
win_iis.remove_vdir:
- name: foo
- site: site0
Example of usage specifying all available arguments:
.. code-block:: yaml
site0-foo-vdir-remove:
win_iis.remove_vdir:
- name: foo
- site: site0
- app: v1
u nameu changesu commentu resultu win_iis.list_vdirsu/ Virtual directory has already been removed: {0}u testu& Virtual directory will be removed: {0}u oldu newu Removed virtual directory: {0}u win_iis.remove_vdirN( R R R R R R ( R R R3 R R4 ( ( s7 /usr/lib/python2.7/site-packages/salt/states/win_iis.pyt remove_vdir� s"
c C@ s i | d 6i d 6t � d 6d d 6} | sC d | d <t | d <| Si i d 6i d 6} t d d | d | d
| j � � } xU | D]M } t | | � t | | � k r� i | | d 6| | d 6| d | <q� q� W| d s� d
| d <t | d <| St d rd | d <| | d <| St d d | d | d
| � t d d | d | d
| j � � } xi | D]a } t | | � t | | � k rai | | d 6| | d 6| d | <| d j | d � qaqaW| d r�d | d <| | d <t | d <n" d | d <| d | d <t | d <| S( u�
.. versionadded:: 2017.7.0
Set the value of the setting for an IIS web application.
.. note::
This function only configures existing app. Params are case sensitive.
:param str name: The IIS application.
:param str site: The IIS site name.
:param str settings: A dictionary of the setting names and their values.
Available settings:
- ``physicalPath`` - The physical path of the webapp
- ``applicationPool`` - The application pool for the webapp
- ``userName`` "connectAs" user
- ``password`` "connectAs" password for user
:rtype: bool
Example of usage:
.. code-block:: yaml
site0-webapp-setting:
win_iis.set_app:
- name: app0
- site: Default Web Site
- settings:
userName: domain\user
password: pass
physicalPath: c:\inetpub\wwwroot
applicationPool: appPool0
u nameu changesu commentu resultu No settings to change provided.u failuresu win_iis.get_webapp_settingsR R R' u oldu newu- Settings already contain the provided values.u testu Settings will be changed.u win_iis.set_webapp_settingsu Some settings failed to change.u, Set settings to contain the provided values.N( R R R R R( R R) R ( R R R' R R+ R, R- R. ( ( s7 /usr/lib/python2.7/site-packages/salt/states/win_iis.pyt set_app sT &
%
N( t __doc__t
__future__R R R R R R
R R R R R! R" R$ R% R R/ R1 R2 R5 R6 R7 ( ( ( s7 /usr/lib/python2.7/site-packages/salt/states/win_iis.pyt <module>
s$ G %>4FA + & ` ; & < 2
Mini Shell