Instalación de componentes de IIS

Windows expone IIS y sus componentes como características opcionales. Esto proporciona una manera de que los usuarios solo puedan habilitar las características de IIS que necesitan para que sus sitios funcionen. Como efecto secundario, al configurar IIS a través de la API, es posible que una característica, por ejemplo, autenticación de Windows, aún no esté instalada en la máquina. Históricamente, la habilitación de características de IIS se realizó a través de DISM.exe, comandos de PowerShell o la interfaz de usuario de características opcionales de Windows. La API de administración de IIS expone un método sencillo para instalar o desinstalar estas características para que los consumidores no tengan que cambiar los entornos con el fin de habilitar las características de las que dependen.

Comprobación de si hay instalada una característica

El primer paso para administrar una característica es comprobar si está instalado. Para cualquier característica de IIS, podemos determinarlo enviando una solicitud a su punto de conexión de API. Si el punto de conexión devuelve un 200 Aceptar respuesta, se instala la característica. Si la característica no está instalada, la API devolverá una respuesta 404 No encontrado con un objeto de error Característica no instalada JSON en el cuerpo. En este ejemplo se usará la característica de documento predeterminada de IIS. Comprobamos si el documento predeterminado está habilitado mediante el envío de una solicitud GET al punto de conexión de documento predeterminado. Usamos ámbito en la cadena de consulta con un valor vacío para especificar que estamos destinando el ámbito del servidor web.

GET/api/webserver/default-documents?scope=

característica no está instalada

404 Not Found


{
    "title": "Not found",
    "detail": "IIS feature not installed",
    "name": "Default Document",
    "status": "404"
}

característica está instalada

200 OK


{
    "id": "{id}",
    "enabled": "true",
    "scope": "",
    "metadata": {
        "is_local": "true",
        "is_locked": "false",
        "override_mode": "allow",
        "override_mode_effective": "allow"
    },
    "website": null
}

Instalación de una característica

La instalación de características se realiza mediante la emisión de una solicitud POST al punto de conexión de la característica. Algunas características de IIS, como el almacén de certificados central de , requieren que se proporcione la configuración inicial al instalar. Por ejemplo, supongamos que la característica de documento predeterminada devolvía la respuesta 404 Feature Not Installed. El envío de una solicitud POST al punto de conexión de documentos predeterminado instala la característica y, a continuación, devuelve la configuración de características.

POST/api/webserver/default-documents

de respuesta HTTP

201 CREATED
Location: /api/webserver/default-documents/{id}


{
    "id": "{id}",
    "enabled": "true",
    "scope": "",
    "metadata": {
        "is_local": "true",
        "is_locked": "false",
        "override_mode": "allow",
        "override_mode_effective": "allow"
    },
    "website": null
}

Desinstalación de una característica

Las características de IIS se pueden desinstalar mediante la emisión de una solicitud DELETE de a la característica en el nivel de servidor web. En el caso de las características de IIS que admiten la configuración en los niveles de sitio web y de aplicación, puede comprobar que el objeto representa el ámbito del servidor web asegurándose de que el ámbito de campo está vacío.

En primer lugar, obtenga el URI de la característica que se va a desinstalar.

GET/api/webserver

{
    "id": "{id}",
    "_links": {
        ... // Other features omitted
        "default_document": {
            "href": "/api/webserver/default-documents/{def-doc-id}"
        }
    }
}

A continuación, emita la solicitud DELETE al punto de conexión de características.

DELETE/api/webserver/default-documents/{def-doc-id}

204 NO CONTENT