Set-OutlookProvider

 

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

Letztes Änderungsdatum des Themas: 2007-06-28

Verwenden Sie das Cmdlet Set-OutlookProvider, um bestimmte globale Einstellungen mithilfe des Attributs msExchOutlookProvider des msExchAutoDiscoverConfig-Objekts im Active Directory-Verzeichnisdienst festzulegen.

Syntax

Set-OutlookProvider -Identity <OutlookProviderIdParameter> [-CertPrincipalName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Name <String>] [-Server <String>] [-TTL <Int32>] [-WhatIf [<SwitchParameter>]]

Set-OutlookProvider [-CertPrincipalName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <OutlookProvider>] [-Name <String>] [-Server <String>] [-TTL <Int32>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Das Cmdlet Set-OutlookProvider erstellt die globalen Einstellungen für den AutoErmittlungsdienst. Es legt das AutoDiscoverConfig-Objekt unter dem Global Settings-Objekt in Active Directory fest und legt die Attribute fest, die in den Parametern des Abschnitts Parameter angegeben sind.

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

  • die Rolle Exchange-Organisationsadministrator

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Microsoft.Exchange.Configuration.Tasks.OutlookProviderIdParameter

Der Parameter Identity gibt den ADIDParameter-Wert des MAPI-Protokolls an, für das globale Einstellungen festgelegt werden sollen.

CertPrincipalName

Optional

System.String

Der Parameter CertPrincipalName gibt den Prinzipalnamen des SSL-Zertifikats (Secure Sockets Layer) an, der erforderlich ist, um eine Verbindung von einem externen Standort zu Exchange herzustellen.

Dieser Parameter wird nur für Microsoft Outlook Anywhere-Clients verwendet. 

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 Confirm-Parameter 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 Active Directory abruft, fügen Sie dem Befehl den Parameter DomainController hinzu.

Instance

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.OutlookProvider

Der Parameter Instance ermöglicht das Übergeben eines vollständigen Objekts an den zu verarbeitenden Befehl. Er wird hauptsächlich in Skripts verwendet, in denen ein gesamtes Objekt an den Befehl übergeben werden muss.

Name

Optional

System.String

Verwenden Sie den Parameter Name, um einen allgemeinen Namen für das Outlook-Anbieterkonfigurationsobjekt anzugeben. Hierbei kann es sich um einen benutzerfreundlichen Namen für die Identifikation handeln.

Server

Optional

System.String

Verwenden Sie den Parameter Server, um den für Outlook Anywhere-Clients zu verwendenden Mailserver anzugeben.

TTL

Optional

System.Int32

Der Parameter TTL gibt den Zeitraum (in Stunden) an, für den die angegebenen Einstellungen gültig sind.

Wird ein Wert angegeben, werden die Einstellungen nach Ablauf des mit diesem Parameter angegebenen Zeitraums über den AutoErmittlungsdienst erneut ermittelt. Der Wert 0 gibt an, dass keine erneute Ermittlung erforderlich ist. Der Standardwert ist 1 Stunde.

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 WhatIf-Parameter muss kein Wert angegeben werden.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

Ausnahmen

Ausnahmen Beschreibung

 

Beispiel

In diesem Beispiel dient der Befehl Set-OutlookProvider zum Ändern des Zeitraums, für den die AutoErmittlungseinstellungen des Outlook-Anbieterattributs msExchAutoDiscoverConfig gültig sind.

Set-OutlookProvider -Identity msExchAutoDiscoverConfig -TTL 2