Set-ImapSettings

Le paramètre AuthenticatedConnectionTimeout spécifie le délai d’attente avant la fermeture d’une connexion authentifiée inactive.

Pour spécifier une valeur, entrez-la sous forme d’une période : dd.hh:mm:ss où dd = jours, hh = heures, mm = minutes et ss = secondes.

Les valeurs valides sont comprises entre 00:00:30 et 1:00:00. Le paramètre par défaut est 00:30:00 (30 minutes).

Le paramètre Banner spécifie la chaîne de texte qui s’affiche pour connecter les clients IMAP4. La valeur par défaut est : The Microsoft Exchange IMAP4 service is ready.

Le paramètre CalendarItemRetrievalOption spécifie la façon dont les éléments de calendrier sont présentés aux clients IMAP4. Les valeurs valides sont les suivantes :

• 0 ou iCalendar. Il s’agit de la valeur par défaut.
• 1 ou IntranetUrl
• 2 ou InternetUrl
• 3 ou Personnalisé

Si vous spécifiez 3 ou Personnalisé, vous devez spécifier une valeur pour le paramètre OwaServerUrl.

Le commutateur Confirme 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 applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
• La plupart des autres applets de commande (par exemple, les applets de commande 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.

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

Le paramètre EnableExactRFC822Size spécifie la façon dont les tailles de message sont présentées aux clients IMAP4. Les valeurs valides sont les suivantes :

• $true : calculez la taille exacte du message. Étant donné que ce paramètre peut affecter négativement les performances, vous devez le configurer uniquement s’il est requis par vos clients IMAP4.
• $false : utilisez une taille de message estimée. Il s’agit de la valeur par défaut.

Le paramètre EnableGSSAPIAndNTLMAuth spécifie si les connexions peuvent utiliser NTLM (Integrated Authentification Windows) à l’aide de l’interface GSSAPI (Generic Security Services Application Programming Interface). Ce paramètre s’applique aux connexions où le protocole TLS (Transport Layer Security) est désactivé. Les valeurs valides sont les suivantes :

• $true : NTLM pour les connexions IMAP4 est activé. Il s’agit de la valeur par défaut.
• $false : NTLM pour les connexions IMAP4 est désactivé.

Le paramètre EnforceCertificateErrors spécifie s’il faut appliquer des échecs de validation de certificat SSL (Secure Sockets Layer) valides. Les valeurs valides sont les suivantes :

Le paramètre par défaut est $false.

• $true : si le certificat n’est pas valide ou ne correspond pas au nom de domaine complet du serveur IMAP4 cible, la tentative de connexion échoue.
• $false : le serveur ne refuse pas les connexions IMAP4 en fonction d’erreurs de certificat. Il s’agit de la valeur par défaut.

Le paramètre ExtendedProtectionPolicy spécifie comment la protection étendue pour l’authentification est utilisée. Les valeurs valides sont les suivantes :

• Aucun : la protection étendue pour l’authentification n’est pas utilisée. Il s’agit de la valeur par défaut.
• Autoriser : la protection étendue pour l’authentification est utilisée uniquement si elle est prise en charge par la connexion IMAP4 entrante. Si ce n’est pas le cas, la protection étendue pour l’authentification n’est pas utilisée.
• Exiger : une protection étendue pour l’authentification est requise pour toutes les connexions IMAP4. Si la connexion IMAP4 entrante ne la prend pas en charge, la connexion est rejetée.

La protection étendue pour l’authentification améliore la protection et la gestion des informations d’identification par le Authentification Windows intégré (également appelé NTLM). Nous vous recommandons donc vivement de l’utiliser si elle est prise en charge par vos clients (les installations par défaut de Windows 7 ou version ultérieure et windows Server 2008 R2 ou version ultérieure le prennent en charge).

Le paramètre ExternalConnectionSettings spécifie le nom d’hôte, le port et la méthode de chiffrement utilisés par les clients IMAP4 externes (connexions IMAP4 en dehors de votre réseau d’entreprise).

Ce paramètre utilise la syntaxe HostName:Port:[<TLS | SSL>]. La valeur de la méthode de chiffrement est facultative (vide indique les connexions non chiffrées).

La valeur par défaut est vide ($null), ce qui signifie qu’aucun paramètre de connexion IMAP4 externe n’est configuré.

Pour entrer plusieurs valeurs et remplacer les entrées existantes, utilisez la syntaxe suivante : Value1,Value2,...ValueN. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".

Pour ajouter ou supprimer une ou plusieurs valeurs sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

La combinaison des méthodes de chiffrement et des ports spécifiés pour ce paramètre doit correspondre aux méthodes de chiffrement et aux ports correspondants spécifiés par les paramètres SSLBindings et UnncryptedOrTLSBindings.

Le paramètre InternalConnectionSettings spécifie le nom d’hôte, le port et la méthode de chiffrement utilisés par les clients IMAP4 internes (connexions IMAP4 à partir de votre réseau d’entreprise). Ce paramètre est également utilisé lorsqu’une connexion IMAP4 est transférée à un autre serveur Exchange qui exécute le service Exchange IMAP4 Microsoft.

Ce paramètre utilise la syntaxe HostName:Port:[<TLS | SSL>]. La valeur de la méthode de chiffrement est facultative (vide indique les connexions non chiffrées).

La valeur par défaut est <ServerFQDN>:993:SSL,<ServerFQDN>:143:TLS.

Pour entrer plusieurs valeurs et remplacer les entrées existantes, utilisez la syntaxe suivante : Value1,Value2,...ValueN. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".

Pour ajouter ou supprimer une ou plusieurs valeurs sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

La combinaison des méthodes de chiffrement et des ports spécifiés pour ce paramètre doit correspondre aux méthodes de chiffrement et aux ports correspondants spécifiés par les paramètres SSLBindings et UnncryptedOrTLSBindings.

Le paramètre LogFileLocation spécifie l’emplacement des fichiers journaux du protocole IMAP4. L’emplacement par défaut est %ExchangeInstallPath%Logging\Imap4.

Ce paramètre n’est significatif que lorsque la valeur du paramètre ProtocolLogEnabled est $true.

Le paramètre LogFileRollOverSettings définit la fréquence à laquelle l'enregistrement dans le journal IMAP4 crée un nouveau fichier journal. Les valeurs valides sont les suivantes :

• 1 ou Hourly. Il s’agit de la valeur par défaut dans Exchange 2019 et Exchange 2016.
• 2 ou Daily. Il s’agit de la valeur par défaut dans Exchange 2013 et Exchange 2010.
• 3 ou Weekly.
• 4 ou Monthly.

Ce paramètre n’est significatif que lorsque la valeur du paramètre LogPerFileSizeQuota est 0 et que la valeur du paramètre ProtocolLogEnabled est $true.

Le paramètre LoginType spécifie la méthode d’authentification pour les connexions IMAP4. Les valeurs valides sont les suivantes :

• 1 ou PlainTextLogin.
• 2 ou PlainTextAuthentication.
• 3 ou SecureLogin. Il s’agit de la valeur par défaut.

Le paramètre LogPerFileSizeQuota spécifie la taille maximale d’un fichier journal du protocole IMAP4.

Une valeur valide est un nombre allant jusqu’à 1,999999999 téraoctets (2199023254528 octets) ou la valeur unlimited. La valeur par défaut est de 6 gigaoctets (6442450944 octets).

• B (octets)
• KB (kilo-octets)
• MB (mégaoctets)
• GB (gigaoctets)
• To (téraoctets)

TB (téraoctets)

La valeur par défaut est 0, ce qui signifie qu’un nouveau fichier journal du protocole IMAP4 est créé à la fréquence spécifiée par le paramètre LogFileRollOverSettings.

Ce paramètre n’est significatif que lorsque la valeur du paramètre ProtocolLogEnabled est $true.

Le paramètre MaxCommandSize spécifie la taille maximale en octets d’une seule commande IMAP4. Les valeurs valides sont comprises entre 1024 et 16384. La valeur par défaut est 10240.

Le paramètre MaxConnectionFromSingleIP spécifie le nombre maximal de connexions IMAP4 acceptées par le serveur Exchange à partir d’une seule adresse IP. Les valeurs valides sont comprises entre 1 et 2 147 483 647. La valeur par défaut est 2147483647.

Le paramètre MaxConnections spécifie le nombre maximal de connexions IMAP4 acceptées par le serveur Exchange. Les valeurs valides sont comprises entre 1 et 2 147 483 647. La valeur par défaut est 2147483647.

Le paramètre MaxConnectionsPerUser spécifie le nombre maximal de connexions IMAP4 autorisées pour chaque utilisateur. Les valeurs valides sont comprises entre 1 et 2 147 483 647. La valeur par défaut est 16.

Le paramètre MessageRetrievalMimeFormat spécifie le codage MIME des messages. Les valeurs valides sont les suivantes :

• 0 ou TextOnly.
• 1 ou HtmlOnly.
• 2 ou HtmlAndTextAlternative.
• 3 ou TextEnrichedOnly.
• 4 ou TextEnrichedAndTextAlternative.
• 5 ou BestBodyFormat. Il s’agit de la valeur par défaut.
• 6 ou Tnef.

Le paramètre OwaServerUrl spécifie l’URL utilisée pour récupérer les informations de calendrier pour les instances d’éléments de calendrier Outlook sur le web personnalisés.

Le paramètre PreAuthenticatedConnectionTimeout spécifie le délai d’attente avant de fermer une connexion IMAP4 inactive qui n’est pas authentifiée.

Pour spécifier une valeur, entrez-la sous forme d’une période : dd.hh:mm:ss où dd = jours, hh = heures, mm = minutes et ss = secondes.

Les valeurs valides sont 00:00:30 à 1:00:00. La valeur par défaut est 00:01:00 (une minute).

Le paramètre ProtocolLogEnabled spécifie s’il faut activer la journalisation du protocole pour IMAP4. Les valeurs valides sont les suivantes :

• $true : la journalisation du protocole IMAP4 est activée.
• $false : la journalisation du protocole IMAP4 est désactivée. Il s’agit de la valeur par défaut.

Le paramètre ProxyTargetPort spécifie le port sur le Microsoft service principal Exchange IMAP4 qui écoute les connexions clientes qui sont proxiées à partir du Microsoft service Exchange IMAP4. La valeur par défaut est 1993.

Le paramètre Server définit le serveur Exchange sur lequel vous souhaitez exécuter cette commande. Vous pouvez utiliser n’importe quelle valeur qui identifie uniquement le serveur. Par exemple :

• Nom
• FQDN
• Nom unique
• DN Exchange hérité

DN Exchange hérité

Le paramètre ShowHiddenFoldersEnabled spécifie si les dossiers de boîtes aux lettres masqués sont visibles. Les valeurs valides sont les suivantes :

• $true : les dossiers masqués sont visibles.
• $false : les dossiers masqués ne sont pas visibles. Il s’agit de la valeur par défaut.

Le paramètre SSLBindings spécifie l’adresse IP et le port TCP utilisés pour la connexion IMAP4 qui est toujours chiffrée par SSL/TLS. Ce paramètre utilise la syntaxe IPv4OrIPv6Address:Port.

La valeur par défaut est [::]:993,0.0.0.0:993.

Pour entrer plusieurs valeurs et remplacer les entrées existantes, utilisez la syntaxe suivante : Value1,Value2,...ValueN. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".

Pour ajouter ou supprimer une ou plusieurs valeurs sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Le paramètre SuppressReadReceipt spécifie s’il faut arrêter l’envoi des confirmations de lecture en double aux clients IMAP4 dont le paramètre Envoyer des confirmations de lecture pour les messages que j’envoie est configuré dans leur programme de messagerie IMAP4. Les valeurs valides sont les suivantes :

• $true : l’expéditeur reçoit une confirmation de lecture uniquement lorsque le destinataire ouvre le message.
• $false : l’expéditeur reçoit une confirmation de lecture lorsque le destinataire télécharge le message et quand il ouvre le message. Il s’agit de la valeur par défaut.

Le paramètre UnncryptedOrTLSBindings spécifie l’adresse IP et le port TCP utilisés pour les connexions IMAP4 non chiffrées, ou les connexions IMAP4 chiffrées à l’aide du protocole TLS opportuniste (STARTTLS) après l’établissement initial d’une liaison de protocole non chiffré. Ce paramètre utilise la syntaxe IPv4OrIPv6Address:Port.

La valeur par défaut est [::]:143,0.0.0.0:143.

Pour entrer plusieurs valeurs et remplacer les entrées existantes, utilisez la syntaxe suivante : Value1,Value2,...ValueN. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".

Pour ajouter ou supprimer une ou plusieurs valeurs sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

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.

Le paramètre X509CertificateName spécifie le certificat utilisé pour chiffrer les connexions clientes IMAP4.

Une valeur valide pour ce paramètre est le nom de domaine complet des paramètres ExternalConnectionSettings ou InternalConnectionSettings (par exemple, mail.contoso.com ou mailbox01.contoso.com).

Si vous utilisez un certificat d’objet unique ou un certificat SAN (Subject Alternative Name), vous devez également affecter le certificat au service IMAP Exchange à l’aide de l’applet de commande Enable-ExchangeCertificate.

Si vous utilisez un certificat générique, vous n’avez pas besoin d’affecter le certificat au service IMAP Exchange.