Set-UMVirtualDirectory (RTM)
S’applique à : Exchange Server 2007
Dernière rubrique modifiée : 2008-05-14
La cmdlet Set-UMVirtualDirectory permet de modifier un répertoire virtuel de messagerie unifiée Exchange existant sur un ordinateur Exchange 2007 sur lequel le rôle serveur d'accès au client est installé.
Syntaxe
Set-UMVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-WindowsAuthentication <$true | $false>]
Set-UMVirtualDirectory [-BasicAuthentication <$true | $false>] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-Instance <ADUMVirtualDirectory>] [-InternalUrl <Uri>] [-WindowsAuthentication <$true | $false>]
Description détaillée
La cmdlet Set-UMVirtualDirectory permet de modifier un répertoire virtuel d’Exchange Web Services sur un serveur d’accès au client Exchange 2007.
Pour exécuter la cmdlet Set-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 |
|---|---|---|---|
Identity |
Obligatoire |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter |
Ce paramètre permet de spécifier le nom du répertoire virtuel. Vous pouvez également spécifier un caractère générique à la place du site Web par défaut. |
BasicAuthentication |
Facultatif |
System.Boolean |
Ce paramètre permet de spécifies si l'authentification de base est activée sur le répertoire virtuel des services Web Exchange. Ce paramètre peut être utilisé avec FormsAuthentication ou avec DigestAuthentication et WindowsAuthentication. |
DigestAuthentication |
Facultatif |
System.Boolean |
Ce paramètre permet de spécifier si l'authentification Digest est activée sur le répertoire virtuel. |
DomainController |
Facultatif |
Microsoft.Exchange.Data.Fqdn |
Ce paramètre permet de spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui extrait des données du 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 d'accès au client depuis l'extérieur du pare-feu. Ce paramètre est également important lorsque le protocole SSL est utilisé. |
Instance |
Facultatif |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ADUMVirtualDirectory |
Ce paramètre permet de transmettre un objet entier à la cmdlet en vue de son traitement. Il est principalement utilisé dans des scripts où un objet entier doit être transmis à la cmdlet. |
InternalUrl |
Facultatif |
System.Uri |
Ce paramètre permet de spécifier le nom d'hôte du serveur d'accès au client pour des connexions depuis l'intérieur du pare-feu. Ce paramètre est également important lorsque le protocole SSL est utilisé. |
WindowsAuthentication |
Facultatif |
System.Boolean |
Ce paramètre permet de spécifier si l'authentification Windows intégrée est autorisée sur le répertoire virtuel de messagerie unifiée. |
Types d'entrées
Types de retours
Erreurs
| Erreur | Description |
|---|---|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
Exemple
Le premier exemple de code définit la méthode d’authentification Digest pour le répertoire virtuel nommé UnifiedMessaging sur le serveur nommé UMserver1. Cet exemple de code définit également les URL externes et internes pour ce répertoire virtuel.
Le deuxième exemple de code utilise un caractère générique au lieu de « site Web par défaut ».
Set-UMVirtualDirectory -Identity UMServer1\UnifiedMessaging -ExternalUrl https://www.contoso.com/UnifiedMessaging/service.asmx -ExternalAuthenticationMethods Digest -InternalUrl https://contoso.internal.com/UnifiedMessaging/service.asmx
Set-UMVirtualDirectory -Identity UMServer1\UnifiedMessaging* -ExternalUrl https://www.contoso.com/UnifiedMessaging/service.asmx