Set-IMAPSettings (RTM)

  • Artikel

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-11

Mithilfe des Cmdlets Set-IMAPSettings können Sie spezifische IMAP4-Einstellungen (Internet Message Access Protocol version 4rev1) für den Server mit Microsoft Exchange Server 2007 festlegen, auf dem die Serverfunktion ClientAccess installiert wurde und der IMAP4-Dienst ausgeführt wird.

Syntax

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>]

Detaillierte Beschreibung

Das Cmdlet Set-IMAPSettings ermöglicht es Ihnen, bestimmte IMAP4-Einstellungen für den Exchange 2007-Clientzugriffsserver festzulegen, auf dem der IMAP4-Dienst ausgeführt wird. Sie können dieses Cmdlet für einen einzelnen Clientzugriffsserver mit installiertem IMAP4-Dienst oder für alle Exchange 2007-Clientzugriffsserver mit installiertem IMAP4-Dienst ausführen.

Damit Sie das Cmdlet Set-IMAPSettings ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:

  • die Rolle Exchange-Serveradministrator und die Mitgliedschaft in der lokalen Gruppe Administratoren für den Zielserver

Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Parameter

Parameter Erforderlich Typ Beschreibung

AuthenticatedConnectionTimeout

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

Dieser Parameter gibt die erforderliche Wartezeit vor dem Schließen einer authentifizierten Leerlaufverbindung an. Die Standardeinstellung ist 1800 Sekunden. Die möglichen Werte liegen zwischen 30 und 86.400 Sekunden.

Banner

Optional

System.String

Dieser Parameter gibt die Bannerzeichenfolge an, die nach dem Herstellen einer Verbindung mit einem Clientzugriffsserver angezeigt wird.

CalendarItemRetrievalOption

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.CalendarItemRetrievalOptions

Dieser Parameter gibt den Typ des Kalenderelements an, das beim Zugriff auf den Kalender über IMAP4 zurückgegeben wird. Die folgenden Werte sind verfügbar:

  • 0:Calendar

  • 1:IntranetUrl

  • 2:InternetUrl

  • 3:Custom

Bei Verwendung von 3:Custom müssen Sie die Einstellung OWAServerUrl angeben.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der Daten aus dem Active Directory-Verzeichnisdienst abruft, fügen Sie dem Befehl den Parameter DomainController hinzu.

Instance

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.Imap4AdConfiguration

Der Parameter Instance gibt eine Instanz eines Active Directory-Objekts an, das mittels Pipeline an diesen Befehl übergeben und von diesem verwendet wird.

LoginType

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.LoginOptions

Dieser Parameter gibt die Authentifizierungseinstellung für den Clientzugriffsserver an, auf dem der IMAP4-Dienst ausgeführt wird. Die folgenden Werte sind möglich:

  • 1:PlainTextLogin

  • 2:PlainTextAuthentication

  • 3:SecureLogin

MaxCommandSize

Optional

System.Int32

Dieser Parameter gibt die maximale Größe eines Einzelbefehls an. Die Standardgröße liegt bei 40 Byte. Die möglichen Werte liegen zwischen 40 und 1024 Byte.

MaxConnectionFromSingleIP

Optional

System.Int32

Dieser Parameter legt die Anzahl der Verbindungen fest, die der angegebene Server von einer einzelnen IP-Adresse annimmt. Der Standardwert ist 20. Die möglichen Werte liegen zwischen 1 und 1000.

MaxConnections

Optional

System.Int32

Gibt die Gesamtzahl der Verbindungen an, die der angegebene Server annimmt. Dies umfasst authentifizierte und nicht authentifizierte Verbindungen. Die Standardgröße liegt bei 2.000 Byte. Die möglichen Werte liegen zwischen 1 und 25.000.

MaxConnectionsPerUser

Optional

System.Int32

Dieser Parameter gibt die maximale Anzahl der Verbindungen an, die der Clientzugriffsserver von einem einzelnen Benutzer annimmt. Der Standardwert ist 10. Die möglichen Werte liegen zwischen 1 und 1000.

MessageRetrievalMimeFormat

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat

Dieser Parameter gibt das Format der Nachrichten an, die vom Server abgerufen werden. Die folgenden Werte sind möglich:

  • 0: Nur Text

  • 1: Nur HTML

  • 2: HTML und Text

  • 3: Nur RTF

  • 4: UUEncode

  • 5: UUEncodeBinHex

  • 6: Bestes Nachrichtentextformat

OwaServerUrl

Optional

System.String

Dieser Parameter gibt den Clientzugriffsserver an, von dem die Kalenderinformationen für Instanzen benutzerdefinierter Outlook Web Access-Kalenderelemente abgerufen werden sollen.

PreAuthenticatedConnectionTimeout

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

Dieser Parameter gibt die erforderliche Wartezeit vor dem Schließen einer nicht authentifizierten Leerlaufverbindung an. Die Standardeinstellung ist 60 Sekunden. Die möglichen Werte liegen zwischen 10 und 3600 Sekunden.

ProxyTargetPort

Optional

System.Int32

Dieser Parameter legt den Port auf dem Back-End-Server mit Exchange Server 2003 fest, an den der IMAP4-Dienst auf einem Clientzugriffsserver Befehle per Relay weiterleitet.

Server

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Dieser Parameter legt einen einzelnen Clientzugriffsserver in Ihrer Organisation fest, für den IMAP-Einstellungen angegeben werden.

ShowHiddenFoldersEnabled

Optional

System.Boolean

Wenn dieser Parameter angegeben wird, werden ausgeblendete Ordner angezeigt. Der Standardwert ist $false.

SSLBindings

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Wenn dieser Parameter angegeben wird, gibt das Cmdlet den IP-Port zurück, der für die Kommunikation bei einer SSL-Sitzung (Secure Sockets Layer) verwendet werden soll.

UnencryptedOrTLSBindings

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Dieser Parameter gibt den IP-Port für die Kommunikation über die verschlüsselte TLS-Verbindung (Transport Layer Security) oder die nicht verschlüsselte Verbindung an.

X509CertificateName

Optional

System.String

Dieser Parameter gibt den Hostnamen im SSL-Zertifikat aus dem Feld für den zugeordneten Betreff an.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

 

Ausnahmen

Ausnahmen Beschreibung

 

 

Beispiel

Im folgenden Codebeispiel wird IPAddress für TLS für den Clientzugriffsserver namens CAS01 festgelegt.

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