Classe1 VirtualDirectoryElementDefaults

Article
03/25/2024

Expose les paramètres de configuration par défaut pour les répertoires virtuels IIS.

Syntaxe

class VirtualDirectoryElementDefaults : EmbeddedObject

Méthodes

Cette classe ne contient pas de méthodes.

Propriétés

Le tableau suivant répertorie les propriétés exposées par la classe VirtualDirectoryElementDefaults.

Nom	Description
`AllowSubDirConfig`	Une valeur `boolean` en lecture/écriture. `true` si IIS recherche par défaut des fichiers Web.config dans les répertoires de contenu inférieurs au niveau actuel ; `false` si IIS ne recherche pas ces fichiers dans des répertoires inférieurs au niveau actuel.
`LogonMethod`	Énumération en lecture/écriture `sint32` qui spécifie la méthode par défaut par laquelle un utilisateur est connecté localement. Le type d’ouverture de session détermine si le jeton résultant peut également être utilisé à distance. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.
`Password`	Valeur de lecture/écriture `string` qui spécifie le mot de passe chiffré par défaut pour l’accès au répertoire racine virtuel. Par défaut, il s’agit de `null`.
`Path`	Valeur en lecture/écriture `string` qui contient le chemin d’accès au répertoire virtuel par défaut.
`PhysicalPath`	Valeur en lecture/écriture `string` qui spécifie le chemin d’accès physique par défaut associé au répertoire virtuel.
`UserName`	Valeur en lecture/écriture `string` qui spécifie un utilisateur par défaut qui a les droits d’accès aux fichiers de configuration ou au contenu d’un répertoire virtuel. Par défaut, il s’agit de `null`.

Sous-classes

Cette classe ne contient aucune sous-classe.

Notes

Les instances de cette classe sont contenues dans la propriété VirtualDirectoryDefaults des classes Serveur, Site et Application.

Le tableau suivant contient les valeurs et mots clés possibles pour la propriété LogonMethod. La valeur par défaut est 3 (ClearText). Pour plus d’informations, consultez la fonction LogonUserEx.

Valeur	Mot clé	Description
0	Interactive	Permet à l’utilisateur de se connecter de manière interactive via un serveur terminal, un interpréteur de commandes distant ou un processus similaire. Étant donné que ce type d’ouverture de session met en cache les informations d’ouverture de session pour les opérations déconnectées, les performances peuvent être affectées. Ce type d’ouverture de session est donc inapproprié pour les applications client/serveur, telles que les serveurs de messagerie.
1	Batch	Permet à l’utilisateur de se connecter via un serveur batch, où les processus peuvent être exécutés pour l’utilisateur sans intervention de l’utilisateur. Ce type d’ouverture de session convient aux serveurs, tels que la messagerie ou les serveurs web, qui traitent de nombreuses tentatives d’authentification en texte clair à la fois. Les informations d’identification ne sont pas mises en cache pour ce type de connexion.
2	Network (Réseau)	Permet à l’utilisateur de se connecter via un serveur hautes performances qui authentifie les mots de passe en texte clair. Les informations d’identification ne sont pas mises en cache pour ce type de connexion.
3	ClearText	Permet à l’utilisateur de se connecter à l’aide de l’authentification de base. Ce type de connexions conserve le nom et le mot de passe dans le package d’authentification, ce qui permet au serveur d’établir des connexions à d’autres serveurs réseau lors de l’emprunt d’identité du client. Un package d’authentification est une DLL qui encapsule la logique d’authentification qui détermine s’il faut autoriser un utilisateur à se connecter. LSA (Local Security Authority) authentifie une ouverture de session utilisateur en envoyant la demande à un package d’authentification. Le package d’authentification examine ensuite les informations d’ouverture de session et authentifie ou rejette la tentative d’ouverture de session de l’utilisateur.

Exemple

L’exemple suivant montre comment définir le nom d’utilisateur et le mot de passe pour tous les répertoires virtuels sur un site Web. Il montre ensuite comment récupérer tous les répertoires virtuels par défaut pour le site.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
  
' Set the virtual directory defaults on the Web site.  
oSite.VirtualDirectoryDefaults.UserName = "JohnV"  
oSite.VirtualDirectoryDefaults.Password = "p@ssw0rd."  
oSite.Put_  
  
' List all the virtual directory defaults for the Web site.  
WScript.Echo "AllowSubDirConfig: " & _  
    oSite.VirtualDirectoryDefaults.AllowSubDirConfig  
WScript.Echo "LogonMethod: " & _  
    GetLogonMethodText(oSite.VirtualDirectoryDefaults.LogonMethod)  
WScript.Echo "Password: " & oSite.VirtualDirectoryDefaults.Password  
WScript.Echo "Path: " & oSite.VirtualDirectoryDefaults.Path  
WScript.Echo "PhysicalPath: " & _  
    oSite.VirtualDirectoryDefaults.PhysicalPath  
WScript.Echo "UserName: " & oSite.VirtualDirectoryDefaults.UserName  
  
' This helper function converts the LogonMethod value to text.  
Function GetLogonMethodText(LogonMethodValue)  
    Select Case LogonMethodValue  
        Case 0  
            GetLogonMethodText = "Interactive"  
        Case 1  
            GetLogonMethodText = "Batch"  
        Case 2  
            GetLogonMethodText = "Network"  
        Case 3  
            GetLogonMethodText = "ClearText"  
        Case Else  
            GetLogonMethodText = "Unknown logon method."  
    End Select  
End Function

Hiérarchie d'héritage

EmbeddedObject

VirtualDirectoryElementDefaults

Spécifications

Type	Description
Client	- IIS 7.0 sur Windows Vista - IIS 7.5 sous Windows 7 - IIS 8.0 sous 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 Application
Classe EmbeddedObject
Classe Server
Classe de site
Classe VirtualDirectory
LogonUserEx

Partager via