New-OfflineAddressBook
Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im cloudbasierten Dienst verfügbar. Einige Parameter und Einstellungen gelten exklusiv für die eine oder andere Umgebung.
Verwenden Sie das Cmdlet New-OfflineAddressBook zum Erstellen von Offlineadressbüchern (OAB).
In Exchange Online ist dieses Cmdlet nur in der Rolle Adresslisten verfügbar, und standardmäßig ist die Rolle keinem Rollengruppen zugewiesen. Um dieses Cmdlet verwenden zu können, müssen Sie die Rolle Adresslisten einer Rollengruppe (z. B. der Rollengruppe Organisationsverwaltung) hinzufügen. Weitere Informationen finden Sie unter Hinzufügen einer Rolle zu einer Rollengruppe.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
New-OfflineAddressBook
[-Name] <String>
-AddressLists <AddressBookBaseIdParameter[]>
[-Confirm]
[-DiffRetentionPeriod <Unlimited>]
[-DomainController <Fqdn>]
[-GeneratingMailbox <MailboxIdParameter>]
[-GlobalWebDistributionEnabled <Boolean>]
[-IsDefault <Boolean>]
[-PublicFolderDatabase <DatabaseIdParameter>]
[-PublicFolderDistributionEnabled <Boolean>]
[-Schedule <Schedule>]
[-Server <ServerIdParameter>]
[-ShadowMailboxDistributionEnabled <Boolean>]
[-SkipPublicFolderInitialization]
[-Versions <MultiValuedProperty>]
[-VirtualDirectories <VirtualDirectoryIdParameter[]>]
[-WhatIf]
[<CommonParameters>] Beschreibung
Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.
Beispiele
Beispiel 1
$a = Get-AddressList | Where {$_.Name -Like "*AgencyB*"}
New-OfflineAddressBook -Name "OAB_AgencyB" -Server myserver.contoso.com -AddressLists $a -Schedule "Mon.01:00-Mon.02:00, Wed.01:00-Wed.02:00"In Exchange Server 2010 und 2013 verwendet dieses Beispiel zwei Befehle, um das OAB mit dem Namen OAB_AgencyB zu erstellen, das alle Adresslisten enthält, in denen AgencyB Teil des Namens ist. Mithilfe der gezeigten Einstellungen wird von myserver.contoso.com montags und mittwochs von 01:00 Uhr (01:00 Uhr) bis 02:00 Uhr (2:00 Uhr) ein OAB generiert. Mit diesem Beispielbefehl wird auch das Standard-OAB für die organization erstellt.
Beispiel 2
New-OfflineAddressBook -Name "Contoso Executives OAB" -AddressLists "Default Global Address List","Contoso Executives Address List" -GlobalWebDistributionEnabled $trueIn diesem Beispiel wird ein neues OAB namens „Contoso Executives OAB“ mit den folgenden Eigenschaften erstellt:
- Adresslisten, die in der OAB enthalten sind: Globale Standardadressliste und Adressliste der Führungskräfte von Contoso
- Alle virtuellen OAB-Verzeichnisse in der Organisation können Anforderungen zum Herunterladen der OAB akzeptieren.
Das Postfach der Organisation, das für das Generieren der OAB verantwortlich ist, ist SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c} (wir haben nicht den GeneratingMailbox-Parameter verwendet, um ein anderes Postfach der Organisation anzugeben).
Das OAB wird nicht von Postfächern und Postfachdatenbanken verwendet, für die kein OAB angegeben ist (wir haben nicht den IsDefault-Parameter mit dem Wert $true verwendet).
Beispiel 3
New-OfflineAddressBook -Name "New OAB" -AddressLists "\Default Global Address List" -Server SERVER01 -VirtualDirectories "SERVER01\OAB (Default Web Site)"In Exchange Server 2010 erstellt dieses Beispiel das OAB New OAB, das die webbasierte Verteilung für Microsoft Office Outlook 2007 oder höher-Clients auf SERVER01 verwendet, indem das virtuelle Standardverzeichnis verwendet wird.
Beispiel 4
New-OfflineAddressBook -Name "Legacy OAB" -AddressLists "\Default Global Address List" -Server SERVER01 -PublicFolderDatabase "PFDatabase" -PublicFolderDistributionEnabled $true -Versions Version1,Version2In Exchange Server 2010 erstellt dieses Beispiel das OAB Legacy-OAB, das die Verteilung öffentlicher Ordner für Outlook 2003 Service Pack 1 (SP1) und Outlook 98 Service Pack 2 (SP2)-Clients auf SERVER01 verwendet.
Wenn Sie OABs für die Verwendung der Verteilung öffentlicher Ordner konfigurieren, Ihr organization jedoch keine Infrastruktur für öffentliche Ordner aufweist, wird ein Fehler zurückgegeben. Weitere Informationen finden Sie unter Verwalten öffentlicher Ordner.
Parameter
-AddressLists
Der Parameter AddressLists gibt die Adresslisten oder globalen Adresslisten an, die im OAB enthalten sind. Sie können einen beliebigen Wert verwenden, der die Adressliste eindeutig identifiziert. Beispiel:
- Name
- Distinguished Name (DN)
- GUID
Mehrere Werte können durch Kommata getrennt eingegeben werden. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".
Die Identifikationswerte von Adresslisten und globalen Adresslisten finden Sie mit den Get-AddressList und Get-GlobalAddressList Cmdlets.
| Type: | AddressBookBaseIdParameter[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Confirm
Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.
- Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen:
-Confirm:$false. - Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DiffRetentionPeriod
Der Parameter DiffRetentionPeriod gibt die Anzahl der Tage an, in denen die OAB-Differenzdateien auf dem Server gespeichert sind. Gültige Werte sind ganze Zahlen von 7 bis 1825 oder der Wert unlimited. Der Standardwert ist 30.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
Dieser Parameter ist im lokalen Exchange verfügbar.
Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: dc01.contoso.com.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-GeneratingMailbox
Dieser Parameter ist nur im lokalen Exchange verfügbar.
Der Parameter GeneratingMailbox gibt das Vermittlungsspostfach an, in dem das OAB erzeugt wird. Insbesondere muss das Vermittlungspostfach den Wert OrganizationCapabilityOABGen für die PersistedCapability-Eigenschaft enthalten. Ein Vermittlungspostfach mit dieser Fähigkeit ist auch als Organisationspostfach bekannt. Sie können jeden beliebigen Wert verwenden, sofern er das Postfach eindeutig kennzeichnet. Beispiel:
- Name
- Alias
- Distinguished Name (DN)
- Distinguished Name (DN)
- Domäne\benutzername
- E-Mail-Adresse
- GUID
- LegacyExchangeDN
- SamAccountName
- Benutzer-ID oder User Principal Name (UPN)
Der Standardwert für diesen Parameter ist das Organisationspostfach mit dem Namen SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c}.
Ein einzelnes organization Postfach kann mehrere OABs generieren (Sie können denselben Wert für diesen Parameter in den Einstellungen mehrerer OABs verwenden), aber in Exchange 2013 CU5 oder höher kann ein OAB nur von einem einzelnen organization Postfach generiert werden (dieser Parameter akzeptiert nicht mehrere Werte). Um eine schreibgeschützte Kopie des OAB (auch bekannt als ein Schattenkopie) in anderen Organisationspostfächern zur Verfügung zu haben, verwenden Sie den Parameter ShadowMailboxDistributionEnabled.
| Type: | MailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-GlobalWebDistributionEnabled
Dieser Parameter ist nur im lokalen Exchange verfügbar.
Der Parameter GlobalWebDistributionEnabled gibt an, ob alle virtuellen OAB-Verzeichnisse in der Organisation Anforderungen zum Herunterladen des OAB akzeptieren können. Diese Speicherorte sind vom AutoErmittlungsdienst angekündigt. Gültige Werte sind:
- $true: Jedes virtuelle OAB-Verzeichnis im organization kann Anforderungen zum Herunterladen des OAB akzeptieren. Verwenden Sie diese Einstellungen nicht zusammen mit dem Parameter VirtualDirectories.
- $false: Nur die virtuellen OAB-Verzeichnisse, die durch den Parameter VirtualDirectories angegeben werden, akzeptieren Anforderungen zum Herunterladen des OAB. Dies ist der Standardwert.
In Exchange 2013 CU7 oder höher wird empfohlen, den Wert $true für diesen Parameter zu verwenden. Die Client Access Services auf einem beliebigen Postfachserver können eingehende OAB-Downloadanforderungen an den richtigen Speicherort senden.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IsDefault
Der Parameter IsDefault gibt an, ob das OAB von allen Postfächern und Postfachdatenbanken verwendet wird, für die kein OAB angegeben ist. Gültige Werte sind:
- $true: Das OAB ist das Standard-OAB.
- $false: Das OAB ist nicht das Standard-OAB. Dies ist der Standardwert.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Name
Der Parameter Name gibt den eindeutigen Namen des OAB an. Die Höchstlänge beträgt 64 Zeichen. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-PublicFolderDatabase
Dieser Parameter ist nur in Exchange Server 2010 verfügbar.
Der Parameter PublicFolderDatabase gibt die Öffentliche Ordner-Datenbank an, die zum Verteilen des OAB verwendet wird. Sie können jeden beliebigen Wert verwenden, sofern er die Datenbank eindeutig kennzeichnet. Beispiel:
- Name
- Distinguished Name (DN)
- GUID
Um diesen Parameter verwenden zu können, muss der Parameter PublicFolderDistributionEnabled auf $true festgelegt werden.
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-PublicFolderDistributionEnabled
Dieser Parameter ist nur in Exchange Server 2010 verfügbar.
Der Parameter PublicFolderDistributionEnabled gibt an, ob das OAB über öffentliche Ordner verteilt wird. Wenn der Wert des Parameters PublicFolderDistributionEnabled $true ist, wird das OAB über öffentliche Ordner verteilt.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-Schedule
Dieser Parameter ist nur in Exchange Server 2010 verfügbar.
Der Parameter Schedule gibt das Intervall zum Generieren des OAB in Exchange 2010 oder früher an.
Die Syntax für diesen Parameter lautet: StartDay.Hour:Minute [AM | PM]-EndDay.Hour:Minute [AM | PM].
Sie können die folgenden Werte für Tage verwenden:
- Vollständiger Name des Tages.
- Abgekürzter Name des Tages.
- Ganze Zahl von 0 bis 6, wobei 0 = Sonntag ist.
Sie können die Uhrzeit im 24-Stunden-Format eingeben und den AM/PM-Wert weglassen. Wenn Sie die Zeit im 12-Stunden-Format eingeben, fügen Sie ein Leerzeichen zwischen der Uhrzeit und dem AM/PM-Wert ein.
Sie können Datums-/Uhrzeitformate kombinieren und abgleichen.
Zwischen Start- und Endzeit müssen mindestens 15 Minuten liegen. Minuten werden auf 0, 15, 30 oder 45 abgerundet.
Hier sind einige Beispiele:
- "So.23:30-Mo.1:30"
- "6.22:00-6.22:15" (Ausführung von Samstag um 22:00 Uhr bis Samstag um 22:15 Uhr.)
- "So.1:15 AM-Monday.23:00"
| Type: | Schedule |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-Server
Dieser Parameter ist nur in Exchange Server 2010 verfügbar.
Der Parameter "Server" gibt den Exchange-Server an, auf dem dieser Befehl ausgeführt werden soll. Der Parameter MailboxServer gibt den zu testenden exExchange2k16- oder exExchange2k13-Postfachserver an. Beispiel:
- Name
- FQDN
- Distinguished Name (DN)
- ExchangeLegacyDN
Exchange-Legacy-DN
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-ShadowMailboxDistributionEnabled
Dieser Parameter ist im lokalen Exchange verfügbar.
Der Parameter ShadowMailboxDistributionEnabled gibt an, ob eine schreibgeschützte Kopie des OAB (auch als Schattenkopie bezeichnet) auf alle anderen OAB-Generierungspostfächer (auch als Organisationspostfächer bezeichnet) verteilt wird. Dadurch können zusätzliche Postfachserver Endpunkte für Anfragen zum Herunterladen des OAB sein, die verhindern können, dass Benutzer das OAB über langsame WAN-Verbindungen herunterladen. Gültige Werte sind:
- $true: Das OAB wird an alle anderen organization Postfächer verteilt.
- $false: Das OAB wird nicht an andere organization Postfächer verteilt. Dies ist der Standardwert.
Der Wert dieses Parameters ist nur von Bedeutung, wenn Sie über mehrere organization Postfächer verfügen, und ist nur in Exchange-Organisationen mit mehreren Active Directory-Standorten von Vorteil.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SkipPublicFolderInitialization
Dieser Parameter ist nur in Exchange Server 2010 verfügbar.
Der Schalter SkipPublicFolderInitialization gibt an, ob die sofortige Erstellung der öffentlichen OAB-Ordner übersprungen werden soll, wenn Sie ein OAB erstellen, das die Verteilung öffentlicher Ordner verwendet. Sie müssen bei dieser Option keinen Wert angeben.
Das OAB kann erst heruntergeladen werden, wenn der nächste Wartungszyklus für Standortordner abgeschlossen ist. Das Auslassen dieses Schalters kann dazu führen, dass die Aufgabe angehalten wird, während sie den zuständigen Server für öffentliche Ordner kontaktiert, um die erforderlichen öffentlichen Ordner zu erstellen. Wenn der Server derzeit nicht erreichbar ist oder anderweitig teuer zu kontaktieren ist, kann die Pause erheblich sein.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-Versions
Dieser Parameter ist nur in Exchange Server 2010 verfügbar.
Der Parameter Versions gibt die OAB-Versionen an, die für den Clientdownload generiert werden. Gültige Werte sind:
- Version 2 (erfordert Verteilung öffentlicher Ordner)
- Version3 (erfordert Verteilung öffentlicher Ordner)
- Version4 (Standardwert)
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-VirtualDirectories
Dieser Parameter ist im lokalen Exchange verfügbar.
Der Parameter VirtualDirectories gibt die virtuellen OAB-Verzeichnisse an, die Anforderungen zum Herunterladen des OAB akzeptieren. Diese Speicherorte sind im AutoErmittlungsdienst angekündigt.
Sie können einen beliebigen Wert verwenden, der das virtuelle Verzeichnis eindeutig identifiziert. Beispiel:
- Name oder Server\Name
- Distinguished Name (DN)
- GUID
Der Wert für „Name“ verwendet die Syntax "VirtualDirectoryName (WebsiteName)" aus den Eigenschaften des virtuellen Verzeichnisses. Sie können das Platzhalterzeichen (*) anstelle der Standardwebsite angeben, indem Sie die Syntax VirtualDirectoryName*verwenden.
Der Standardwert dieses Parameters ist die virtuellen Verzeichnisse Clientzugriffsdienste (Front-End) und Back-End-OAB auf dem Postfachserver, der das Postfach der OAB-Generation enthält (der GeneratingMailbox-Parameter oder SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c}). Beispiel: Mailbox01\OAB (Standardwebsite), Mailbox01\OAB (Exchange-Back-End.
Um diesen Parameter zu verwenden, muss der Wert des GlobalWebDistributionEnabled-Parameters $false sein.
In Exchange 2013 CU7 oder höher wird empfohlen, den Parameter GlobalWebDistributionEnabled auf $true festzulegen, da die Clientzugriffsdienste auf jedem Postfachserver eingehende OAB-Downloadanforderungen an den richtigen Speicherort proxyn können.
| Type: | VirtualDirectoryIdParameter[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
Eingaben
Input types
Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.
Ausgaben
Output types
Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.