Adressrichtlinien und Adresslisten Address Policies and Address Lists

Referenz für ABP, GAL-Segmentierung, Address Lists, Email Address Policies, OAB, HAB, Federation und unterstützte Verwaltungsschnittstellen. Reference for ABP, GAL segmentation, address lists, email address policies, OAB, HAB, federation, and supported management interfaces.

ABP
Segmentierung Segmentation
%m
SMTP-Variablen SMTP variables
OAB
Offline Clients Offline clients
Federation
Sharing Layer Sharing layer
📇 Adresspolitik ist Sichtbarkeit plus Adresse Address policy means visibility plus address

ABP, GALs und Address Lists regeln, was Benutzer sehen. Email Address Policies regeln, welche Adressen generiert werden. Beide Bereiche hängen zusammen, sollten aber getrennt geplant und geändert werden. ABPs, GALs, and address lists govern what users can see. Email address policies govern which addresses are generated. Both areas are connected but should be planned and changed separately.

Address Book Policies und GAL-Segmentierung Address book policies and GAL segmentation

ABPs kombinieren GAL, OAB, Room List und Address Lists zu einer logischen Sicht pro Benutzergruppe. ABPs combine GAL, OAB, room list, and address lists into one logical view per user group.

Address Lists, Custom GALs und RecipientFilter Address lists, custom GALs, and RecipientFilter

RecipientFilter nutzt OPATH-Syntax; saubere Attribute sind die Grundlage jeder Segmentierung. RecipientFilter uses OPATH syntax; clean attributes are the foundation of every segmentation model.

Email Address Policies und SMTP-Generierung Email address policies and SMTP generation

Email Address Policies erzeugen primäre und sekundäre SMTP-Adressen anhand definierter Vorlagen und Prioritäten. Email address policies generate primary and secondary SMTP addresses based on defined templates and priorities.

OAB, HAB, Sharing Policies, Federation und Beziehungen OAB, HAB, sharing policies, federation, and relationships

Adresssicht, Offlinezugriff und organisationsübergreifendes Sharing hängen von mehreren Exchange-Komponenten ab. Address visibility, offline access, and cross-organization sharing depend on several Exchange components.

Cmdlet-Referenz und Graph-Verfügbarkeit Cmdlet reference and Graph availability

Adressrichtlinien werden fast vollständig über Exchange PowerShell verwaltet; Graph bietet nur flankierende Verzeichnissicht. Address policies are managed almost entirely through Exchange PowerShell; Graph only offers adjacent directory visibility.

Troubleshooting und Best Practices Troubleshooting and best practices

Die häufigsten Fehler liegen in Attributqualität, Policy-Priorität und unrealistischen Erwartungen an ABP als Sicherheitsgrenze. The most common issues are attribute quality, policy priority, and unrealistic expectations of ABP as a security boundary.

Address Book Policies und GAL-Segmentierung Address book policies and GAL segmentation

Address Book Policies segmentieren die Empfängersicht in Exchange Online. Eine ABP weist Benutzern genau eine Global Address List, ein Offline Address Book, eine Room List und optional mehrere Address Lists zu. Das ist besonders relevant für Multi-Brand-, Behörden-, Holding- oder isolierte Geschäftsbereiche. Address book policies segment the recipient view in Exchange Online. An ABP assigns users exactly one global address list, one offline address book, one room list, and optionally several address lists. This is especially relevant for multi-brand, government, holding, or isolated business units.

GAL-Segmentierung ist keine Sicherheitsgrenze. Sie verbessert die Adressbuchsicht in Outlook und OWA, ersetzt aber keine Compliance-Isolation, Information Barriers oder Transportregeln. Für echte Kommunikationsgrenzen müssen zusätzliche Kontrollen geplant werden. GAL segmentation is not a security boundary. It improves address book visibility in Outlook and OWA, but it does not replace compliance isolation, information barriers, or transport rules. Real communication boundaries require additional controls.

ABP-Bausteine ABP building blocks

Element Element Funktion Function Hinweis Note
Global Address List Global address list Primäre Empfängersicht für Benutzer. Primary recipient view for users. Eine GAL wird über RecipientFilter definiert. A GAL is defined through RecipientFilter.
Offline Address Book Offline address book Offline-Adresslistenpaket für Outlook Cached Mode. Offline address list package for Outlook cached mode. Muss zur Ziel-GAL und den Address Lists passen. Must align to the target GAL and address lists.
Room List Room list Spezielle Liste für Raumauswahl in Outlook. Special list for room selection in Outlook. Wichtig für Room Finder und segmentierte Ressourcen. Important for Room Finder and segmented resources.
Address Lists Address lists Zusätzliche Empfängerlisten pro Fachbereich oder Objektklasse. Additional recipient lists per department or object class. Zu viele granulare Listen erschweren Betrieb und Tests. Too many granular lists complicate operations and testing.

Implementierung Implementation

  1. Bestandsaufnahme, Rollen und Abhängigkeiten für Address Book Policies und GAL-Segmentierung dokumentieren. Document the current state, roles, and dependencies for Address book policies and GAL segmentation.
  2. Pilotobjekte mit realistischen Daten und Berechtigungen auswählen. Select pilot objects with realistic data and permissions.
  3. Portaländerungen immer mit PowerShell oder API-Abfragen gegenprüfen. Always validate portal changes with PowerShell or API queries.
  4. Monitoring, Support-Runbook und Rückfalloptionen vor der Produktion festhalten. Capture monitoring, support runbooks, and rollback options before production rollout.

Betrieb & Hinweise Operations & Notes

PowerShell: ABP-Grundaufbau PowerShell: ABP foundation

PowerShell PowerShell
New-GlobalAddressList -Name "GAL-Finance" -RecipientFilter "(RecipientType -eq 'UserMailbox') -and (Department -eq 'Finance')"
New-OfflineAddressBook -Name "OAB-Finance" -AddressLists "\All Rooms","\All Users","\Finance Users"
New-AddressBookPolicy -Name "ABP-Finance" -GlobalAddressList "\GAL-Finance" -OfflineAddressBook "\OAB-Finance" -RoomList "\Finance Rooms" -AddressLists "\Finance Users"
Set-Mailbox finance.user@contoso.com -AddressBookPolicy "ABP-Finance"

Address Lists, Custom GALs und RecipientFilter Address lists, custom GALs, and RecipientFilter

Address Lists und GALs werden in Exchange Online mit RecipientFilter erstellt. Die Filterlogik ist OPATH-basiert und arbeitet auf Exchange-relevanten Empfängereigenschaften wie RecipientTypeDetails, Company, Department, CustomAttribute1-15 oder CountryOrRegion. Address lists and GALs are created in Exchange Online with RecipientFilter. The filter logic is OPATH-based and works against Exchange-relevant recipient properties such as RecipientTypeDetails, Company, Department, CustomAttribute1-15, or CountryOrRegion.

In großen Tenants sollten Filter auf wenige, sauber gepflegte Attribute standardisiert werden. Schlechte Datenqualität oder gemischte Attributnutzung führen sonst zu unvollständigen GALs, unerwarteten Room Lists oder falschen OAB-Inhalten. In large tenants, filters should be standardized on a few cleanly governed attributes. Poor data quality or mixed attribute usage otherwise leads to incomplete GALs, unexpected room lists, or incorrect OAB contents.

RecipientFilter-Muster RecipientFilter patterns

Szenario Scenario Filterbeispiel Filter example Kommentar Comment
Fachbereich Department (RecipientTypeDetails -eq 'UserMailbox') -and (Department -eq 'Finance') (RecipientTypeDetails -eq 'UserMailbox') -and (Department -eq 'Finance') Einfaches und robustes Standardmuster. Simple and robust default pattern.
Marke / Tochter Brand / subsidiary (Company -eq 'Contoso Retail') -and (HiddenFromAddressListsEnabled -eq $false) (Company -eq 'Contoso Retail') -and (HiddenFromAddressListsEnabled -eq $false) Company muss im HR- oder Provisioningprozess gepflegt sein. Company must be maintained through HR or provisioning.
Raumliste Room list (RecipientTypeDetails -eq 'RoomMailbox') -and (CustomAttribute1 -eq 'BER') (RecipientTypeDetails -eq 'RoomMailbox') -and (CustomAttribute1 -eq 'BER') Hilft bei standortbezogenen Room Lists. Useful for site-specific room lists.
Ausschluss externer Kontakte Exclude external contacts (RecipientTypeDetails -eq 'UserMailbox') -and (Alias -ne $null) (RecipientTypeDetails -eq 'UserMailbox') -and (Alias -ne $null) Filter besser positiv statt durch viele NOT-Bedingungen formulieren. Prefer positive filters instead of many NOT clauses.

Implementierung Implementation

  1. Bestandsaufnahme, Rollen und Abhängigkeiten für Address Lists, Custom GALs und RecipientFilter dokumentieren. Document the current state, roles, and dependencies for Address lists, custom GALs, and RecipientFilter.
  2. Pilotobjekte mit realistischen Daten und Berechtigungen auswählen. Select pilot objects with realistic data and permissions.
  3. Portaländerungen immer mit PowerShell oder API-Abfragen gegenprüfen. Always validate portal changes with PowerShell or API queries.
  4. Monitoring, Support-Runbook und Rückfalloptionen vor der Produktion festhalten. Capture monitoring, support runbooks, and rollback options before production rollout.

Betrieb & Hinweise Operations & Notes

PowerShell: Listen und Filter testen PowerShell: create lists and test filters

PowerShell PowerShell
New-AddressList -Name "Finance Users" -RecipientFilter "(RecipientTypeDetails -eq 'UserMailbox') -and (Department -eq 'Finance')"
Get-Recipient -RecipientPreviewFilter "(RecipientTypeDetails -eq 'UserMailbox') -and (Department -eq 'Finance')" -OrganizationalUnit contoso.com
Set-AddressList -Identity "Finance Users" -RecipientFilter "(RecipientTypeDetails -eq 'UserMailbox') -and (Department -eq 'Finance') -and (HiddenFromAddressListsEnabled -eq $false)"

Email Address Policies und SMTP-Generierung Email address policies and SMTP generation

Email Address Policies (EAP) bestimmen, wie Empfänger SMTP-Adressen erhalten. Typische Vorlagen arbeiten mit Variablen wie %g für Vorname, %s für Nachname, %m für Alias, %d für Anzeigename oder Kürzungsformen wie %1g%s. Email address policies (EAPs) determine how recipients receive SMTP addresses. Common templates use variables such as %g for given name, %s for surname, %m for alias, %d for display name, or shortened forms such as %1g%s.

In Multi-Domain- oder Rebranding-Szenarien ist die Policy-Priorität entscheidend. Primäre SMTP-Adressen sollten nur durch klar definierte Policies oder Provisioninglogik gesetzt werden; manuelle Ausnahmen erhöhen die Drift in DirSync- und Hybridumgebungen. In multi-domain or rebranding scenarios, policy priority is critical. Primary SMTP addresses should be set only through clearly defined policies or provisioning logic; manual exceptions increase drift in DirSync and hybrid environments.

SMTP-Vorlagen und Variablen SMTP templates and variables

Variable / Muster Variable / pattern Bedeutung Meaning Beispiel Example
%g %g Vorname Given name alex alex
%s %s Nachname Surname wilber wilber
%1g%s %1g%s Erster Buchstabe des Vornamens plus Nachname. First letter of given name plus surname. awilber awilber
%m %m Alias Alias alex.wilber alex.wilber
SMTP:%m@contoso.com SMTP:%m@contoso.com Primäre Adresse, weil SMTP groß geschrieben ist. Primary address because SMTP is uppercase. SMTP:alex.wilber@contoso.com SMTP:alex.wilber@contoso.com
smtp:%1g%s@brand.contoso.com smtp:%1g%s@brand.contoso.com Sekundäre Proxyadresse, weil smtp klein geschrieben ist. Secondary proxy address because smtp is lowercase. smtp:awilber@brand.contoso.com smtp:awilber@brand.contoso.com

Implementierung Implementation

  1. Bestandsaufnahme, Rollen und Abhängigkeiten für Email Address Policies und SMTP-Generierung dokumentieren. Document the current state, roles, and dependencies for Email address policies and SMTP generation.
  2. Pilotobjekte mit realistischen Daten und Berechtigungen auswählen. Select pilot objects with realistic data and permissions.
  3. Portaländerungen immer mit PowerShell oder API-Abfragen gegenprüfen. Always validate portal changes with PowerShell or API queries.
  4. Monitoring, Support-Runbook und Rückfalloptionen vor der Produktion festhalten. Capture monitoring, support runbooks, and rollback options before production rollout.

Betrieb & Hinweise Operations & Notes

PowerShell: EAP anlegen PowerShell: create EAP

PowerShell PowerShell
New-EmailAddressPolicy -Name "Finance SMTP" `
  -RecipientFilter "(RecipientTypeDetails -eq 'UserMailbox') -and (Department -eq 'Finance')" `
  -EnabledEmailAddressTemplates "SMTP:%m@contoso.com","smtp:%1g%s@finance.contoso.com"
Update-EmailAddressPolicy "Finance SMTP"
Get-EmailAddressPolicy "Finance SMTP" | Format-List Name,Priority,EnabledPrimarySMTPAddressTemplate

OAB, HAB, Sharing Policies, Federation und Beziehungen OAB, HAB, sharing policies, federation, and relationships

Offline Address Books sind für Outlook Cached Mode weiterhin wichtig, auch wenn viele Clients online arbeiten. Hierarchical Address Books verbessern die Navigation in sehr großen Organisationen, indem ein Stammobjekt und Hierarchiebeziehungen zwischen Empfängern genutzt werden. Offline address books remain important for Outlook cached mode even when many clients work online. Hierarchical address books improve navigation in very large organizations by using a root object and hierarchical relationships between recipients.

Sharing Policies, Organization Relationships, Federation Trusts und IntraOrganization Connectors regeln Free/Busy- und Kalenderfreigaben über Tenant- oder Hybridgrenzen hinweg. Diese Konfigurationen müssen zur gewählten Adresssegmentierung passen, damit Benutzer zwar nur die richtige Sicht bekommen, aber weiterhin korrekt teilen können. Sharing policies, organization relationships, federation trusts, and intra-organization connectors govern free/busy and calendar sharing across tenant or hybrid boundaries. These configurations must align with the chosen address segmentation so users keep the right view while still sharing correctly.

Verwandte Komponenten Related components

Komponente Component Zweck Purpose Verwaltung Administration
Offline Address Book Offline address book Stellt Address Lists offline für Outlook bereit. Provides address lists offline for Outlook. New-/Set-/Get-/Remove-OfflineAddressBook, Update-OfflineAddressBook New-/Set-/Get-/Remove-OfflineAddressBook, Update-OfflineAddressBook
Hierarchical Address Book Hierarchical address book Verbessert Adressbuchnavigation per Organisationshierarchie. Improves address-book navigation with organization hierarchy. Set-OrganizationConfig -HierarchicalAddressBookRoot Set-OrganizationConfig -HierarchicalAddressBookRoot
Sharing Policy Sharing policy Steuert Kalender- und Kontaktfreigabe nach außen. Controls external calendar and contact sharing. New-/Set-/Get-/Remove-SharingPolicy New-/Set-/Get-/Remove-SharingPolicy
Organization Relationship Organization relationship Free/Busy und Organisation-zu-Organisation-Sharing. Free/busy and organization-to-organization sharing. New-/Set-/Get-/Remove-OrganizationRelationship New-/Set-/Get-/Remove-OrganizationRelationship
Federation Trust Federation trust Legacy- und Hybrid-Basis für organisationenübergreifende Vertrauensstellung. Legacy and hybrid trust basis for organization-wide sharing. Get-/Set-/Remove-FederationTrust Get-/Set-/Remove-FederationTrust

Implementierung Implementation

  1. Bestandsaufnahme, Rollen und Abhängigkeiten für OAB, HAB, Sharing Policies, Federation und Beziehungen dokumentieren. Document the current state, roles, and dependencies for OAB, HAB, sharing policies, federation, and relationships.
  2. Pilotobjekte mit realistischen Daten und Berechtigungen auswählen. Select pilot objects with realistic data and permissions.
  3. Portaländerungen immer mit PowerShell oder API-Abfragen gegenprüfen. Always validate portal changes with PowerShell or API queries.
  4. Monitoring, Support-Runbook und Rückfalloptionen vor der Produktion festhalten. Capture monitoring, support runbooks, and rollback options before production rollout.

Betrieb & Hinweise Operations & Notes

PowerShell: OAB und Sharing PowerShell: OAB and sharing

PowerShell PowerShell
New-OfflineAddressBook -Name "OAB-Finance" -AddressLists "\Finance Users","\Finance Rooms"
Update-OfflineAddressBook -Identity "OAB-Finance"
Get-SharingPolicy | Format-Table Name,Domains
Get-OrganizationRelationship | Format-List Name,DomainNames,FreeBusyAccessEnabled

Cmdlet-Referenz und Graph-Verfügbarkeit Cmdlet reference and Graph availability

Für ABP, GAL, Address Lists, OAB und EAP existieren in Microsoft Graph keine dedizierten Verwaltungsendpunkte. Graph kann Empfänger, Gruppen oder Places auslesen, aber weder RecipientFilter noch Address Book Policies oder Email Address Policies administrieren. There are no dedicated Microsoft Graph administrative endpoints for ABPs, GALs, address lists, OABs, or EAPs. Graph can read recipients, groups, or places, but it cannot administer recipient filters, address book policies, or email address policies.

Deshalb ist Exchange Online PowerShell das verbindliche Automatisierungswerkzeug. Für Analyse- und App-Szenarien kann Graph ergänzend Verzeichnisobjekte oder Benutzerattribute lesen, wenn diese Daten auch in die Exchange-Segmentierung einfließen. Therefore, Exchange Online PowerShell is the authoritative automation tool. For analytics or app scenarios, Graph can complement by reading directory objects or user attributes when those same fields drive Exchange segmentation.

Zentrale Cmdlets Core cmdlets

Cmdletfamilie Cmdlet family Beispiele Examples Zweck Purpose
ABP ABP New-/Get-/Set-/Remove-AddressBookPolicy New-/Get-/Set-/Remove-AddressBookPolicy Segmentierte Sicht für Benutzer zuweisen. Assign segmented views to users.
GAL GAL New-/Get-/Set-/Remove-GlobalAddressList New-/Get-/Set-/Remove-GlobalAddressList Benutzerdefinierte globale Adresslisten pflegen. Maintain custom global address lists.
Address Lists Address lists New-/Get-/Set-/Remove-AddressList New-/Get-/Set-/Remove-AddressList Spezielle Empfängerlisten auf Basis von RecipientFilter bereitstellen. Provide specific recipient lists based on RecipientFilter.
Email Address Policies Email address policies New-/Get-/Set-/Remove-/Update-EmailAddressPolicy New-/Get-/Set-/Remove-/Update-EmailAddressPolicy SMTP-Generierung und Proxyregeln steuern. Control SMTP generation and proxy rules.
Offline Address Books Offline address books New-/Get-/Set-/Remove-/Update-OfflineAddressBook New-/Get-/Set-/Remove-/Update-OfflineAddressBook Offlineverteilung für Outlook Cached Mode steuern. Control offline distribution for Outlook cached mode.
Sharing / Federation Sharing / federation Get-/Set-/New-/Remove-SharingPolicy, OrganizationRelationship, FederationTrust Get-/Set-/New-/Remove-SharingPolicy, OrganizationRelationship, FederationTrust Cross-Org-Sharing und Free/Busy konfigurieren. Configure cross-org sharing and free/busy.

Implementierung Implementation

  1. Bestandsaufnahme, Rollen und Abhängigkeiten für Cmdlet-Referenz und Graph-Verfügbarkeit dokumentieren. Document the current state, roles, and dependencies for Cmdlet reference and Graph availability.
  2. Pilotobjekte mit realistischen Daten und Berechtigungen auswählen. Select pilot objects with realistic data and permissions.
  3. Portaländerungen immer mit PowerShell oder API-Abfragen gegenprüfen. Always validate portal changes with PowerShell or API queries.
  4. Monitoring, Support-Runbook und Rückfalloptionen vor der Produktion festhalten. Capture monitoring, support runbooks, and rollback options before production rollout.

Betrieb & Hinweise Operations & Notes

Graph: Empfänger flankierend lesen Graph: read recipients as an adjacent source

HTTP HTTP
GET https://graph.microsoft.com/v1.0/users?$select=id,displayName,mail,department,companyName,officeLocation
GET https://graph.microsoft.com/v1.0/groups?$select=id,displayName,mailEnabled,securityEnabled

PowerShell: Referenz und Prüfung PowerShell: reference and validation

PowerShell PowerShell
Get-Command *AddressBookPolicy* | Select-Object Name
Get-Command *GlobalAddressList* | Select-Object Name
Get-Command *EmailAddressPolicy* | Select-Object Name

Troubleshooting und Best Practices Troubleshooting and best practices

Wenn Benutzer Empfänger nicht sehen oder falsche Adressen erhalten, prüfen Sie zuerst RecipientFilter, HiddenFromAddressListsEnabled, Synchronisationsquelle und Policy-Priorität. In Hybridumgebungen ist zusätzlich zu klären, ob das maßgebliche Attribut aus on-premises oder cloudseitigem Provisioning stammt. When users cannot see recipients or receive wrong addresses, first check RecipientFilter, HiddenFromAddressListsEnabled, the synchronization source, and policy priority. In hybrid environments, also determine whether the governing attribute comes from on-premises or cloud-side provisioning.

Bewährte Praxis ist ein kleines, stabiles Attributmodell: zum Beispiel Company für rechtliche Einheit, Department für Fachbereich und ein einzelnes CustomAttribute für Segmentierung. Kombiniert mit dokumentierten Policies, Testpostfächern und Change-Fenstern bleibt die Adresspolitik beherrschbar. Best practice is a small, stable attribute model: for example Company for legal entity, Department for business unit, and one custom attribute for segmentation. Combined with documented policies, test mailboxes, and change windows, address policy remains manageable.

Typische Störungen Typical issues

Symptom Symptom Ursache Cause Lösung Resolution
Benutzer sieht falsche GAL User sees wrong GAL ABP nicht zugewiesen oder OAB passt nicht zur GAL. ABP not assigned or OAB does not match the GAL. Set-Mailbox -AddressBookPolicy prüfen und Outlook-OAB-Download erneuern. Check Set-Mailbox -AddressBookPolicy and refresh the Outlook OAB download.
SMTP-Adresse wurde nicht aktualisiert SMTP address did not update Email Address Policy hat falsche Priorität oder manuelle Ausnahme blockiert Anwendung. Email address policy has wrong priority or a manual exception blocks application. Policy priorisieren, Update-EmailAddressPolicy ausführen und DirSync-Quelle prüfen. Adjust priority, run Update-EmailAddressPolicy, and review the DirSync source.
Room Finder zeigt falsche Räume Room Finder shows wrong rooms Room List oder Address List passt nicht zur Segmentierung. Room list or address list does not align with segmentation. Room Lists pro Segment aufbauen und ABP-Zuordnung validieren. Build room lists per segment and validate ABP assignment.
ABP trennt Kommunikation nicht ABP does not isolate communication ABP ist Sichtbarkeits- und keine Sicherheitsfunktion. ABP is a visibility feature, not a security feature. Information Barriers, Transportregeln oder getrennte Tenants einplanen. Use information barriers, transport rules, or separate tenants.

Implementierung Implementation

  1. Bestandsaufnahme, Rollen und Abhängigkeiten für Troubleshooting und Best Practices dokumentieren. Document the current state, roles, and dependencies for Troubleshooting and best practices.
  2. Pilotobjekte mit realistischen Daten und Berechtigungen auswählen. Select pilot objects with realistic data and permissions.
  3. Portaländerungen immer mit PowerShell oder API-Abfragen gegenprüfen. Always validate portal changes with PowerShell or API queries.
  4. Monitoring, Support-Runbook und Rückfalloptionen vor der Produktion festhalten. Capture monitoring, support runbooks, and rollback options before production rollout.

Betrieb & Hinweise Operations & Notes

PowerShell: Schneller Gesundheitscheck PowerShell: quick health check

PowerShell PowerShell
Get-Mailbox user@contoso.com | Format-List AddressBookPolicy,EmailAddresses,HiddenFromAddressListsEnabled
Get-AddressBookPolicy "ABP-Finance" | Format-List GlobalAddressList,OfflineAddressBook,RoomList,AddressLists
Get-Recipient -RecipientPreviewFilter "(Department -eq 'Finance')" | Select-Object Name,PrimarySmtpAddress,Department
🔗 Verwandte Referenzen Related references

Diese Seite ergänzt Ressourcen-, Teams- und SharePoint-Dokumentation, wenn Sichtbarkeit, Empfängerpflege und Standortdaten zusammenspielen. This page complements resource, Teams, and SharePoint documentation when visibility, recipient management, and location data interact.