Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Descubra como controlar o acesso ao EWS para usuários, aplicativos ou toda a organização.
Se você estiver usando a API Gerenciada do EWS ou o EWS diretamente em seu aplicativo, poderá controlar o acesso aos Serviços Web do Exchange (EWS). Se você tiver acesso de administrador ao seu servidor Exchange, poderá gerenciar o acesso ao EWS usando o Shell de Gerenciamento do Exchange para controlar o acesso globalmente, para cada usuário e para cada aplicativo. Para obter mais informações, consulte Conectar-se a servidores Exchange usando o PowerShell remoto.
Cmdlets do Shell de Gerenciamento do Exchange para configurar o controle de acesso
Você pode usar os seguintes cmdlets do Shell de Gerenciamento do Exchange para exibir a configuração de acesso atual e definir controles de acesso do EWS:
- Get-CASMailbox - Mostra quais parâmetros estão definidos para uma caixa de correio específica.
- Set-CASMailbox - Define parâmetros para uma caixa de correio específica.
- Get-OrganizationConfig - Mostra os parâmetros para toda a organização.
- Set-OrganizationConfig - Define os parâmetros para toda a organização.
Observação
A maneira como o parâmetro EWSEnabled opera será alterada em outubro de 2026 devido à substituição do EWS. Para obter mais informações, consulte Exchange Online EWS, Seu tempo está quase acabando.
Exemplos: controlando o acesso ao EWS
Vamos dar uma olhada em alguns cenários que mostram como você pode controlar o acesso ao seu aplicativo.
Tabela 1. Comandos para controlar o acesso ao EWS
| Se você desejar | Usar este comando |
|---|---|
| Impedir que todos os aplicativos cliente usem o EWS. | Set-OrganizationConfig -EwsApplicationAccessPolicy:EnforceAllowListIsso permite que os aplicativos listados na Lista de Permissões se conectem. Neste exemplo, nenhum aplicativo está incluído na AllowList, portanto, nenhum aplicativo pode usar o EWS. |
| Permitir que uma lista de aplicativos cliente use o EWS (com base no agente do usuário). | Set-OrganizationConfig -EwsApplicationAccessPolicy:EnforceAllowList -EwsAllowList:"OWA/*"Isso permite que aplicativos específicos usem o EWS. Neste exemplo, qualquer aplicativo que tenha uma cadeia de caracteres de agente do usuário que comece com "OWA/" tem permissão de acesso. |
| Permitir que uma lista de aplicativos cliente use o EWS (com base na ID do aplicativo). | Set-OrganizationConfig -EwsAllowedAppIDs "11111111-2222-3333-4444-555555555555,aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"Quando EWSEnabled é definido como True, somente as IDs de aplicativo nesta lista podem usar o EWS. |
| Permitir que todos os aplicativos cliente usem o EWS, exceto aqueles especificamente bloqueados (com base no agente do usuário). | Set-OrganizationConfig -EwsApplicationAccessPolicy:EnforceBlockList -EwsBlockList:"OWA/*"Este exemplo apenas impede que aplicativos usem EWS que têm uma cadeia de caracteres de agente do usuário que começa com "OWA/". |
| Permitir que todos os aplicativos cliente usem o EWS. | Set-OrganizationConfig -EwsApplicationAccessPolicy:EnforceBlockList Como nenhuma BlockList foi especificada, todos os aplicativos podem usar o EWS, a menos que sejam bloqueados pela ID do aplicativo. |
| Impedir que toda a organização use o EWS. | Set-OrganizationConfig -EwsEnabled:$false Importante: Desabilitar o EWS na organização também desabilita as substituições do EWS por usuário. |
| Permitir que toda a organização use o EWS. | Set-OrganizationConfig -EwsEnabled:$true Importante: O valor padrão Null é tratado como EwsEnabled definido como True. |
| Impedir que uma caixa de correio individual use o EWS. | Set-CASMailbox -Identity adam@contoso.com -EwsEnabled:$false |
| Permitir que uma caixa de correio individual use o EWS. | Set-CASMailbox -Identity adam@contoso.com -EwsEnabled:$true |