Partager via

New-OwaVirtualDirectory (RTM)

  • Article

 

S’applique à : Exchange Server 2007

Dernière rubrique modifiée : 2007-11-15

La cmdlet New-OWAVirtualDirectory crée un répertoire virtuel Outlook Web Access dans un site Web des Services Internet (IIS) existant sur un ordinateur exécutant Microsoft Exchange Server 2007.

Syntaxe

New-OwaVirtualDirectory [-Name <String>] [-ApplicationRoot <String>] [-AppPoolId <String>] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-OwaVersion <Exchange2003or2000 | Exchange2007>] [-Path <String>] [-TemplateInstance <PSObject>] [-VirtualDirectoryType <NotSpecified | Mailboxes | PublicFolders | Exchweb | Exadmin>] [-WebSiteName <String>]

Description détaillée

Par défaut, lors de l'installation d'Exchange 2007, les répertoires virtuels Outlook Web Access suivants sont créés dans le site Web IIS par défaut sur le serveur Exchange local :

  • Owa   Répertoire virtuel Exchange 2007 Outlook Web Access.

  • Exchange   Répertoire virtuel Outlook Web Access hérité accessible aux utilisateurs ayant des boîtes aux lettres sur des serveurs Exchange Server 2003 ou Exchange 2000 Server.

  • Public   Répertoire virtuel Outlook Web Access hérité pointant sur les dossiers publics de serveurs Exchange Server 2003 ou Exchange 2000 Server.

  • Exchweb   Répertorie virtuel Outlook Web Access hérité qui permet aux utilisateurs d'accéder aux répertoires virtuels Outlook Web Access. Par défaut, les demandes adressées au répertoire virtuel « exchweb » sont envoyées au serveur de boîtes aux lettres de l'utilisateur.

    Notes

    Généralement, vous utilisez la cmdlet New-OWAVirtualDirectory si vous avez des besoins professionnels spécifiques nécessitant des répertoires virtuels supplémentaires, tels que l'hébergement ou, pour des tâches de dépannage d'Outlook Web Access telles que la suppression et la recréation d'un répertoire virtuel Outlook Web Access.

La cmdlet New-OwaVirtualDirectory doit être exécutée sur le serveur Exchange 2007 hébergeant le rôle serveur d'accès au client sur lequel vous voulez héberger le nouveau répertoire virtuel. Pour exécuter la cmdlet New-OwaVirtualDirectory, 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 du répertoire virtuel dans la métabase.

> [!Note] > Ce paramètre n'a pas été implémenté.

AppPoolId

Facultatif

System.String

Ce paramètre définit le pool d'applications IIS dans lequel Outlook Web Access s'exécutera. Il est préférable de conserver sa valeur par défaut.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui extrait des données du service d'annuaire Active Directory, incluez le paramètre DomainController dans la commande.

ExternalAuthenticationMethods

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ExternalAuthenticationMethods, paramètre de propriété de Services Discovery, spécifie les méthodes d'authentification prises en charge sur le serveur Exchange depuis l'extérieur du pare-feu.

> [!Note] > Ce paramètre n'a pas été implémenté mais peut être défini de la manière décrite dans la rubrique Set-OwaVirtualDirectory (RTM).

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

> [!Note] > Vous pouvez configurer ce paramètre uniquement sur des répertoires virtuels Exchange 2007. Le répertoire virtuel Exchange 2007 par défaut est /owa.

InternalUrl

Facultatif

System.Uri

Ce paramètre spécifie le nom d'hôte du serveur Exchange pour une connexion depuis l'intérieur du pare-feu. Ce paramètre est également important lorsque le protocole SSL est utilisé.

> [!Note] > Vous pouvez configurer ce paramètre uniquement sur des répertoires virtuels Exchange 2007. Le répertoire virtuel Exchange 2007 par défaut est /owa.

Name

Facultatif

System.String

Ce paramètre spécifie le nom d'un répertoire virtuel Outlook Web Access si le répertoire virtuel Outlook Web Access figure sur un serveur exécutant Exchange Server 2003 ou Exchange 2000 Server.

Si le répertoire virtuel Outlook Web Access est sur un serveur Exchange 2007, ce paramètre est ignoré.

OWAVersion

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.OwaVersions

Ce paramètre spécifie si la version du répertoire virtuel Outlook Web Access est Exchange 2007, Exchange 2003 ou Exchange 2000.

Path

Facultatif

System.String

Ce paramètre définit le chemin du système de fichiers du répertoire virtuel. Il convient d'utiliser ce paramètre avec prudence et uniquement s'il est nécessaire d'utiliser un chemin de système de fichiers autre que le chemin par défaut.

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 identique de l'objet sur un serveur local ou cible.

> [!Note] > Ce paramètre n'a pas été implémenté.

VirtualDirectoryType

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.VirtualDirectoryTypes

Ce paramètre spécifie si le répertoire virtuel Outlook Web Access pointe sur les boîtes aux lettres, les dossiers publics ou exchweb. Ce paramètre est requis si le répertoire virtuel Outlook Web Access est sur un serveur Exchange 2003 ou Exchange 2000.

Si le répertoire virtuel Outlook Web Access est sur un serveur Exchange 2007, ce paramètre est ignoré.

WebSiteName

Facultatif

System.String

Ce paramètre spécifie le nom du site Web IIS dans lequel le répertoire virtuel Outlook Web Access est créé.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

 

Exceptions

Exceptions Description

 

 

Exemple

Les exemples de code suivants créent un ensemble de répertoires virtuels hérités Outlook Web Access nommés « exchange », « public » et « exchweb » dans un site Web IIS autre que par défaut nommé « contoso.com » sur le serveur Exchange local.

New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType Mailboxes -Name "exchange" -WebSiteName "Contoso.com"
New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType PublicFolders -Name "public" -WebSiteName "Contoso.com"
New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType Exchweb -Name "exchweb" -WebSiteName "Contoso.com"