Set-UMVirtualDirectory
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2008-11-10
La cmdlet Set-UMVirtualDirectory permet de modifier un répertoire virtuel de messagerie unifiée Exchange existant sur un ordinateur sur lequel le rôle serveur d'accès au client est installé.
Syntaxe
Set-UMVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Set-UMVirtualDirectory [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-Instance <ADUMVirtualDirectory>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-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 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 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 spécifie si l'authentification de base est activée sur le répertoire virtuel des services Web Exchange. Ce paramètre peut être utilisé avec le paramètre FormsAuthentication ou avec les paramètres DigestAuthentication et WindowsAuthentication. |
Confirm |
Facultatif |
System.Management.Automation.SwitchParameter |
Ce paramètre suspend le traitement effectué par la commande. L'administrateur doit confirmer les actions de la commande avant de pouvoir continuer le traitement. La valeur par défaut est |
DigestAuthentication |
Facultatif |
System.Boolean |
Ce paramètre spécifie si l'authentification Digest est activée sur le répertoire virtuel. |
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. Incluez le paramètre DomainController dans la cmdlet. |
ExternalUrl |
Facultatif |
System.Uri |
Ce paramètre spécifie 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 spécifie de transmettre ou non un objet entier à la cmdlet à traiter. Il est principalement utilisé dans des scripts où un objet entier doit être transmis à la cmdlet. |
InternalUrl |
Facultatif |
System.Uri |
Ce paramètre spécifie 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 important lorsque le protocole SSL est utilisé. |
WindowsAuthentication |
Facultatif |
System.Boolean |
Ce paramètre spécifie si l'authentification Windows intégrée est autorisée sur le répertoire virtuel de messagerie unifiée. |
WhatIf |
Facultatif |
System.Management.Automation.SwitchParameter |
Ce paramètre donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Un administrateur peut utiliser le paramètre WhatIf pour afficher les changements potentiels sans devoir les appliquer. La valeur par défaut est |
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 de messagerie unifiée 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