Set-IMAPSettings

  • Article

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2009-05-15

La cmdlet Set-IMAPSettings permet de définir des paramètres IMAP4 (Internet Message Access Protocol version 4rev1) spécifiques pour le serveur Microsoft Exchange Server 2007 sur lequel le rôle serveur d'accès au client est installé et qui exécute le service IMAP4.

Syntaxe

Set-ImapSettings [-AuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-Banner <String>] [-CalendarItemRetrievalOption <iCalendar | intranetUrl | InternetUrl | Custom>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-EnableExactRFC822Size <$true | $false>] [-Instance <Imap4AdConfiguration>] [-LoginType <PlainTextLogin | PlainTextAuthentication | SecureLogin>] [-MaxCommandSize <Int32>] [-MaxConnectionFromSingleIP <Int32>] [-MaxConnections <Int32>] [-MaxConnectionsPerUser <Int32>] [-MessageRetrievalMimeFormat <TextOnly | HtmlOnly | HtmlAndTextAlternative | TextEnrichedOnly | TextEnrichedAndTextAlternative | BestBodyFormat | Tnef>] [-OwaServerUrl <String>] [-PreAuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-ProxyTargetPort <Int32>] [-Server <ServerIdParameter>] [-ShowHiddenFoldersEnabled <$true | $false>] [-SSLBindings <MultiValuedProperty>] [-UnencryptedOrTLSBindings <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-X509CertificateName <String>]

Description détaillée

La cmdlet Set-IMAPSettings permet de définir des paramètres IMAP4 spécifiques pour le serveur d’accès au client Exchange 2007 qui exécute le service IMAP4. Vous pouvez exécuter cette cmdlet pour un seul serveur d'accès au client exécutant le service IMAP4 ou pour tous les serveurs d'accès au client Exchange 2007 sur lesquels le service IMAP4 est installé.

Pour exécuter la cmdlet Set-IMAPSettings, 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

AuthenticatedConnectionTimeout

Facultatif

Microsoft.Exchange.Data.EnhancedTimeSpan

Ce paramètre spécifie le délai d'attente avant la fermeture d'une connexion authentifiée inactive. Le paramètre par défaut est 1800 secondes. Les valeurs possibles vont de 30 à 86 400 secondes.

Banner

Facultatif

System.String

Ce paramètre spécifie la chaîne de bannière affichée une fois que la connexion à un serveur d'accès au client a été établie.

CalendarItemRetrievalOption

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.CalendarItemRetrievalOptions

Ce paramètre spécifie le type d'élément de calendrier renvoyé lorsque vous accédez au calendrier à l'aide d'IMAP4. Les valeurs suivantes sont disponibles :

  • 0 : Calendar

  • 1 : IntranetUrl

  • 2 : InternetUrl

  • 3 : Custom

Si vous utilisez la valeur 3 : Custom, vous devez spécifier le paramètre OWAServerUrl.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour 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 commande.

EnableExactRFC822Size

Facultatif

System.Boolean

Le paramètre EnableExactRFC822Size renvoie la valeur RFC822.SIZE correcte de chaque message électronique dans une boîte aux lettres.

Par défaut, Exchange 2007 estime la valeur RFC822.SIZE car Exchange 2007 doit recréer le MIME pour déterminer la taille exacte. La reconstruction du MIME peut affecter les performances si la boîte aux lettres contient des messages volumineux ou des messages incluant des pièces jointes fortement imbriquées. Certains clients de messagerie électronique peuvent toutefois exiger que la valeur RFC822.SIZE soit la valeur exacte, et non une estimation.

Pour activer la taille exacte pour tous les utilisateurs, utilisez la commande suivante :

Set-ImapSettings -EnableExactRFC822Size:$true

Pour activer la taille exacte pour un utilisateur spécifique, utilisez la commande suivante :

Set-CASMailbox <Nom_utilisateur_IMAP> -ImapUseProtocolDefaults:$false -ImapEnableExactRFC822Size:$true

Instance

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.Imap4AdConfiguration

Le paramètre Instance spécifie une instance d'un objet Active Directory canalisée vers cette commande et utilisée par elle.

LoginType

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.LoginOptions

Ce paramètre spécifie le paramètre d'authentification utilisé pour le serveur d'accès au client exécutant le service IMAP4. Les valeurs possibles sont les suivantes :

  • 1 : PlainTextLogin

  • 2 : PlainTextAuthentication

  • 3 : SecureLogin

MaxCommandSize

Facultatif

System.Int32

Ce paramètre spécifie la taille maximale d'une commande. La taille par défaut est 10240 octets. Les valeurs possibles vont de 1024 à 16384 octets.

MaxConnectionFromSingleIP

Facultatif

System.Int32

Ce paramètre spécifie le nombre de connexions que le serveur spécifié accepte d'une adresse IP particulière. La valeur par défaut est 20. Les valeurs possibles vont de 1 à 1000.

MaxConnections

Facultatif

System.Int32

Ce paramètre spécifie le nombre total de connexions que le serveur spécifié accepte. Celles-ci incluent les connexions authentifiées et non authentifiées. La taille par défaut est 2 000 connexions. Les valeurs possibles vont de 1 à 25 000 octets.

MaxConnectionsPerUser

Facultatif

System.Int32

Ce paramètre spécifie le nombre maximal de connexions que le serveur d'accès au client accepte d'un utilisateur particulier. La valeur par défaut est 10. Les valeurs possibles vont de 1 à 1000.

MessageRetrievalMimeFormat

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat

Ce paramètre spécifie le format des messages extraits du serveur. Les valeurs possibles sont les suivantes :

  • 0 : Text Only

  • 1 : HTML Only

  • 2 : HTML and Text

  • 3 : Rich Text Only

  • 4 : Best Body Format

OwaServerUrl

Facultatif

System.String

Ce paramètre spécifie le serveur d’accès au client à partir duquel récupérer des informations de calendrier pour les instances d'éléments de calendrier Outlook Web Access personnalisés.

PreAuthenticatedConnectionTimeout

Facultatif

Microsoft.Exchange.Data.EnhancedTimeSpan

Ce paramètre spécifie le délai d'attente avant la fermeture d'une connexion inactive non authentifiée. Le paramètre par défaut est 60 secondes. Les valeurs possibles vont de 10 à 3600 secondes.

ProxyTargetPort

Facultatif

System.Int32

Ce paramètre spécifie le port du serveur principal Exchange Server 2003 auquel le service IMAP4 d’un serveur d’accès au client relaiera les commandes.

Server

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Ce paramètre spécifie un serveur d'accès au client individuel de votre organisation pour lequel vous spécifiez des paramètres IMAP.

ShowHiddenFoldersEnabled

Facultatif

System.Boolean

Si ce paramètre est spécifié, les dossiers masqués seront visibles. La valeur par défaut est $false.

SSLBindings

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Si ce paramètre est spécifié, la cmdlet renvoie le port IP à utiliser pour la communication d'une session SSL (Secure Sockets Layer).

UnencryptedOrTLSBindings

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre spécifie le port IP pour la communication via une connexion avec chiffrement TLS (Transport Layer Security) ou une connexion non chiffrée.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf.

X509CertificateName

Facultatif

System.String

Ce paramètre spécifie le nom d’hôte dans le certificat SSL à partir du champ Sujet associé.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

 

Exceptions

Exceptions Description

 

 

Exemple

L'exemple de code suivant définit l'adresse IP pour TLS du serveur d'accès au client nommé CAS01.

Set-ImapSettings -Server "CAS01" -UnencryptedOrTLSBindings IPaddress:953