Set-IMAPSettings

  • Artikel

 

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Letztes Änderungsdatum des Themas: 2009-05-15

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

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 dem verwendeten Konto die Rolle Exchange-Serveradministrator zugewiesen worden sein, und es muss der lokalen Gruppe Administratoren für den Zielserver angehören.

Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Exchange 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.

Confirm

Optional

System.Management.Automation.SwitchParameter

Der Confirm-Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Parameter Confirm muss kein Wert angegeben werden.

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.

EnableExactRFC822Size

Optional

System.Boolean

Der Parameter EnableExactRFC822Size wird verwendet, um den richtigen Wert RFC822.SIZE jeder E-Mail-Nachricht in einem Postfach zurückzugeben.

Standardmäßig schätzt Exchange 2007 den Wert RFC822.SIZE, weil Exchange 2007 den MIME-Code neu erstellen muss, um die genaue Größe zu ermitteln. Die Neuerstellung des MIME-Codes wirkt sich möglicherweise negativ auf die Leistung aus, wenn das Postfach große Nachrichten mit tief geschachtelten Anlagen enthält. Einige Clients verlangen jedoch ggf. dass der Wert RFC822.SIZE ein genauer und kein geschätzter Wert ist.

Verwenden Sie den folgenden Befehl, um die genaue Größe des Werts für alle Benutzer zu aktivieren:

Set-ImapSettings -EnableExactRFC822Size:$true

Verwenden Sie den folgenden Befehl, um die genaue Größe des Werts nur für einen bestimmten Benutzer zu aktivieren:

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

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 10240 Byte. Die möglichen Werte liegen zwischen 1.024 und 16.384 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

Dieser Parameter gibt die Gesamtzahl der Verbindungen an, die der angegebene Server annimmt. Dies umfasst authentifizierte und nicht authentifizierte Verbindungen. Die Standardeinstellung ist 2.000 Verbindungen. 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: 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.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Der Parameter WhatIf weist den Befehl an, die für das Objekt ausgeführten Aktionen lediglich zu simulieren. Durch Verwendung des WhatIf-Parameters können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den Parameter WhatIf muss kein Wert angegeben werden.

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 die IP-Adresse für TLS für den Clientzugriffsserver namens CAS01 festgelegt.

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