New-OfflineAddressBook (RTM)

  • Artikel

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-05

Verwenden Sie das Cmdlet New-OfflineAddressBook zum Erstellen neuer Offlineadressbücher (OABs).

Syntax

New-OfflineAddressBook -Name <String> -AddressLists <AddressBookBaseIdParameter[]> -Server <ServerIdParameter> [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-PublicFolderDatabase <DatabaseIdParameter>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-TemplateInstance <PSObject>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>]

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:

  • 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

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.

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].

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.

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"