Freigeben über

New-OfflineAddressBook

  • Artikel

 

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 $true hat, wird das OAB über Öffentliche Ordner verteilt.

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:

  • Version1

  • Version2

  • Version3

  • Version4

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"