Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Set-MapiVirtualDirectory

 

S’applique à :Exchange Server 2016

Dernière rubrique modifiée :2017-01-23

Cette cmdlet est disponible uniquement dans Exchange Server 2016 sur site.

Utilisez l’applet de commande Set-MapiVirtualDirectory pour modifier les répertoires virtuels de Messaging Application Programming Interface (MAPI) qui sont utilisés dans les Services Internet (IIS) (IIS) sur des serveurs de Microsoft Exchange. Un répertoire virtuel MAPI est utilisé par les versions prises en charge de MicrosoftOutlook pour se connecter aux boîtes aux lettres en utilisant le protocole MAPIHTTP.

Set-MapiVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-ApplyDefaults <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-IISAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]]

Cet exemple apporte les modifications de configuration suivantes dans le répertoire virtuel MAPI sur le site web par défaut du serveur nommé ContosoMail :

  • URL interne , https://contoso/mapi.

  • Méthodes d’authentification IIS   NTLM, Negotiate et OAuth.

Set-MapiVirtualDirectory -Identity "ContosoMail\mapi (Default Web Site)" -InternalUrl https://contoso.com/mapi -IISAuthenticationMethods NTLM,Negotiate,OAuth

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour voir les autorisations qui vous sont nécessaires, voir l’entrée « Paramètres de répertoire virtuel d’accès au client » dans la rubrique Autorisations des clients et des périphériques mobiles.

 

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter

Le paramètre Identity spécifie le répertoire virtuel MAPI que vous souhaitez configurer.

Vous pouvez utiliser n’importe quelle valeur qui identifie le répertoire virtuel de façon unique. Par exemple :

  • Nom ou <Server>\Name

  • Nom unique (DN)

  • GUID

La valeur Name utilise la syntaxe « <VirtualDirectoryName> (<WebsiteName>) » à partir des propriétés du répertoire virtuel. Vous pouvez insérer le caractère générique (*) à la place du site web par défaut en utilisant la syntaxe <VirtualDirectoryName>*.

ApplyDefaults

Facultatif

System.Boolean

Le commutateur ApplyDefaults spécifie si les valeurs par défaut correctes doivent être appliquées aux paramètres d’application IIS internes associés. En règle générale, ce commutateur est uniquement utilisé par la configuration Exchange lors de l’installation des Service Packs ou des mises à jour cumulatives Exchange. Vous ne devriez pas avoir à l’utiliser.

Ce commutateur n’a aucune incidence sur les valeurs que vous configurez à l’aide des paramètres IISAuthenticationMethods, InternalUrl ou ExternalUrl.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : dc01.contoso.com.

ExternalUrl

Facultatif

System.Uri

Le paramètre ExternalURL spécifie l’URL qui est utilisée pour se connecter au répertoire virtuel depuis l’extérieur du pare-feu.

Ce paramètre applique le protocole SSL (Secure Sockets Layer) et utilise le port SSL par défaut. Une entrée valide pour ce paramètre utilise la syntaxe https://<Domain Name>/mapi.

Lorsque vous utilisez les paramètres InternalUrl ou ExternalUrl, vous devez spécifier au moins une valeur d’authentification à l’aide du paramètre IISAuthenticationMethods.

IISAuthenticationMethods

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre IISAuthenticationMethods spécifie les méthodes d’authentification sont activées sur le répertoire virtuel dans Internet Information Services (IIS). Les valeurs valides sont :

  • Basic

  • Negotiate

  • NTLM

  • OAuth

Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Les valeurs par défaut sont NTLM, OAuthet Negotiate. Nous vous recommandons de toujours disposer du répertoire virtuel configuré pour OAuth.

InternalUrl

Facultatif

System.Uri

Le paramètre InternalURL spécifie l’URL utilisée pour se connecter au répertoire virtuel depuis l’intérieur du pare-feu.

Ce paramètre applique le protocole SSL (Secure Sockets Layer) et utilise le port SSL par défaut. Une entrée valide pour ce paramètre utilise la syntaxe https://<Domain Name>/mapi.

Lorsque vous utilisez les paramètres InternalUrl ou ExternalUrl, vous devez spécifier au moins une valeur d’authentification à l’aide du paramètre IISAuthenticationMethods.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: