New-UMVirtualDirectory
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2007-06-28
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>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]] [-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 2007 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 spécifie le chemin de site Web défini dans la métabase des services Internet (IIS). Par défaut, le chemin est défini sur /W3SVC/1/ROOT, où 1= le site Web par défaut. |
AppPoolId |
Facultatif |
System.String |
Ce paramètre spécifie 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, le nom du pool est défini sur MSExchangeUMAppPool. |
BasicAuthentication |
Facultatif |
System.Boolean |
Ce paramètre spécifie si l'authentification de base est activée sur le répertoire virtuel. |
DigestAuthentication |
Facultatif |
System.Boolean |
Ce paramètre spécifie si l'authentification Digest est activée sur le répertoire virtuel. |
Confirm |
Facultatif |
System.Management.Automation.SwitchParameter |
Ce paramètre suspend le traitement par la commande et demande à l'administrateur de confirmer les actions que la commande va effectuer avant de continuer le traitement. La valeur par défaut est $true. |
DomainController |
Facultatif |
Microsoft.Exchange.Data.Fqdn |
Ce paramètre spécifie le nom de domaine complet du contrôleur de domaine qui écrit ce changement de configuration dans le service d'annuaire Active Directory. |
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 réseau de périmètre. |
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 réseau de périmètre. |
Path |
Facultatif |
System.String |
Ce paramètre spécifie 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 |
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. |
WebSiteName |
Facultatif |
System.String |
Ce paramètre spécifie le nom du site Web dans 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 spécifie si l'authentification Windows intégrée est activée sur le répertoire virtuel. |
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, l'administrateur peut afficher les changements potentiels sans devoir les appliquer. La valeur par défaut est $true. |
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"