New-WebServicesVirtualDirectory
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2007-08-20
La cmdlet New-WebServicesVirtualDirectory permet de créer un répertoire virtuel nommé EWS sur l'ordinateur exécutant Microsoft Exchange Server 2007 sur lequel le rôle serveur d'accès au client est installé.
Syntaxe
New-WebServicesVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Description détaillée
La cmdlet New-WebServicesVirtualDirectory permet de créer un répertoire virtuel nommé EWS sur le serveur d'accès au client Exchange 2007. Cette cmdlet permet de créer plusieurs répertoires virtuels.
Notes
Vous ne pouvez créer qu'un seul répertoire virtuel EWS pour chaque site Web.
Pour exécuter la cmdlet New-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 Exchange 2007, consultez la rubrique Considérations relatives aux autorisations.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
ApplicationRoot |
Facultatif |
System.String |
Ce paramètre définit le chemin d'accès à la métabase du répertoire virtuel. Par défaut, ce chemin est identique à celui du site Web dans lequel le répertoire virtuel est créé. |
AppPoolId |
Facultatif |
System.String |
Ce paramètre définit le pool de programmes pouvant être utilisés avec le répertoire virtuel. |
BasicAuthentication |
Facultatif |
System.Boolean |
Ce paramètre spécifie si l'authentification de base est activée sur le répertoire virtuel EWS. |
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 |
Lorsqu'il est utilisé, ce paramètre spécifie l'utilisation de l'authentification Digest pour le répertoire virtuel. |
DomainController |
Facultatif |
Microsoft.Exchange.Data.Fqdn |
Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ce changement de configuration dans le 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 réseau de périmètre. |
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 tableau d’équilibrage de la charge réseau (NLB). Bien que le paramètre InternalUrl soit défini sur l’URL de l'équilibrage de la charge réseau , le paramètre InternalNLBBypassUrl doit toujours être défini sur l’URL du serveur d’accès au client. En effet, certains appels des services Web Exchange requièrent une affinité entre ordinateurs et les services Web Exchange transfèrent par proxy les appels entrants vers un serveur d’accès au client plus approprié, autant que possible. |
InternalUrl |
Facultatif |
System.Uri |
Ce paramètre spécifie l'URL utilisée pour se connecter au répertoire virtuel depuis l'intérieur du pare-feu réseau. |
Path |
Facultatif |
System.String |
Ce paramètre définit le chemin du répertoire virtuel dans la métabase. |
TemplateInstance |
Facultatif |
System.Management.Automation.PSObject |
Lorsqu'un objet existant est fourni pour ce paramètre, la commande utilise la configuration de l'objet pour créer une copie de l'objet sur un serveur local ou cible. |
WebSiteName |
Facultatif |
System.String |
Ce paramètre spécifie le nom du site Web dans lequel créer le répertoire virtuel. Il est déconseillé d'utiliser ce paramètre si vous créez un répertoire virtuel sous le site Web par défaut. |
WindowsAuthentication |
Facultatif |
System.Boolean |
Ce paramètre spécifie si l'authentification Windows intégrée est autorisée sur le nouveau répertoire virtuel des services Web Exchange. |
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. |
Types d'entrées
Types de retours
Erreurs
| Erreur | Description |
|---|---|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
Exemple
Cet exemple de code crée un répertoire virtuel nommé « contoso » dont l'URL externe est définie sur « https://www.contoso.com/webservices.aspx ».
New-WebServicesVirtualDirectory -WebsiteName "www.contoso.com" -ExternalUrl "https://www.contoso.com/webservices.aspx"