Set-OfflineAddressBook (RTM)
Gilt für: Exchange Server 2007
Letztes Änderungsdatum des Themas: 2007-06-05
Verwenden Sie das Cmdlet Set-OfflineAddressBook zum Ändern der Einstellungen des Offlineadressbuchs (OAB).
Syntax
Set-OfflineAddressBook -Identity <OfflineAddressBookIdParameter> [-AddressLists <AddressBookBaseIdParameter[]>] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-Name <String>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>]
Set-OfflineAddressBook [-AddressLists <AddressBookBaseIdParameter[]>] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-Instance <OfflineAddressBook>] [-IsDefault <$true | $false>] [-Name <String>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>]
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:
- die Rolle Exchange-Organisationsadministrator
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 |
|---|---|---|---|
Identity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.OfflineAddressBookIdParameter |
Verwenden Sie den Parameter Identity, um die GUID, den DN (Distinguished Name) oder den Namen des Offlineadressbuchs anzugeben, die bzw. der ein bestimmtes Offlineadressbuch 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 Name des Offlineadressbuchs 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. |
DiffRetentionPeriod |
Optional |
System.Nullable |
Der Parameter DiffRetentionPeriod gibt den Zeitraum (in Tagen) an, für den die OAB-Abweichungsdateien auf dem Server, auf dem das OAB generiert wird, und dem Clientzugriffsserver aufbewahrt werden. 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 vollständigen Objekts an den zu verarbeitenden Befehl. Er wird hauptsächlich in Skripts verwendet, in denen ein vollständiges 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 Name 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 Server 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. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
Beispiel
Dieses Beispiel ändert den Namen des Offlineadressbuchs.
Set-OfflineAddressBook -Identity "\Default Offline Address Book" -Name "My Offline Address Book"