New-OwaVirtualDirectory (RTM)
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"