Remove-OwaVirtualDirectory

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2007-06-28

La cmdlet Remove-OwaVirtualDirectory supprime des répertoires virtuels Outlook Web Access d'un site Web des Services Internet (IIS) existant sur un ordinateur exécutant Microsoft Exchange Server 2007.

Syntaxe

Remove-OwaVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Pour exécuter la cmdlet Remove-OwaVirtualDirectory , vous devez spécifier le nom du répertoire virtuel Outlook Web Access que vous voulez supprimer.

Il se peut que vous deviez utiliser la cmdlet Remove-OwaVirtualDirectory dans les situations suivantes :

  • La cmdlet Get-OwaVirtualDirectory détecte un répertoire virtuel Outlook Web Access qui a été supprimé dans IIS mais pas dans le service d'annuaire Active Directory. Ces objets répertoire virtuel Outlook Web Access abandonnés sont appelées orphelins Active Directory. Il est recommandé de supprimer ce type de répertoire virtuel Outlook Web Access dans Active Directory à l'aide de la cmdlet Remove-OwaVirtualDirectory.

  • Vous pouvez supprimer tous les répertoires virtuels Outlook Web Access hérités de votre organisation Exchange 2007 native. Les répertoires virtuels Outlook Web Access hérités peuvent avoir été créés automatiquement durant l'installation d'Exchange 2007 ou manuellement dans un environnement Exchange mixte.

  • Vous dépannez un problème de configuration Outlook Web Access nécessitant la suppression du répertoire virtuel Outlook Web Access existant et la re-création du répertoire virtuel Outlook Web Access.

  • Si vous désinstallez le rôle serveur d'accès au client du serveur Exchange, tous les répertoires virtuels Outlook Web Access sur ce serveur Exchange sont également supprimés.

CautionAttention :
La cmdlet Remove-OwaVirtualDirectory supprime définitivement un ou plusieurs répertoires virtuels Outlook Web Access. Lorsque vous utilisez la cmdlet Remove-OwaVirtualDirectory, assurez-vous que vous n'avez pas supprimé accidentellement un répertoire virtuel Outlook Web Access par défaut. Il n'y a pas de valeur par défaut pour la cmdlet Remove-OwaVirtualDirectory.

Notes

La cmdlet Remove-OwaVirtualDirectory prend en charge l'indicateur Confirm.

La cmdlet Remove-OwaVirtualDirectory peut être exécutée sur tout serveur sur lequel les outils d'administration Exchange Server sont installés. 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

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter

Ce paramètre spécifie le nom ou le GUID d'un répertoire virtuel Outlook Web Access. Il se présente comme suit : ServerName\VirtualDirectoryName (WebsiteName).

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 d'Active Directory.

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

L'exemple de code suivant supprime un répertoire virtuel Outlook Web Access spécifié nommé « owa » situé sur le site Web IIS par défaut sur un serveur Exchange nommé « Contoso ».

Remove-OwaVirtualDirectory -identity "Contoso\owa (default web site)"