Set-IMAPSettings (RTM)
S’applique à : Exchange Server 2007
Dernière rubrique modifiée : 2007-06-11
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>] [-DomainController <Fqdn>] [-Instance <Imap4AdConfiguration>] [-LoginType <PlainTextLogin | PlainTextAuthentication | SecureLogin>] [-MaxCommandSize <Int32>] [-MaxConnectionFromSingleIP <Int32>] [-MaxConnections <Int32>] [-MaxConnectionsPerUser <Int32>] [-MessageRetrievalMimeFormat <TextOnly | HtmlOnly | HtmlAndTextAlternative | TextEnrichedOnly | TextEnrichedAndTextAlternative | BestBodyFormat>] [-OwaServerUrl <String>] [-PreAuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-ProxyTargetPort <Int32>] [-Server <ServerIdParameter>] [-ShowHiddenFoldersEnabled <$true | $false>] [-SSLBindings <MultiValuedProperty>] [-UnencryptedOrTLSBindings <MultiValuedProperty>] [-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 le 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 Server 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 :
Si vous utilisez la valeur 3 : Custom, vous devez spécifier le paramètre OWAServerUrl. |
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. |
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 :
|
MaxCommandSize |
Facultatif |
System.Int32 |
Ce paramètre spécifie la taille maximale d'une commande. La taille par défaut est 40 octets. Les valeurs possibles vont de 40 à 1024 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 |
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 octets. 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 :
|
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 |
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. |
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 sur le serveur d'accès au client nommé CAS01.
Set-ImapSettings -Server "CAS01" -UnencryptedOrTLSBindings IPaddress:953