Partager via


Set-WebServicesVirtualDirectory

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2011-06-21

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>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]

Set-WebServicesVirtualDirectory [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-Instance <ADWebServicesVirtualDirectory>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-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 l'appartenance au 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.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.

DigestAuthentication

Facultatif

System.Boolean

Ce paramètre spécifie si l'authentification Digest est activée sur le répertoire virtuel.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

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.

InternalNLBBypassUrl

Facultatif

System.Uri

Ce paramètre spécifie l'adresse URL du serveur d'accès au client même si ce dernier se trouve derrière un équilibreur de charge réseau (NLB).

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é.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf.

WindowsAuthentication

Facultatif

System.Boolean

Ce paramètre spécifie si l'authentification Windows intégrée 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 « default Web site ».

Set-WebServicesVirtualDirectory -Identity Contoso\EWS(default web site)-ExternalUrl https://www.contoso.com/EWS/exchange.asmx - BasicAuthentication $true InternalUrl https://contoso.internal.com/EWS/webservices.aspx
Set-WebServicesVirtualDirectory -Identity Contoso\EWS* -ExternalUrl https://www.contoso.com/ews/exchange.asmx