cchurch.win-iis

概要バージョン洞察

Win-IIS

Windows Server上の基本的なIIS（インターネット情報サービス）設定を管理します。Web-Server機能が存在しない場合は、インストールされます。

ロール変数

サイトで使用するアプリプールを作成または更新するために、以下の変数を使用します：

iis_app_pool_name: 作成または更新するアプリプールの名前; デフォルトは'DefaultAppPool'です。
iis_app_pool_attributes: アプリプールの設定に関する追加属性; デフォルトは''で、追加属性は指定されません。

基本的なIISサイトオプションを設定するために、以下の変数を使用します：

iis_site_name: IISサイトの名前; デフォルトは'Default Web Site'です。
iis_site_id: 数値のサイトID、新しいサイトを作成する際のみ指定できます; デフォルトは''で、サイトIDは省略されます。
iis_site_ip: 接続を待ち受けるIPアドレス; デフォルトは'*'で、すべてのアドレスを待ち受けます。
iis_site_port: 接続を待ち受けるポート; デフォルトは80です。
iis_site_ssl: サイトでSSLトラフィックを処理できるようにします; デフォルトはfalseです。以下のバインディングオプションを使用して、SSLサイトのホスト名、プロトコル、証明書情報を指定します。
iis_site_hostname: サイトの主要なホスト名; デフォルトは''で、同じIPとポートに対して他のサイトのために設定されていない任意のホスト名に応答します。
iis_site_path: このサイトで提供されるファイルを含むディレクトリ、まだ存在しない場合は作成されます。デフォルトは'C:\inetpub\wwwroot'で、IISインストール時に設定される通常のデフォルトパスです。
iis_site_parameters: サイト設定のための追加パラメータ; デフォルトは''で、追加パラメータは指定されません。
iis_site_state: サイトの状態; デフォルトは'started'です。'absent'を使用するとサイトを削除できます。
iis_site_web_config: iis_site_pathにweb.configファイルを作成するために使用されるJinjaテンプレートのローカルパス; デフォルトは""で、web.configファイルは作成されません。
iis_site_web_config_force: 既に存在する場合でも、常にweb.configファイルを書き込みます; デフォルトはtrueです。

サイトが提供される追加のホスト名、アドレス、またはポートを指定するために、以下の変数を使用します。iis_binding_*変数は、iis_bindings内の各項目のデフォルトを提供しますが、上書きが可能です。

iis_binding_host_header: バインディングのための追加ホスト名; デフォルトは''です。
iis_binding_ip: 接続を待ち受ける追加のIPアドレス; デフォルトは'*'です。
iis_binding_port: 接続を待ち受ける追加のポート; デフォルトは80です。
iis_binding_protocol: 接続で使用するプロトコル; デフォルトは'http'です。サポートされている値は'http'、'https'、および'ftp'です。
iis_binding_state: バインディングの状態; デフォルトは'present'です。'absent'を使用してバインディングを削除できます。
iis_binding_certificate_store_name: SSL証明書を含む証明書ストアの名前; デフォルトは'My'です。
iis_binding_certificate_hash: SSL証明書のハッシュ; デフォルトは''で、証明書は指定されません。
iis_bindings: サイトバインディングを指定する項目のリスト、各項目では以下のキーを使用してデフォルトを上書きできます：
- host_header
- ip
- port
- protocol
- state
- certificate_store_name
- certificate_hash

サイトパスに設定されたファイルシステムの権限を上書きするために、以下の変数を使用します：

iis_acl_path: ACLを更新するためのパス; デフォルトはiis_site_pathです。ACLの更新をスキップする場合は""（空文字列）を指定します。
iis_acl_user: IISユーザーグループ; デフォルトは'IIS_IUSRS'です。
iis_acl_rights: ユーザーまたはグループに割り当てる権利; デフォルトは'FullControl'です。
iis_acl_type: ACLタイプ; デフォルトは'allow'です。
iis_acl_state: ACLの状態; デフォルトは'present'です。
iis_acl_inherit: ACLの継承オプション; デフォルトは'ContainerInherit, ObjectInherit'です。
iis_acl_propagation: ACLの伝播オプション; デフォルトは'None'です。

例プレイブック

以下の例のプレイブックは、デフォルトのIISウェブサイトを削除し、その後ポート80に加えてポート8080で提供される新しいサイトを追加します：

    - hosts: windows
      roles:
        - role: cchurch.win-iis
          iis_site_name: 'Default Web Site'
          iis_site_state: absent        
        - role: cchurch.win-iis
          iis_site_name: 'My New Site'
          iis_site_path: 'C:\www\mynewsite'
          iis_bindings:
            - port: 8080