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