Jak zarządzać kontami użytkowników za pomocą interfejsu API administracji Exchange Online

By Mirko Peters · 2026-03-09 · Updated 2026-03-24

Poznaj interfejs API administracji Exchange Online, oparty na REST alternatywę dla Exchange Web Services (EWS). Skutecznie zarządzaj kontami użytkowników Exchange Online.

Automatically translated with AI from the original post. Read the English original

Zarządzanie kontami użytkowników jest kluczowe dla każdej organizacji. Gwarantuje, że pracownicy mają odpowiedni dostęp do zasobów, a jednocześnie poufne informacje pozostają bezpieczne. Interfejs API administracji Exchange ułatwia i usprawnia ten proces. Dzięki jego zaawansowanym funkcjom możesz szybko tworzyć, aktualizować lub usuwać konta użytkowników. Ponadto pozwala skutecznie zarządzać skrzynkami pocztowymi. Ten interfejs API usprawnia pracę i oszczędza czas, dzięki czemu możesz skupić się na tym, co naprawdę ważne — na Twoim zespole.

Najważniejsze wnioski

• Interfejs API administracji Exchange upraszcza zarządzanie kontami użytkowników, umożliwiając sprawne tworzenie, aktualizowanie i usuwanie kont.

• Użyj protokołu OAuth 2.0 do bezpiecznego uwierzytelniania w interfejsie API. Chroni on poświadczenia użytkowników, korzystając z tokenów dostępu zamiast haseł.

• Zawsze zabezpieczaj tokeny dostępu, aby zapobiec nieautoryzowanemu dostępowi i potencjalnym naruszeniom danych.

• Wdróż strategie obsługi błędów, aby skutecznie radzić sobie z typowymi problemami, takimi jak nieautoryzowany dostęp lub nieprawidłowe żądania.

• Pamiętaj o limitach żądań podczas korzystania z interfejsu API. Monitoruj wykorzystanie i rozważ grupowanie żądań, aby pozostać w granicach limitów.

7 zaskakujących faktów o interfejsie API administracji Exchange

Jeśli zarządzasz usługą Exchange Online, interfejs API administracji Exchange może zmienić sposób, w jaki automatyzujesz, zabezpieczasz i monitorujesz swoje środowisko. Oto siedem zaskakujących faktów na jego temat.

1. Udostępnia zarządzanie skrzynkami pocztowymi wykraczające poza interfejs Graph API. Choć Microsoft Graph obejmuje wiele scenariuszy dotyczących użytkowników i skrzynek pocztowych, interfejs Exchange Admin API udostępnia wyspecjalizowane punkty końcowe do konfiguracji i zarządzania specyficznego dla Exchange, niedostępne w Graph, dzięki czemu jest pierwszym wyborem przy zaawansowanej automatyzacji Exchange Online.
2. Wymagane są szczegółowe uprawnienia RBAC i zgoda administratora. Interfejs API wymusza kontrolę dostępu opartą na rolach, specyficzną dla Exchange, i często wymaga jawnej zgody administratora na wrażliwe operacje, dlatego przy bezpiecznej automatyzacji niezbędne jest przydzielanie minimalnych uprawnień oraz dedykowanych jednostek usługi.
3. Obsługuje operacje wsadowe i masowe na dużą skalę. Interfejs Exchange Admin API umożliwia wzorce zarządzania wsadowego i masowego (na przykład aktualizację zasad dla wielu skrzynek pocztowych), co znacznie ogranicza liczbę wywołań i upraszcza zarządzanie dzierżawą na dużą skalę.
4. Stosuje ograniczenia przepustowości na poziomie dzierżawy, różniące się od Graph. Reguły ograniczania przepustowości i limity żądań różnią się od Microsoft Graph; trzeba zaprojektować logikę ponawiania i wycofywania specjalnie dla zachowania interfejsu Exchange Admin API, aby uniknąć nieoczekiwanych błędów przy dużym obciążeniu.
5. Umożliwia zaawansowane mechanizmy zgodności i audytu. Interfejs API udostępnia funkcje zgodności specyficzne dla Exchange — takie jak reguły przepływu poczty, przypisania zasad przechowywania i konfiguracje audytu — co pozwala na programowe egzekwowanie zasad organizacji na dużą skalę.
6. Integruje się z hybrydowymi konfiguracjami Exchange. Organizacje działające w trybie hybrydowym mogą używać interfejsu Exchange Admin API razem z lokalnymi narzędziami do zarządzania, aby koordynować ustawienia i zasady, co ułatwia migrację i scenariusze współistnienia.
7. Można go rozszerzyć o PowerShell i nowoczesne przepływy uwierzytelniania. Możesz łączyć moduły PowerShell dla Exchange Online z interfejsem Exchange Admin API, korzystając z uwierzytelniania OAuth 2.0 w trybie tylko aplikacji lub przepływów delegowanych, co umożliwia nowoczesną, bezpieczną automatyzację, zachowując przy tym w razie potrzeby dotychczasowe możliwości PowerShell.

Używaj interfejsu Exchange Admin API jako uzupełnienia Microsoft Graph i PowerShell, aby zapewnić solidne, skalowalne i bezpieczne zarządzanie Exchange Online.

Metody uwierzytelniania

Przegląd protokołu OAuth 2.0

Podczas pracy z Exchange Admin API zrozumienie protokołu OAuth 2.0 jest niezbędne. Ten mechanizm zwiększa bezpieczeństwo, pozwalając aplikacjom na dostęp do zasobów bez ujawniania danych uwierzytelniających użytkownika. Zamiast udostępniać hasła, używasz tokenów dostępu, co znacząco ogranicza ryzyko nieautoryzowanego dostępu. Oto kilka kluczowych cech OAuth 2.0, które czynią go solidnym wyborem do uwierzytelniania w interfejsach API:

Uzyskiwanie tokenów dostępu

Aby współpracować z Exchange Admin API, musisz uzyskać tokeny dostępu. Poniżej znajduje się prosty przewodnik krok po kroku, który przeprowadzi Cię przez ten proces:

1. Zarejestruj aplikację w Microsoft Entra ID.

2. Przypisz wymagane uprawnienia do interfejsu API.

3. Przypisz uprawnienia RBAC.

4. Uzyskaj token dostępu.

Zabezpieczenie tokenów dostępu ma kluczowe znaczenie. Jeśli tokeny nie są chronione, mogą prowadzić do poważnych zagrożeń bezpieczeństwa. Oto kilka potencjalnych zagrożeń związanych z niezabezpieczonymi tokenami dostępu:

• Interfejsy API mogą ujawniać wrażliwe dane, jeśli nie są odpowiednio zabezpieczone.

• Niezabezpieczone tokeny dostępu mogą prowadzić do nieautoryzowanego dostępu i manipulacji danymi.

• Wzrost liczby ataków na interfejsy API podkreśla potrzebę stosowania solidnych zabezpieczeń.

Ponadto, jeśli ktoś podszyje się pod administratora globalnego, może uzyskać pełną kontrolę nad Twoją dzierżawą, w tym dostęp do usług takich jak SharePoint Online i Exchange Online. Może to prowadzić do poważnych wycieków danych.

Aby przypisać role RBAC programu Exchange Online do aplikacji na potrzeby dostępu do interfejsu API, wykonaj następujące kroki:

1. W scenariuszach delegowanych upewnij się, że użytkownik ma przypisane niezbędne role RBAC w programie Exchange Online, na przykład Zarządzanie odbiorcami lub Zarządzanie organizacją.

2. W scenariuszach działających wyłącznie w tle (app-only) przypisz role Microsoft Entra lub niestandardowe grupy ról RBAC programu Exchange do jednostki usługi (service principal) reprezentującej Twoją aplikację.

3. Użyj odpowiedniego przepływu tokenów dostępu OAuth 2.0 dla typu aplikacji, czyli delegowanego lub działającego w tle.

4. Zainstaluj program Exchange Online PowerShell i połącz się z nim.

5. Utwórz nową jednostkę usługi i przypisz wymagane role.

6. Zweryfikuj przypisanie ról i przetestuj RBAC dla aplikacji.

Stosując się do tych wytycznych, możesz skutecznie zarządzać kontami użytkowników, a jednocześnie zachować bezpieczeństwo interakcji z interfejsami API.

Zarządzanie kontami użytkowników za pomocą Exchange Admin API

Tworzenie kont użytkowników

Tworzenie kont użytkowników za pomocą Exchange Admin API jest proste. Musisz podać określone pola, aby skonfigurować nowego użytkownika. Oto krótka lista wymaganych parametrów:

• Alias: nazwa użytkownika dla konta.

• Name: pełna nazwa użytkownika.

• FirstName: imię użytkownika.

• LastName: nazwisko użytkownika.

• DisplayName: sposób, w jaki nazwa użytkownika jest wyświetlana w katalogu.

• MicrosoftOnlineServicesID: adres e-mail powiązany z kontem.

• Password: należy wymusić wprowadzenie tej wartości.

• ResetPasswordOnNextLogon: parametr opcjonalny, który można ustawić na true, jeśli użytkownik ma zmienić hasło przy pierwszym logowaniu.

Oto prosty przykład tego, jak możesz utworzyć konto użytkownika za pomocą PowerShell:

New-MgUser -AccountEnabled $true -DisplayName "Holly Holt" -MailNickname "hollyh" -UserPrincipalName "hollyh@corp.contoso.com" -PasswordProfile @{ForceChangePasswordNextSignIn=$true; Password="YourSecurePassword"}

Aktualizowanie informacji o użytkownikach

Aktualizowanie informacji o użytkownikach jest równie proste. Za pomocą Exchange Admin API możesz modyfikować różne atrybuty konta użytkownika. Oto kilka typowych atrybutów, które możesz chcieć zaktualizować:

Aby zaktualizować użytkownika, możesz użyć polecenia w tej postaci:

Update-MgUser -UserId "<userId>" -DisplayName "Holly Holt Updated"

To polecenie aktualizuje nazwę wyświetlaną użytkownika o podanym identyfikatorze.

Usuwanie kont użytkowników

Usuwając konta użytkowników, musisz wykonać kilka kroków, aby wszystko przebiegło sprawnie. Oto krótki przewodnik:

1. Połącz się z dzierżawą Microsoft 365 za pomocą programu PowerShell, z wymaganymi uprawnieniami.

2. Użyj polecenia Connect-MgGraph -Scopes User.Read.All, User.ReadWrite.All, aby nawiązać połączenie.

3. Pobierz identyfikator użytkownika, filtrując według nazwy wyświetlanej za pomocą Get-MgUser -Filter "displayName eq '<display name>'".

4. Usuń konto użytkownika poleceniem Remove-MgUser -UserId <userId> -Confirm:$false.

Ten proces pozwala sprawnie zarządzać kontami użytkowników, dbając o bezpieczeństwo i porządek w organizacji.

Pobieranie skrzynek pocztowych dla skutecznego zarządzania

Pobieranie skrzynek pocztowych ma kluczowe znaczenie dla skutecznego zarządzania kontami użytkowników. Oto kilka sprawdzonych praktyk, o których warto pamiętać:

• Zawsze używaj metody POST we wszystkich operacjach, w tym w poleceniach Get-*.

• W punkcie końcowym uwzględniaj wyłącznie parametry obsługiwane przez dane polecenie cmdlet.

• Używaj X-AnchorMailbox we wszystkich operacjach, aby żądania były prawidłowo kierowane.

• Używaj $select, aby zmniejszyć rozmiar odpowiedzi, zwłaszcza przy dużych zbiorach danych.

• Łącz $select ze stronicowaniem, aby efektywnie zarządzać obszernymi danymi.

Stosując te wytyczne, usprawnisz zarządzanie skrzynkami pocztowymi i zadbasz o to, by konta użytkowników były zawsze aktualne.

Najlepsze praktyki dla interfejsu Exchange Admin API

Obsługa błędów

Pracując z interfejsem Exchange Admin API, możesz napotkać błędy. Umiejętność ich skutecznej obsługi pozwoli zaoszczędzić czas i nerwy. Oto poręczna tabela zawierająca typowe kody błędów, ich przyczyny i sugerowane rozwiązania:

Stosując te strategie, zminimalizujesz zakłócenia i zapewnisz sprawne działanie operacji.

Uwzględnianie limitów przepustowości

Ograniczanie liczby żądań (rate limiting) to kolejny istotny aspekt korzystania z interfejsu Exchange Admin API. Pomaga utrzymać wydajność API i zapewnia sprawiedliwe wykorzystanie zasobów przez wszystkich użytkowników. Oto kilka wskazówek, o których warto pamiętać:

• Poznaj limity: Zapoznaj się z limitami żądań nałożonymi przez API. Ta wiedza pomoże Ci odpowiednio planować żądania.

• Stosuj strategie wycofywania: Gdy osiągniesz limit żądań, zastosuj strategię wycofywania. Oznacza to odczekanie chwili przed ponowieniem żądania. Pozwoli to uniknąć blokady.

• Monitoruj wykorzystanie: Kontroluj wykorzystanie interfejsu API. Narzędzia do monitorowania pomogą śledzić, ile żądań wysyłasz i kiedy zbliżasz się do limitów.

• Grupuj żądania: Jeśli to możliwe, łącz żądania w pakiety (wsadowo). Takie podejście może zmniejszyć liczbę wywołań i pomóc Ci mieścić się w limitach.

Dbając o ograniczanie liczby żądań (rate limiting), zapewnisz, że interakcje z Exchange Admin API pozostaną wydajne i skuteczne.

Podsumowując, Exchange Admin API to potężne narzędzie do skutecznego zarządzania kontami użytkowników. Możesz z łatwością tworzyć, aktualizować i usuwać konta, dzięki czemu organizacja będzie sprawnie funkcjonować. Pamiętaj, że zabezpieczenie tokenów dostępu oraz zrozumienie obsługi błędów są kluczowe dla bezproblemowej pracy.

Aby lepiej poznać Exchange Admin API, warto zajrzeć do poniższych zasobów:

• Ten artykuł przeprowadzi Cię przez wykonanie pierwszego poprawnego wywołania Exchange Online Admin API i wyjaśnia kluczowe zachowania oraz wzorce obowiązujące we wszystkich punktach końcowych.

Nie wahaj się więc! Poznaj API i zobacz, jak może usprawnić procesy zarządzania użytkownikami. Miłego kodowania! 🚀

Często zadawane pytania

Czym jest Exchange Admin API?

Exchange Admin API umożliwia zarządzanie kontami użytkowników i skrzynkami pocztowymi w usłudze Microsoft Exchange Online. Upraszcza zadania, takie jak tworzenie, aktualizowanie i usuwanie kont użytkowników, dzięki czemu administrowanie staje się bardziej efektywne.

Jak uwierzytelnić się w Exchange Admin API?

Uwierzytelnianie odbywa się przy użyciu protokołu OAuth 2.0. Zarejestruj aplikację w Microsoft Entra ID, przypisz uprawnienia i uzyskaj token dostępu, aby bezpiecznie komunikować się z interfejsem API.

Czy mogę zautomatyzować zarządzanie kontami użytkowników?

Tak! Możesz zautomatyzować zarządzanie kontami użytkowników, korzystając ze skryptów w PowerShell lub w innych językach programowania. Oszczędza to czas i ogranicza błędy popełniane ręcznie podczas administrowania użytkownikami.

Co zrobić, gdy napotkam błąd?

Sprawdź kod błędu i zapoznaj się z dokumentacją, aby poznać kroki rozwiązywania problemów. Do typowych problemów należą nieprawidłowe tokeny lub brakujące uprawnienia. Odpowiednio dostosuj żądania.

Jak monitorować wykorzystanie interfejsu API?

Wykorzystanie interfejsu API możesz monitorować, dodając logowanie do swojej aplikacji. Śledź liczbę wysyłanych żądań i zwracaj uwagę na ostrzeżenia o limitach, aby uniknąć zakłóceń.

Czym jest Exchange Admin API i jaki ma związek z Exchange Online?

Exchange Admin API to nowe, oparte na REST, administracyjne interfejs API udostępnione przez firmę Microsoft, które umożliwia wykonywanie zadań administracyjnych usługi Exchange w usługach Exchange Online i Office 365 Exchange Online. Jest to podejście oparte na REST, zaprojektowane tak, aby pomóc organizacjom unowocześnić automatyzację. Punkty końcowe API obejmują ograniczony zestaw poleceń cmdlet i parametrów Exchange dla typowych scenariuszy zarządzania, które wcześniej realizowano za pomocą EWS lub Exchange Online PowerShell.

Czy Exchange Admin API zastępuje Exchange Web Services (EWS)?

Nowe API nie jest bezpośrednim, jeden do jednego, zamiennikiem dla wszystkich scenariuszy EWS, ale ma pomóc organizacjom stopniowo odchodzić od EWS. Microsoft ogłosił harmonogramy wycofywania oraz wskazówki, m.in. wycofanie niektórych scenariuszy EWS w październiku 2026 r. Publiczna wersja zapoznawcza Admin API oraz interfejsy API w publicznej wersji zapoznawczej zapewniają alternatywy REST dla wielu scenariuszy administracyjnych Exchange i modernizują automatyzację.

Jakie zadania administracyjne obsługują punkty końcowe Admin API?

API obsługuje ograniczony zestaw zadań administracyjnych usługi Exchange Online, skupiony na zarządzaniu, m.in. akceptowanymi domenami, uprawnieniami do folderów skrzynek pocztowych, przypisywaniem delegatów i uprawnień oraz innymi zadaniami administracyjnymi Exchange. Admin API to oparte na REST narzędzie administracyjne, zaprojektowane do obsługi typowych scenariuszy Exchange oraz automatyzacji opartej na REST, działającej równolegle z poleceniami cmdlet i skryptami PowerShell.

Jak to wpływa na administratorów Office 365 i Office 365 Exchange Online?

Dla administratorów Office 365 i Office 365 Exchange Online publiczna wersja zapoznawcza daje możliwość modernizacji z wykorzystaniem REST API i ograniczenia zależności od kodu EWS oraz poleceń cmdlet Exchange. Administratorzy mogą korzystać z punktów końcowych Admin API lub nadal używać Exchange Online PowerShell, w miarę jak Microsoft rozszerza możliwości publicznej wersji zapoznawczej Admin API. Pomaga to organizacjom odchodzić od EWS i wdrażać nowoczesną automatyzację, która integruje się z procesami zarządzania w Microsoft 365.

Co z Exchange Online PowerShell i istniejącymi cmdletami PowerShell – czy zostaną usunięte?

Exchange Online PowerShell i cmdlety PowerShell pozostają obsługiwaną opcją dla wielu zadań. Admin API ma uzupełniać cmdlety i parametry Exchange, oferując alternatywę opartą na REST dla wybranych scenariuszy administracyjnych Exchange. Microsoft udostępnił podgląd Admin API oraz wskazówki dotyczące korzystania zarówno ze skryptów PowerShell, jak i z Admin API. Niektóre scenariusze będą nadal wymagały Exchange Online PowerShell, dopóki endpointy Admin API nie obejmą szerszego zakresu funkcji Exchange.

Kiedy EWS zostanie wycofany i co organizacje powinny zrobić przed październikiem 2026 roku?

Microsoft zapowiedział wycofanie (deprecation) w październiku 2026 roku niektórych zastosowań EWS i zachęcił organizacje do planowania odejścia od EWS w wybranych scenariuszach administracyjnych Exchange. Administratorzy powinni zinwentaryzować kod EWS, zastosowania EWS w administracji Exchange oraz wszystkie scenariusze EWS w swoim środowisku, a następnie ocenić publiczny podgląd Admin API, alternatywy oparte na REST API oraz Exchange Online PowerShell, aby zmodernizować automatyzację przed wycofaniem w październiku 2026 roku.

Czy Admin API może zarządzać uprawnieniami do skrzynek, takimi jak mailboxfolderpermission i delegaci?

Tak, Admin API obsługuje zarządzanie mailboxfolderpermission oraz przypisaniami delegatów w wielu scenariuszach, udostępniając endpointy, które pozwalają administratorom ustawiać lub modyfikować delegowanie i uprawnienia. Choć Admin API może początkowo oferować ograniczony zestaw funkcji, zaprojektowano go tak, aby pomagał organizacjom automatyzować te konkretne zadania administracyjne Exchange bez polegania wyłącznie na kodzie EWS lub cmdletach Exchange.

Jak uzyskać dostęp do Admin API w publicznym podglądzie i jakie uwierzytelnianie jest wymagane?

Admin API jest dostępne w publicznym podglądzie i wymaga nowoczesnego uwierzytelniania za pośrednictwem platformy tożsamości Microsoft (Azure AD/Entra). Administratorzy rejestrują aplikację, przyznają odpowiednie zakresy (scopes) dostępu do Exchange Online API i wywołują endpointy Admin API oparte na REST, aby wykonywać zarządzanie Exchange. Takie podejście umożliwia integrację z istniejącą automatyzacją, skryptami i ramami zarządzania Microsoft 365.

Czy Admin API ma jakieś ograniczenia w trakcie publicznego podglądu?

Podczas publicznego podglądu Admin API interfejs może oferować ograniczony zestaw możliwości w porównaniu z pełnym zestawem cmdletów Exchange lub EWS. Podgląd koncentruje się na wybranych zadaniach administracyjnych Exchange oraz podzbiorze funkcji Exchange. Organizacje powinny weryfikować scenariusze administracyjne i modernizować automatyzację, łącząc endpointy Admin API z Exchange Online PowerShell tam, gdzie to konieczne, dopóki API nie obsłuży bardziej rozbudowanych zadań zarządzania Exchange.

Jak organizacje powinny zaplanować strategię migracji z EWS do nowego opartego na REST Admin API?

Organizacje powinny przeanalizować obciążenia Exchange, które opierają się na EWS, zidentyfikować konkretne scenariusze administracyjne Exchange oraz scenariusze EWS związane z tymi potrzebami, a następnie nadać priorytet migracji kluczowej automatyzacji o dużym wpływie do Admin API lub Exchange Online PowerShell. Wykorzystaj publiczny podgląd Admin API do testowania scenariuszy administracyjnych i modernizacji automatyzacji, zaktualizuj skrypty PowerShell oraz kod EWS tam, gdzie to właściwe, i śledź wytyczne Microsoft dotyczące wycofania i przyszłej dostępności aż do października 2026 roku i później.