Installation des composants IIS

IIS et ses composants sont exposés par Windows en tant que fonctionnalités facultatives. Cela permet aux utilisateurs d’activer uniquement les fonctionnalités d’IIS dont ils ont besoin pour que leurs sites fonctionnent. En tant qu’effet secondaire, lors de la configuration d’IIS via l’API, il est possible qu’une fonctionnalité, par exemple l’authentification Windows, ne soit pas encore installée sur l’ordinateur. Historiquement, l’activation des fonctionnalités IIS a été effectuée via DISM.exe, les commandes PowerShell ou l’interface utilisateur de fonctionnalité facultative Windows. L’API Administration IIS expose une méthode simple pour installer/désinstaller ces fonctionnalités afin que les consommateurs n’aient pas à modifier les environnements afin d’activer les fonctionnalités dont ils dépendent.

Vérification de l’installation d’une fonctionnalité

La première étape de la gestion d’une fonctionnalité consiste à vérifier s’il est installé. Pour toute fonctionnalité IIS, nous pouvons déterminer cela en envoyant une requête à son point de terminaison d’API. Si le point de terminaison retourne une réponse 200 OK, la fonctionnalité est installée. Si la fonctionnalité n’est pas installée, l’API retourne une réponse 404 introuvable avec une fonctionnalité non installée objet d’erreur JSON dans le corps. Cet exemple utilise la fonctionnalité de document par défaut d’IIS. Nous vérifions si le document par défaut est activé en envoyant une requête GET au point de terminaison de document par défaut. Nous utilisons étendue dans la chaîne de requête avec une valeur vide pour spécifier que nous ciblant l’étendue du serveur web.

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

fonctionnalité n’est pas installée

404 Not Found


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

fonctionnalité est installée

200 OK


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

Installation d’une fonctionnalité

L’installation des fonctionnalités est effectuée en émettant une demande POST au point de terminaison de la fonctionnalité. Certaines fonctionnalités IIS telles que le magasin de certificats central nécessitent que les paramètres initiaux soient fournis lors de l’installation. Par exemple, supposons que la fonctionnalité de document par défaut retourne la fonctionnalité 404 non installée réponse. L’envoi d’une requête POST au point de terminaison de documents par défaut installe la fonctionnalité, puis retourne les paramètres des fonctionnalités.

POST/api/webserver/default-documents

réponse 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
}

Désinstallation d’une fonctionnalité

Les fonctionnalités IIS peuvent être désinstallées en émettant une demande DELETE à la fonctionnalité au niveau du serveur web. Pour les fonctionnalités IIS qui prennent en charge la configuration au niveau du site web et de l’application, vous pouvez vérifier que l’objet représente l’étendue du serveur web en veillant à ce que l’étendue champ soit vide.

Commencez par obtenir l’URI de la fonctionnalité à désinstaller.

GET/api/webserver

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

Ensuite, émettez la demande DELETE au point de terminaison des fonctionnalités

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

204 NO CONTENT