New-OfflineAddressBook
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2008-01-21
Verwenden Sie das Cmdlet New-OfflineAddressBook zum Erstellen neuer Offlineadressbücher (OABs).
Syntax
New-OfflineAddressBook -Name <String> -AddressLists <AddressBookBaseIdParameter[]> -Server <ServerIdParameter> [-Confirm [<SwitchParameter>]] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-PublicFolderDatabase <DatabaseIdParameter>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-SkipPublicFolderInitialization <SwitchParameter>] [-TemplateInstance <PSObject>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Das Cmdlet New-OfflineAddressBook ermöglicht Administratoren das Erstellen neuer OABs. Wenn Sie z. B. einen Clientzugriffsserver deinstallieren, der ein OAB enthält, müssen Sie das OAB auf einem anderen Clientzugriffsserver erneut erstellen.
Damit Sie das Cmdlet New-OfflineAddressBook ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- Exchange-Organisationsadministrator (Rolle)
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 |
|---|---|---|---|
AddressLists |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.AddressBookBaseIdParameter[] |
Der Parameter AddressLists gibt ein Array von Adresslistenidentitäten an, die im OAB enthalten sind. |
Name |
Erforderlich |
System.String |
Der Parameter Name gibt den Namen an, der das OAB-Objekt im Exchange-System-Manager beschreibt (maximal 64 Zeichen). |
Server |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Der Parameter Server gibt den Server an, auf dem das neue OAB erstellt wird. |
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 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. Um die OAB-Abweichungsdateien für einen unbegrenzten Zeitraum aufzubewahren, verwenden Sie den Wert Unbegrenzt. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Der Parameter DomainController gibt den Domänencontroller an, der zum Erstellen des OABs verwendet wird. |
IsDefault |
Optional |
System.Boolean |
Wenn der Parameter IsDefault den Wert $true hat, wird das OAB als Standard-OAB für alle neuen Postfachdatenbanken festgelegt. Wenn der Wert $false lautet, wird das OAB nicht als Standard-OAB festgelegt. |
PublicFolderDatabase |
Optional |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
Der Parameter PublicFolderDatabase gibt die Identität einer Öffentliche Ordner-Datenbank an. |
PublicFolderDistributionEnabled |
Optional |
System.Boolean |
Wenn der Parameter PublicFolderDistributionEnabled den Wert |
Schedule |
Optional |
Microsoft.Exchange.Data.Schedule |
Der Parameter Schedule gibt das Intervall an, das zum Generieren des neuen 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]. |
SkipPublicFolderInitialization |
Optional |
System.Management.Automation.SwitchParameter |
Wenn Sie ein OAB erstellen, das die Verteilung in Öffentlichen Ordnern verwendet, können Sie mithilfe des Parameters SkipPublicFolderInitialization die sofortige Erstellung der Öffentlichen OAB-Ordner auslassen. Das OAB steht erst zum Download zur Verfügung, nachdem der nächste Standortordnerwartungs-Zyklus abgeschlossen wurde. Für den Parameter SkipPublicFolderInitialization muss kein Wert angegeben werden. Das Auslassen dieses Parameters kann dazu führen, dass der Task anhält, während eine Verbindung mit dem verantwortlichen Server für Öffentliche Ordner hergestellt wird, um die erforderlichen Öffentlichen Ordner zu erstellen. Wenn der Server aktuell nicht erreichbar ist, oder es aus anderen Gründen zu kostspielig ist, eine Verbindung mit ihm herzustellen, kann diese Pause von deutlicher Länge sein. |
TemplateInstance |
Optional |
System.Management.Automation.PSObject |
Der Parameter TemplateInstance gibt die Vorlage an, die zum Erstellen des neuen OABs verwendet wird. |
Versions |
Optional |
System.Collections.ObjectModel.Collection |
Der Parameter Versions gibt die zu generierende Version des OABs an. Die folgenden Werte sind zulässig:
|
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 verwendet zwei Befehle zum Erstellen eines neuen OABs mit dem Namen "OfflineAddressBook", das alle in der Organisation verfügbaren Adresslisten enthält. Mit den angezeigten Einstellungen wird montags und mittwochs zwischen 1:00 Uhr und 2:00 Uhr ein OAB von myserver.contoso.com generiert. Der Befehl erstellt außerdem das Standard-OAB für die Organisation.
$a = Get-AddressList
New-OfflineAddressBook -Name "OfflineAddressBook" -Server myserver.contoso.com -AddressLists $a -Schedule "Mon.01:00-Mon.02:00, Wed.01:00-Wed.02:00"