Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Nota
Le funzionalità descritte in questo articolo sono attualmente disponibili in anteprima, non sono disponibili in tutte le organizzazioni e sono soggette a modifiche.
L'API Exchange Online Amministrazione è una superficie amministrativa basata su REST che consente un set mirato di cmdlet e parametri di Exchange come endpoint solo POST. L'API consente l'accesso ad alcune attività chiave disponibili in precedenza tramite Exchange Web Services (EWS), che è prevista per la deprecazione nell'ottobre 2026. L'API è creata per questi scenari specifici e non sostituisce l'area di amministrazione completa di Exchange in Exchange Online PowerShell.
L'API Exchange Online Amministrazione supporta il subset seguente di funzioni di gestione di Exchange:
- Visualizzare la configurazione di Exchange dell'organizzazione: recuperare le impostazioni dell'organizzazione, ad esempio i domini accettati, la configurazione dei suggerimenti messaggio e i limiti delle cassette postali, ad esempio MaxSendSize.
- Visualizzare l'appartenenza al gruppo di distribuzione e al gruppo di distribuzione dinamico.
- Visualizzare e gestire le autorizzazioni per le cartelle delle cassette postali: leggere e modificare le autorizzazioni di cartella per le cassette postali (visualizzare, aggiungere, impostare e rimuovere le autorizzazioni).
- Visualizzare e aggiornare Send on Behalf (delega) per le cassette postali.
Le organizzazioni che eseguino la migrazione da EWS possono usare l'API Amministrazione per ottenere un'amministrazione simile in stile cmdlet tramite HTTP, integrando al tempo stesso modelli moderni di automazione e governance.
L'API Exchange Online Amministrazione presenta le funzionalità seguenti:
- Superficie basata su REST in stile cmdlet: l'API Amministrazione espone un set mirato di attività amministrative di Exchange come endpoint HTTP. Dovrebbe essere familiare agli amministratori di Exchange che usano i cmdlet di PowerShell, ma lo si chiama tramite HTTP.
- Operazioni solo POST: ogni operazione usa il metodo HTTP POST. Ogni richiesta specifica un cmdlet e i parametri supportati per tale cmdlet nell'endpoint selezionato.
- Set di cmdlet e parametri con ambito: l'API non visualizza tutti i cmdlet o i parametri di Exchange. Ogni endpoint espone solo un subset di cmdlet e ogni cmdlet supporta un subset di parametri.
- Ambito incentrato: l'API copre un set limitato di scenari: impostazioni dell'organizzazione, appartenenza a gruppi, autorizzazioni per le cartelle delle cassette postali e delega delle cassette postali. Non è un sostituto completo per Exchange Online PowerShell. Si tratta invece di una superficie REST complementare per queste attività specifiche.
- Paging e selezione delle proprietà: i set di risultati di grandi dimensioni vengono restituiti in pagine. Sul lato client, è possibile richiedere solo le proprietà necessarie per ridurre le dimensioni del payload.
- Hint di routing: per tutte le operazioni, l'API usa l'intestazione X-AnchorMailbox per instradare la richiesta al server back-end corretto. Per altre informazioni, vedere Introduzione all'API Exchange Online.
- Accesso sicuro: le chiamate richiedono token OAuth e ruoli del controllo degli accessi in base al ruolo di Exchange appropriati. Per altre informazioni, vedere Autenticazione e autorizzazione per l'API Exchange Online Amministrazione.
Amministrazione API e Exchange Online PowerShell
L'API Amministrazione fornisce un subset mirato delle funzionalità di gestione di Exchange come endpoint REST per coprire gli scenari interessati dalla deprecazione di EWS. Exchange Online PowerShell continua a fornire l'area di gestione completa di Exchange.
- Amministrazione API: usare quando è necessaria una superficie equivalente a rest-first e cmdlet solo per gli scenari descritti in precedenza (configurazione dell'organizzazione, appartenenza a gruppi, autorizzazioni per cartelle e delega).
- Exchange Online PowerShell: usare quando è necessaria l'intera gamma di cmdlet di Exchange, operazioni avanzate o script e runbook di PowerShell esistenti.
L'API Exchange Online Amministrazione non sostituisce Exchange Online PowerShell. L'API è una superficie complementare basata su REST per un set mirato di attività amministrative causate dagli scenari EWS deprecati. Per tutte le altre attività di gestione di Exchange, continuare a usare Exchange Online PowerShell.
endpoint API Exchange Online Amministrazione
Ogni endpoint API Amministrazione fornisce uno o più cmdlet per sostituire le funzionalità disponibili in precedenza tramite EWS. La tabella seguente fornisce informazioni dettagliate su ogni endpoint e sull'alternativa EWS corrispondente.
| Endpoint | Descrizione | Operazione EWS |
|---|---|---|
| OrganizationConfig | Recuperare la configurazione di Exchange a livello di organizzazione, correlata alle impostazioni dei suggerimenti messaggio. | GetServiceConfiguration |
| AcceptedDomain | Visualizzare i domini accettati e le relative configurazioni per l'organizzazione. | GetServiceConfiguration |
| Cassetta postale | Visualizzare le proprietà della cassetta postale. Ad esempio: nome visualizzato, indirizzo SMTP primario, limiti di dimensioni e informazioni sui delegati (visualizzazione e aggiornamento). | AddDelegate e RemoveDelegate |
| MailboxFolderPermission | Visualizzare e gestire le autorizzazioni per le cartelle delle cassette postali (autorizzazioni di aggiunta, impostazione e rimozione). | GetFolder, UpdateFolder e CreateFolder |
| DistributionGroupMember | Recuperare i dettagli di appartenenza per i gruppi di distribuzione. | ExpandDL |
| DynamicDistributionGroupMember | Recuperare i dettagli di appartenenza per i gruppi di distribuzione dinamici. | ExpandDL |