Classe DirectoryBrowseSection

Article
04/12/2024

Configure l'exploration de répertoire dans IIS.

Syntaxe

class DirectoryBrowseSection : ConfigurationSection

Méthodes

Le tableau suivant répertorie les méthodes exposées par la classe DirectoryBrowseSection.

Nom	Description
GetAllowDefinition	(Hérité de ConfigurationSection.)
GetAllowLocation	(Hérité de `ConfigurationSection`.)
RevertToParent	(Hérité de `ConfigurationSection`.)
SetAllowDefinition	(Hérité de `ConfigurationSection`.)
SetAllowLocation	(Hérité de `ConfigurationSection`.)

Propriétés

Le tableau suivant répertorie les propriétés présentées par la classe DirectoryBrowseSection.

Nom	Description
`Enabled`	Une valeur de `boolean` en lecture/écriture. `true` si l’exploration des répertoires est activée pour un répertoire dans IIS; sinon, `false`. Par défaut, il s’agit de `false`.
`Location`	(Hérité de `ConfigurationSection`.) Une propriété clé.
`Path`	(Hérité de `ConfigurationSection`.) Une propriété clé.
`SectionInformation`	(Hérité de `ConfigurationSection`.)
`ShowFlags`	Valeur `sint32` contenant un masque qui configure l’affichage des informations de fichier dans un répertoire parcouru. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.

Sous-classes

Cette classe ne contient aucune sous-classe.

Notes

Si l’exploration des répertoires est activée pour un répertoire dans IIS, les utilisateurs reçoivent une page qui répertorie le contenu du répertoire lorsque les valeurs suivantes sont vraies :

L’utilisateur ne spécifie pas de fichier dans l’URL (par exemple, l’utilisateur accède à http://www.contoso.com/ la place de http://www.contoso.com/default.htm).)
Les documents par défaut sont désactivés dans IIS, ou IIS ne parvient pas à localiser un fichier dans le répertoire qui correspond à un nom spécifié dans la liste de documents par défaut IIS.

Remarque

Par défaut, l’exploration des répertoires est désactivée dans IIS afin que les utilisateurs ne puissent pas voir le contenu des répertoires. Pour renforcer la sécurité, vous devez laisser la navigation dans le répertoire désactivée, sauf si vous avez une raison spécifique de l’activer, par exemple pour partager des fichiers via HTTP à l’aide de Web Distributed Authoring and Versioning (WebDAV). Si vous activez l’exploration des répertoires, veillez à l’activer uniquement sur le répertoire ou les répertoires particuliers que vous souhaitez partager.

Le tableau suivant répertorie les valeurs possibles pour la propriété ShowFlags. Les valeurs par défaut sont 2 (Date), 4 (Time), 8 (Size), et 16 (Extension).

Valeur	Mot clé	Description
0	`None`	Affiche les noms de fichiers sans extensions. Cet indicateur n’a aucun effet lorsque d’autres indicateurs sont déjà spécifiés.
2	`Date`	Date de dernière modification de chaque fichier.
4	`Time`	Heure de dernière modification de chaque fichier.
8	`Size`	La taille de chaque fichier.
16	`Extension`	Extension de fichier après le nom du fichier.
32	`LongDate`	Date de dernière modification au format étendu pour chaque fichier.

Exemple

L’exemple suivant affiche les propriétés de la classe DirectoryBrowseSection pour le site Web par défaut.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = _  
    GetObject("winmgmts:root\WebAdministration")  
Set oService = GetObject("winmgmts:root\WebAdministration")  
  
' Get the directory browse section of the default Web site.  
Set oSite = oService.Get("Site.Name='Default Web Site'")  
oSite.GetSection "DirectoryBrowseSection", oSection  
  
' Display the properties.  
WScript.Echo "DirectoryBrowseSection Properties"  
WScript.Echo "---------------------------------"  
WScript.Echo "Path: " & oSection.Path  
WScript.Echo "Location: " & oSection.Location  
WScript.Echo "Enabled: " & oSection.Enabled  
WScript.Echo "ShowFlags: " & oSection.ShowFlags  
WScript.Echo   
WScript.Echo "DirectoryBrowseSection.SectionInformation"  
WScript.Echo "-----------------------------------------"  
WScript.Echo "OverrideMode: " & oSection.SectionInformation.OverrideMode  
WScript.Echo "EffectiveOverrideMode: " & oSection.SectionInformation.EffectiveOverrideMode  
WScript.Echo "IsLocked: " & _  
    oSection.SectionInformation.IsLocked  
WScript.Echo "LockItem: " & _  
    oSection.SectionInformation.LockItem

Hiérarchie d'héritage

ConfigurationSection

DirectoryBrowseSection

Spécifications

Type	Description
Client	- IIS 7.0 sur Windows Vista - IIS 7.5 sur Windows 7 - IIS 8.0 sur Windows 8 - IIS 10.0 sous Windows 10
Serveur	- IIS 7.0 sur Windows Server 2008 - IIS 7.5 sur Windows Server 2008 R2 - IIS 8.0 sur Windows Server 2012 - IIS 8.5 sur Windows Server 2012 R2 - IIS 10.0 sous Windows Server 2016
Produit	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Fichier MOF	WebAdministration.mof

Voir aussi

Classe ConfigurationSection
Configurer l'exploration des répertoires

Partager via