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