Share via

New-UMVirtualDirectory (RTM)

  • Article

 

S’applique à : Exchange Server 2007

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

La cmdlet New-UMVirtualDirectory permet de créer un répertoire virtuel sur l'ordinateur exécutant Microsoft Exchange Server 2007 sur lequel le rôle serveur d'accès au client est installé.

Syntaxe

New-UMVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-BasicAuthentication <$true | $false>] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WindowsAuthentication <$true | $false>]

Description détaillée

La cmdlet New-UMVirtualDirectory permet de créer un répertoire virtuel de messagerie unifiée sur le serveur d'accès au client Exchange 2007. Vous pouvez créer un ou plusieurs répertoires virtuels de messagerie unifiée.

Pour exécuter la cmdlet New-UMVirtualDirectory, vous devez utiliser un compte auquel ont été délégués :

  • le rôle Administrateur de serveur Exchange et le 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 Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

ApplicationRoot

Facultatif

System.String

Ce paramètre permet de spécifier le chemin de site Web défini dans la métabase des services Internet (IIS). Par défaut, il est défini sur /W3SVC/1/ROOT, où 1= le site Web par défaut.

AppPoolId

Facultatif

System.String

Ce paramètre permet de spécifier le nom du pool d'applications IIS. Vous pouvez configurer ce paramètre dans <SERVERNAME>\Application Pools sur le site Web dans le Gestionnaire des services Internet (IIS). Par défaut, il est défini sur MSExchangeUMAppPool.

BasicAuthentication

Facultatif

System.Boolean

Ce paramètre permet de spécifier l'activation ou non de l'authentification de base sur le répertoire virtuel.

DigestAuthentication

Facultatif

System.Boolean

Ce paramètre permet de spécifier l'activation ou non de l'authentification Digest sur le répertoire virtuel.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ce changement de configuration dans le service d'annuaire Active Directory, incluez le paramètre DomainController dans la cmdlet.

ExternalUrl

Facultatif

System.Uri

Ce paramètre permet de spécifier le nom d'hôte utilisé pour se connecter au serveur Exchange depuis l'extérieur du réseau de périmètre.

InternalUrl

Facultatif

System.Uri

Ce paramètre permet de spécifier le nom d'hôte du serveur Exchange pour une connexion depuis l'intérieur du réseau de périmètre.

Path

Facultatif

System.String

Ce paramètre permet de spécifier le chemin local sur le serveur d'accès au client où se trouvent les fichiers UMWebservice. L'emplacement par défaut est %ExchangeInstallDir%\UnifiedMessaging\WebService.

TemplateInstance

Facultatif

System.Management.Automation.PSObject

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

WebSiteName

Facultatif

System.String

Ce paramètre permet de spécifier le nom du site Web sous lequel créer le répertoire virtuel. Il est déconseillé d'utiliser ce paramètre si vous créez un répertoire virtuel sous le site Web par défaut.

WindowsAuthentication

Facultatif

System.Boolean

Ce paramètre permet de spécifier l'activation ou non de l'authentification intégrée Windows sur le répertoire virtuel.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

 

Exceptions

Exceptions Description

 

 

Exemple

Cet exemple de code crée un répertoire virtuel de messagerie unifiée nommé MyUMWeb.

New-UMVirtualDirectory -MyUMWeb -WebsiteName "www.contoso.com" -ExternalUrl "https://www.contoso.com/UMwebservices.aspx"