Get-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 Get-OwaVirtualDirectory permet d'extraire tous les répertoires virtuels Outlook Web Access d'un ordinateur exécutant Microsoft Exchange Server 2007 sur lequel le rôle serveur d'accès au client est installé.

Syntaxe

Get-OwaVirtualDirectory [-Identity <VirtualDirectoryIdParameter>] [-DomainController <Fqdn>]

Get-OwaVirtualDirectory -Server <ServerIdParameter> [-DomainController <Fqdn>]

Description détaillée

La cmdlet Get-OwaVirtualDirectory permet d'extraire et d'afficher les paramètres de configuration actuellement définis pour les répertoires virtuels Outlook Web Access dans Exchange 2007. La cmdlet Get-OwaVirtualDirectory peut également extraire et afficher les paramètres de configuration pour un répertoire virtuel Outlook Web Access spécifique.

La cmdlet Get-OwaVirtualDirectory peut être exécutée sur un serveur local ou à distance si le nom de serveur est spécifié dans les paramètres Identity ou Server. Il est également possible de l'exécuter sans paramètre pour extraire les paramètres de configuration de tous les répertoires virtuels Outlook Web Access de tous les services Internet IIS situés sur les serveurs d'accès au client de l'organisation.

La cmdlet Get-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 le rôle Administrateur Affichage seul d'Exchange a été délégué.

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

Server

Obligatoire

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Ce paramètre spécifie le nom ou le GUID du serveur hébergeant les répertoires virtuels Outlook Web Access que vous voulez afficher. Il est obligatoire si vous n'exécutez pas Get-OwaVirtualDirectory sur un serveur sur lequel le rôle serveur d'accès au client est installé.

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.

Identity

Facultatif

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

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

 

Exceptions

Exceptions Description

 

 

Exemple

Le premier exemple de code montre comment utiliser le paramètre Server pour extraire tous les répertoires virtuels Outlook Web Access sur un serveur nommé « Contoso ».

Le deuxième exemple de code montre comment utiliser le paramètre Identity pour extraire les paramètres de configuration d'un répertoire virtuel Outlook Web Access nommé « owa (site Web par défaut) » sur le serveur nommé « Contoso ».

Get-OwaVirtualDirectory -Server Contoso
Get-OwaVirtualDirectory -Identity "Contoso\owa (default web site)"