New-OwaVirtualDirectory
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2010-02-25
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>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-OwaVersion <Exchange2003or2000 | Exchange2007>] [-Path <String>] [-TemplateInstance <PSObject>] [-VirtualDirectoryType <NotSpecified | Mailboxes | PublicFolders | Exchweb | Exadmin>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Par défaut, lors de l'installation d'Exchange 2007, les répertoires virtuels d'Outlook Web Access suivants sont créés dans le site Web IIS par défaut sur le serveur local qui exécute Microsoft Exchange :
Owa Répertoire virtuel Exchange 2007 Outlook Web Access.
Exchange Répertoire virtuel d'Outlook Web Access hérité, accessible aux utilisateurs ayant des boîtes aux lettres sur des serveurs exécutant Exchange Server 2003 ou Exchange 2000 Server.
Public Répertoire virtuel Outlook Web Access hérité pointant sur les dossiers publics sur des serveurs exécutant Exchange 2003 ou Exchange 2000.
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. Vous devez utiliser un compte auquel ont été délégués le rôle Administrateur 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. |
Confirm |
Facultatif |
System.Management.Automation.SwitchParameter |
Ce paramètre suspend le traitement par la commande et vous demande de confirmer les actions que la commande va effectuer avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm. |
DomainController |
Facultatif |
Microsoft.Exchange.Data.Fqdn |
Ce paramètre spécifie le nom de domaine complet (FQDN) du contrôleur de domaine qui extrait des données du service d'annuaire Active Directory. |
ExternalAuthenticationMethods |
Facultatif |
Microsoft.Exchange.Data.MultiValuedProperty |
Ce paramètre, 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. |
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 d'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 d'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 2003 ou Exchange 2000. 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 |
Ce paramètre spécifie que la cmdlet utilise la configuration d'un objet existant, lorsque cet objet est fourni au paramètre, 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éé. |
WhatIf |
Facultatif |
System.Management.Automation.SwitchParameter |
Ce paramètre 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
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 celui 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"