Composant logiciel enfichable PowerShell : utilisation du système d’aide PowerShell

  • Article

par Thomas Deml

Dans cette procédure pas à pas, vous allez découvrir comment obtenir de l’aide sur l’utilisation du composant logiciel enfichable IIS PowerShell.

Introduction

Le composant logiciel enfichable IIS PowerShell utilise deux types d’applets de commande.

  1. Les applets de commande intégrées telles que New-Item, Get-ChildItems ou Set-ItemProperty sont implémentées dans chaque espace de noms (par exemple, le système de fichiers) et fonctionnent également avec le composant logiciel enfichable IIS PowerShell. Ces applets de commande intégrées s’appliquent aux conteneurs exposés dans la hiérarchie IIS : sites, pools d’applications, applications web et répertoires virtuels.
  2. Les applets de commande spécifiques IIS PowerShell, telles que Get-WebConfiguration, Set-WebConfigurationProperty ou Get-WebItemState, s’appliquent uniquement à IIS. Ces cmdlet de commande doivent être utilisées pour gérer la configuration des fonctionnalités ou l’état d’exécution. Les exemples de configuration des fonctionnalités sont la configuration defaultDocument, les paramètres de compression, les modules et la configuration des gestionnaires, etc. Les exemples d’état d’exécution sont l’état des pools d’applications et des sites.

Aide pour les cmdlet de commande intégrées

L’obtention de l’aide pour ces deux types d’applets de commande est différente. Pour obtenir de l’aide sur la façon dont les applets de commande intégrées peuvent être utilisées dans l’espace de noms IIS:\ vous devez utiliser la commande suivante :

get-help WebAdministration | more

La sortie de cette commande vous donne une vue d’ensemble détaillée de la façon dont les applets de commande intégrées peuvent être utilisées dans l’espace de noms IIS. Il vous montre la syntaxe et les paramètres supplémentaires à spécifier. Enfin, il affiche un grand ensemble d’exemples qui vous aideront à vous familiariser avec ces applets de commande.

Aide pour les applets de commande spécifiques à IIS

Si vous souhaitez obtenir de l’aide pour les applets de commande spécifiques à IIS, vous devez utiliser la commande suivante :

Get-Help <cmdlet name>

Exemples :

Get-Help Get-WebConfiguration
Get-Help Get-WebItemState
Get-Help Add-WebConfiguration

Vous pouvez exécuter la commande suivante pour récupérer une liste des applets de commande que IIS fournit :

PS IIS:\> Get-Command -pssnapin IISProviderSnapIn
CommandType     Name                                      Definition
-----------     ----                                      ----------
Cmdlet          Add-WebConfiguration                      Add-WebConfiguration [-Filter] <String...
Cmdlet          Add-WebConfigurationProperty              Add-WebConfigurationProperty [-Filter]...
Cmdlet          Begin-Transaction                         Begin-Transaction [[-PSPath] <String[]...
Cmdlet          Clear-WebConfiguration                    Clear-WebConfiguration [-Filter] <Stri...
Cmdlet          End-Transaction                           End-Transaction [[-PSPath] <String[]>]...
Cmdlet          Get-section                               Get-section [-Section] <String> [-PSPa...
Cmdlet          Get-URL                                   Get-URL [-Url <String>] [-PSPath <Stri...
Cmdlet          Get-WebConfiguration                      Get-WebConfiguration [-Filter] <String...
Cmdlet          Get-WebConfigurationProperty              Get-WebConfigurationProperty [-Filter]...
Cmdlet          Get-WebItemState                          Get-WebItemState [[-PSPath] <String[]>...
Cmdlet          Remove-WebConfigurationProperty           Remove-WebConfigurationProperty [-Filt...
Cmdlet          Restart-WebItem                           Restart-WebItem [[-PSPath] <String[]>]...
Cmdlet          Set-WebConfiguration                      Set-WebConfiguration [-Filter] <String...
Cmdlet          Set-WebConfigurationProperty              Set-WebConfigurationProperty [-Filter]...
Cmdlet          Start-WebItem                             Start-WebItem [[-PSPath] <String[]>] [...
Cmdlet          Stop-WebItem                              Stop-WebItem [[-PSPath] <String[]>] [-...

Résumé

Dans cette procédure pas à pas, vous avez appris à utiliser le système d’aide PowerShell pour obtenir plus d’informations sur l’utilisation d’applets de commande intégrées dans l’espace de noms IIS, mais également sur l’utilisation d’applets de commande spécifiques à IIS.