Set-WebServicesVirtualDirectory (RTM)
S’applique à : Exchange Server 2007
Dernière rubrique modifiée : 2007-06-11
La cmdlet Set-WebServicesVirtualDirectory permet de modifier un répertoire virtuel des services Web Exchange existant sur un ordinateur Exchange 2007 sur lequel le rôle serveur d'accès au client est installé.
Syntaxe
Set-WebServicesVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Url>] [-InternalUrl <Url>] [-WindowsAuthentication <$true | $false>]
Description détaillée
La cmdlet Set-WebServicesVirtualDirectory permet de modifier un répertoire virtuel des services Web Exchange existant sur un serveur d’accès au client Exchange 2007.
Notes
Si vous disposez d’un ensemble de serveurs d'accès au client dont la charge est équilibrée, vous n’avez pas besoin de spécifier le nom de chaque serveur lorsque vous exécutez la cmdlet. Il suffit d’utiliser uniquement le nom de l’un des serveurs à charge de réseau équilibrée.
Pour exécuter la cmdlet Set-WebServicesVirtualDirectory, vous devez utiliser un compte auquel ont été délégués :
- le rôle Administrateur de serveur Exchange et le groupe Administrateurs local pour le serveur cible.
Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter |
Ce paramètre spécifie le nom du répertoire virtuel. Vous pouvez également spécifier un caractère générique à la place du site Web par défaut. |
BasicAuthentication |
Facultatif |
System.Boolean |
Ce paramètre spécifie si l'authentification de base est activée sur le répertoire virtuel des services Web Exchange. Ce paramètre peut être utilisé avec FormsAuthentication ou avec DigestAuthentication et WindowsAuthentication. |
DigestAuthentication |
Facultatif |
System.Boolean |
Ce paramètre spécifie si l'authentification Digest est activée sur le répertoire virtuel. |
DomainController |
Facultatif |
System.String |
Pour spécifier le nom de domaine complet du contrôleur de domaine qui extrait des données du service d'annuaire Active Directory, incluez le paramètre DomainController dans la cmdlet. |
ExternalUrl |
Facultatif |
System.Uri |
Ce paramètre spécifie le nom d'hôte utilisé pour se connecter au serveur Exchange depuis l'extérieur du pare-feu. Ce paramètre est également important lorsque le protocole SSL est utilisé. |
Instance |
Facultatif |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ADWebServicesVirtualDirectory |
Le paramètre Instance permet de transmettre un objet entier à la cmdlet à traiter. |
InternalUrl |
Facultatif |
System.Uri |
Ce paramètre spécifie le nom d'hôte du serveur Exchange pour une connexion depuis le pare-feu. Ce paramètre est également important lorsque le protocole SSL est utilisé. |
WindowsAuthentication |
Facultatif |
System.Boolean |
Ce paramètre spécifie si l'authentification intégrée Windows est autorisée sur le répertoire virtuel des services Web Exchange. |
Types d'entrées
Types de retours
Erreurs
| Erreur | Description |
|---|---|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
Exemple
L’exemple de code suivant définit la méthode d’authentification de base pour le répertoire virtuel appelé « EWS » du serveur « Contoso ». Cet exemple de code définit également les URL externes et internes pour ce répertoire virtuel.
Le deuxième exemple de code utilise un caractère générique au lieu de « site Web par défaut ».
Set-WebServicesVirtualDirectory -Identity Contoso\EWS(default web site)-ExternalUrl https://www.contoso.com/EWS/exchange.aspx -ExternalAuthenticationMethods Basic -InternalUrl https://contoso.internal.com/EWS/webservices.aspx
Set-WebServicesVirtualDirectory -Identity Contoso\EWS* -ExternalUrl https://www.contoso.com/ews/exchange.aspx