Set-POPSettings

  • 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-POPSettings können Sie die POP3-Einstellungen (Post Office Protocol Version 3) für den Servercomputer mit Microsoft Exchange Server 2007 angeben, auf dem die Serverfunktion ClientAccess installiert ist und der POP3-Dienst ausgeführt wird.

Syntax

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

Detaillierte Beschreibung

Das Cmdlet Set-POPSettings wird zum Festlegen von POP3-Eigenschaften für einen Clientzugriffsserver verwendet. Sie können dieses Cmdlet für einen einzelnen Clientzugriffsserver ausführen, auf dem der POP3-Dienst installiert ist oder für alle Exchange 2007-Computer in Ihrer Organisation, auf denen die Serverfunktion ClientAccess und der POP3-Dienst installiert sind.

Damit Sie das Cmdlet Set-POPSettings 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 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 Zeit an, die vor dem Schließen einer authentifizierten Leerlaufverbindung gewartet werden muss. 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 Einrichten einer Verbindung zu einem Clientzugriffsserver angezeigt wird.

CalendarItemRetrievalOption

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.CalendarItemRetrievalOptions

Dieser Parameter gibt den Typ des Kalenderelements an, das zurückgegeben wird, wenn auf den Kalender mithilfe von POP3 zugegriffen 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

Dieser Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt den Benutzer, 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.Pop3AdConfiguration

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

LoginType

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.LoginOptions

Dieser Parameter gibt die Authentifizierungseinstellung an, die für den Clientzugriffsserver verwendet wird, der den POP3-Dienst ausführt. 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 gibt die Anzahl der Verbindungen an, 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

MessageRetrievalSortOrder

Optional

Microsoft.Exchange.Data.SortOrder

Dieser Parameter gibt die Reihenfolge an, in der die abgerufenen Nachrichten sortiert werden. Dieser Wert kann entweder 0 (Aufsteigend) oder 1 (Absteigend) sein.

OwaServerUrl

Optional

System.String

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

PreAuthenticatedConnectionTimeout

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

Dieser Parameter gibt die Zeit an, die vor dem Schließen einer Leerlaufverbindung gewartet werden muss, die nicht authentifiziert ist. Die Standardeinstellung ist 60 Sekunden. Die möglichen Werte liegen zwischen 10 und 3600 Sekunden.

ProxyTargetPort

Optional

System.Int32

Dieser Parameter gibt den Port am Exchange Server 2003-Back-End-Server an, an den der POP3-Dienst auf einem Clientzugriffsserver Befehle weitergibt.

Server

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Dieser Parameter gibt einen einzelnen Clientzugriffsserver Ihrer Organisation an, für den Sie POP3-Einstellungen angeben.

SSLBindings

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Wenn dieser Parameter angegeben ist, gibt das Cmdlet den für eine SSL-Sitzung (Secure Sockets Layer) zu verwendenden IP-Port zurück.

UnencryptedOrTLSBindings

Optional

Microsoft.Exchange.Data.MultiValuedProperty

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

WhatIf

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter weist den Befehl an, die Aktionen zu simulieren, die für das Objekt ausgeführt würden. 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 äääAssociated Subject 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-PopSettings -Server "CAS01" -UnencryptedOrTLSBindings IPaddress:953