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

New-MapiVirtualDirectory

 

S’applique à :Exchange Server 2016

Dernière rubrique modifiée :2017-03-24

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

La cmdlet New-MapiVirtualDirectory permet de créer des répertoires virtuels MAPI (Messaging Application Programming Interface) qui sont utilisés dans Internet Information Services (IIS) sur des serveurs 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 à l’aide du protocole MAPIHTTP.

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

New-MapiVirtualDirectory [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-IISAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-Server <ServerIdParameter>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]]

Cet exemple crée un répertoire virtuel MAPI qui possède la configuration suivante :

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

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

New-MapiVirtualDirectory -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

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 qui seront activées sur le répertoire virtuel dans les services IIS. Les valeurs valides pour ce paramètre sont les suivantes :

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

Server

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Le paramètre Server spécifie le serveur Exchange qui héberge le répertoire virtuel. Vous pouvez utiliser n’importe quelle valeur qui identifie le serveur de façon unique. Par exemple :

  • Nom

  • FQDN

  • Nom unique (DN)

  • ExchangeLegacyDN

WebSiteName

Facultatif

System.String

Le paramètre WebSiteName spécifie le nom du site web IIS dans lequel le répertoire virtuel est créé. Vous n’avez pas besoin d’utiliser ce paramètre pour créer le répertoire virtuel dans le site web par défaut.

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: