Set-OfflineAddressBook
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-07-05
Verwenden Sie das Cmdlet Set-OfflineAddressBook zum Ändern der Einstellungen des Offlineadressbuchs (OAB).
Syntax
Set-OfflineAddressBook -Identity <OfflineAddressBookIdParameter> [-AddressLists <AddressBookBaseIdParameter[]>] [-ApplyMandatoryProperties <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-Name <String>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>] [-WhatIf [<SwitchParameter>]]
Set-OfflineAddressBook [-AddressLists <AddressBookBaseIdParameter[]>] [-ApplyMandatoryProperties <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-Instance <OfflineAddressBook>] [-IsDefault <$true | $false>] [-Name <String>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Mit dem Cmdlet Set-OfflineAddressBook werden die Einstellung eines vorhandenen Offlineadressbuchs (OAB) geändert. Ein OAB ist für Benutzer außerordentlich wertvoll, die lange vom Netzwerk getrennt sind. Ein OAB ist ein Snapshot mindestens einer Adressliste, den MAPI-Clients herunterladen können, um Zugriff auf die Adresslisten bereitzustellen, während der Benutzer offline ist.
Die Generierung eines OABs wird selbst dann nicht beendet, wenn mehr Zeit benötigt wird, als im Parameter Schedule angegeben wurde.
Damit Sie das Cmdlet Set-OfflineAddressBook ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- 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.OfflineAddressBookIdParameter |
Verwenden Sie den Parameter Identity, um die GUID, den DN (Distinguished Name) oder den OAB-Namen anzugeben, die bzw. der ein bestimmtes OAB darstellt. Sie können den auch den Pfad einschließen, indem Sie das Format Server\Name_des_Offlineadressbuchs verwenden. Die Parameterbezeichnung Identity kann ausgelassen werden, sodass nur der OAB-Name oder die GUID angegeben wird. |
AddressLists |
Optional |
Microsoft.Exchange.Configuration.Tasks.AddressBookBaseIdParameter[] |
Der Parameter AddressLists gibt ein Array von Adresslistenidentitäten an, die im OAB enthalten sind. |
ApplyMandatoryProperties |
Optional |
System.Management.Automation.SwitchParameter |
Das Erstellen eines Exchange 2007-OABs mithilfe des Exchange Server 2003 Exchange-System-Managers wird nicht unterstützt. Wenn ein Exchange 2007-OAB mit diesem Tool erstellt wird, wird es als Legacy-OAB identifiziert, auch wenn es sich auf einem Server mit Exchange 2007 befindet. Verwenden Sie den Parameter ApplyMandatoryProperties, um die obligatorischen Eigenschaften eines OABs in diesem Zustand zu ändern, um das Problem zu beheben. |
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. |
DiffRetentionPeriod |
Optional |
System.Nullable |
Der Parameter DiffRetentionPeriod gibt die Zeitdauer in Tagen an, für die Dateien, die die Abweichungen zwischen Offlineadressbüchern enthalten, auf dem Clientzugriffsserver und auf dem Server beibehalten werden, der das Offlineadressbuch generiert. Verwenden Sie den Wert Unbegrenzt, wenn solche Dateien ohne Zeitlimit beibehalten werden sollen. |
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.OfflineAddressBook |
Der Parameter Instance ermöglicht das Übergeben eines gesamten Objekts an den zu verarbeitenden Befehl. Er wird hauptsächlich in Skripts verwendet, in denen ein gesamtes Objekt an den Befehl übergeben werden muss. |
IsDefault |
Optional |
System.Boolean |
Mit dem Parameter IsDefault wird dieses Offlineadressbuch als standardmäßiges Offlineadressbuch für alle neuen Postfachspeicher festgelegt. |
Name |
Optional |
System.String |
Der Parameter Name legt den neuen Namen des OABs fest. Dieser Name wird in der Exchange-Verwaltungskonsole angezeigt. Ein Wert des Name-Parameters darf bis zu 64 Zeichen enthalten. |
PublicFolderDistributionEnabled |
Optional |
System.Boolean |
Wird der Parameter PublicFolderDistributionEnabled auf den Wert $true festgelegt, wird das OAB über Öffentliche Ordner verteilt. Der Standardwert lautet $true. |
Schedule |
Optional |
Microsoft.Exchange.Data.Schedule |
Der Parameter Schedule gibt das Intervall an, das zum Generieren des OABs geplant ist. Der Parameter Schedule nimmt das folgende Format an und muss einen Bereich umfassen: Wochentag.Stunde:Minute [AM/PM]-Wochentag.Stunde:Minute [AM/PM]. |
Versions |
Optional |
System.Collections.ObjectModel.Collection |
Der Parameter Versions gibt die OAB-Versionen an, die für den Clientdownload generiert werden. Die verfügbaren Optionen lauten "Version4", "Version3" und "Version2". "Version4" dient für Microsoft Office Outlook 2007- oder Office Outlook 2003 Service Pack 2-Clients. "Version3" dient für Outlook-Clients, die Unicode unterstützen. "Version2" dient für Microsoft Exchange Server 2007-, Exchange 2003-, Exchange 2000 Server- und Exchange Server version 5.5-Clients. |
VirtualDirectories |
Optional |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter[] |
Der Parameter VirtualDirectories gibt das Array der OABVirtualDirectory-Objekte an. Wenn der Parameter VirtualDirectories angegeben wird, muss "Version4" des OABs generiert werden. |
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
Dieses Beispiel ändert den Namen des OABs.
Set-OfflineAddressBook -Identity "\Default Offline Address Book" -Name "My Offline Address Book"