community.windows.win_iis_virtualdirectory 模块 – 配置 IIS 中的虚拟目录

注意

此模块是 community.windows 集合（版本 2.3.0）的一部分。

如果您使用的是 ansible 包，您可能已经安装了此集合。 它不包含在 ansible-core 中。 要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install community.windows。

要在 playbook 中使用它，请指定：community.windows.win_iis_virtualdirectory。

概要

  • 创建、删除和配置 IIS 中的虚拟目录。

参数

参数

注释

application

字符串

创建或存在虚拟目录的应用程序。

connect_as

字符串

在 community.windows 1.9.0 中添加

用于虚拟目录的身份验证类型。可以是 pass_through 或 specific_user

如果为 pass_through，则 IIS 将使用用户或应用程序池标识的身份来访问物理路径。

如果为 specific_user，则 IIS 将使用在 username 和 password 中提供的凭据来访问物理路径。

选项

  • "pass_through"

  • "specific_user"

name

字符串 / 必填

要创建或删除的虚拟目录的名称。

password

字符串

在 community.windows 1.9.0 中添加

与 username 关联的密码。

当 connect_as 设置为 specific_user 时为必填项。

physical_path

字符串

在其中创建新虚拟目录的文件夹的物理路径。

指定的文件夹必须已存在。

site

字符串 / 必填

创建或存在虚拟目录的站点名称。

state

字符串

是否添加或删除指定的虚拟目录。

删除操作将删除虚拟目录及其下的所有内容（递归）。

选项

  • "absent"

  • "present" ← （默认）

username

字符串

在 community.windows 1.9.0 中添加

指定可以访问虚拟目录的配置文件和内容的用户帐户的用户名。

当 connect_as 设置为 specific_user 时为必填项。

另请参阅

另请参阅

community.windows.win_iis_webapplication

配置 IIS Web 应用程序。

community.windows.win_iis_webapppool

配置 IIS Web 应用程序池。

community.windows.win_iis_webbinding

配置 IIS Web 站点绑定。

community.windows.win_iis_website

配置 IIS Web 站点。

示例

- name: Create a virtual directory if it does not exist
  community.windows.win_iis_virtualdirectory:
    name: somedirectory
    site: somesite
    state: present
    physical_path: C:\virtualdirectory\some

- name: Remove a virtual directory if it exists
  community.windows.win_iis_virtualdirectory:
    name: somedirectory
    site: somesite
    state: absent

- name: Create a virtual directory on an application if it does not exist
  community.windows.win_iis_virtualdirectory:
    name: somedirectory
    site: somesite
    application: someapp
    state: present
    physical_path: C:\virtualdirectory\some

作者

  • Henrik Wallström (@henrikwallstrom)