Sobre o módulo do PowerShell do Exchange Online

O módulo do PowerShell do Exchange Online (também conhecido como módulo do PowerShell V3 do Exchange Online ou módulo EXO V3 desde 2022) usa autenticação moderna e funciona com ou sem MFA (autenticação multifator) para se conectar a todos os ambientes do PowerShell relacionados à nuvem do Exchange: Exchange Online PowerShell, PowerShell de Segurança & Conformidade PowerShell e PowerShell para o complemento de segurança interna para caixas de correio locais.

Para obter instruções de conexão usando o módulo, consulte os seguintes artigos:

• Conectar-se ao PowerShell do Exchange Online

  Dica

  As instruções de conexão para o PowerShell no complemento de segurança interna para caixas de correio locais são as mesmas que as instruções de conexão para o Exchange Online PowerShell.

• Conectar-se ao PowerShell de Segurança e Conformidade

• Autenticação somente do aplicativo para scripts autônomos no Exchange Online PowerShell e PowerShell de Conformidade & Segurança

• Use identidades gerenciadas do Azure para se conectar ao PowerShell do Exchange Online

• Usar o C# para se conectar ao PowerShell do Exchange Online

O restante deste artigo explica como o módulo funciona, como instalar e manter o módulo e os cmdlets otimizados do Exchange Online que estão disponíveis no módulo.

Conexões da API REST no módulo EXO V3

Exchange Online PowerShell e o PowerShell de Conformidade & de Segurança usam conexões de API REST para todos os cmdlets desde 2023.

As conexões da API REST exigem os módulos PowerShellGet e PackageManagement. Para obter mais informações, consulte PowerShellGet para conexões baseadas em REST no Windows.

Os cmdlets em conexões de API REST têm as seguintes vantagens sobre seus equivalentes históricos:

• Mais seguro: suporte interno para autenticação moderna e sem dependência da sessão remota do PowerShell. O PowerShell no computador cliente não precisa da autenticação Básica no WinRM.
• Mais confiável: falhas transitórias usam novas tentativas internas, portanto, falhas ou atrasos são minimizados. Por exemplo:
  • Falhas devido a atrasos de rede.
  • Atrasos devido a consultas grandes que levam muito tempo para serem concluídas.
• Melhor desempenho: as conexões da API REST evitam configurar um runspace do PowerShell.

A tabela a seguir compara os benefícios dos cmdlets da API REST com os cmdlets remotos do PowerShell indisponíveis e os cmdlets Get-EXO* exclusivos no módulo EXO V3.

Os cmdlets da API REST têm os mesmos nomes de cmdlet e funcionam exatamente como seus equivalentes remotos do PowerShell, portanto, você não precisa atualizar nomes de cmdlet ou parâmetros em scripts.

Alguns cmdlets no PowerShell do Exchange Online são atualizados com a opção experimental UseCustomRouting. Essa opção roteia o comando diretamente para o servidor de Caixa de Correio necessário e pode melhorar o desempenho geral. Use a opção UseCustomRouting experimentalmente.

• Ao usar a opção UseCustomRouting, você pode usar apenas os seguintes valores para identidade da caixa de correio:

  • Nome principal do usuário (UPN)
  • Endereço de email
  • GUID da Caixa de Correio

• O comutador UseCustomRouting está disponível somente nos seguintes cmdlets do PowerShell do Exchange Online:

  • Get-Clutter
  • Get-FocusedInbox
  • Get-InboxRule
  • Get-MailboxAutoReplyConfiguration
  • Get-MailboxCalendarFolder
  • Get-MailboxFolderPermission
  • Get-MailboxFolderStatistics
  • Get-MailboxMessageConfiguration
  • Get-MailboxPermission
  • Get-MailboxRegionalConfiguration
  • Get-MailboxStatistics
  • Get-MobileDeviceStatistics
  • Get-UserPhoto
  • Remove-CalendarEvents
  • Set-Clutter
  • Set-FocusedInbox
  • Set-MailboxRegionalConfiguration
  • Set-UserPhoto

• Use o cmdlet Get-ConnectionInformation para obter informações sobre conexões com o Exchange Online PowerShell e o PowerShell de Segurança & Conformidade. Esse cmdlet é necessário porque o cmdlet Get-PSSession no Windows PowerShell não retorna informações para conexões da API REST.

  Os cenários em que você pode usar Get-ConnectionInformation são descritos na tabela a seguir:

  Cenário	Saída esperada
  Execute após comandos Connect-ExchangeOnline ou Connect-IPPSSession .	Retorna um objeto de informações de conexão.
  Execute após vários comandos Connect-ExchangeOnline ou Connect-IPPSSession .	Retorna uma coleção de objetos de informações de conexão.

• Use a opção SkipLoadingFormatData no cmdlet Connect-ExchangeOnline para evitar o carregamento de dados de formato e executar comandos Connect-ExchangeOnline mais rapidamente.

• Os cmdlets apoiados pela API REST têm um tempo limite de 15 minutos, o que pode afetar as operações em massa. Por exemplo, o seguinte comando Update-DistributionGroupMember para atualizar 10.000 membros de um grupo de distribuição pode atingir o tempo limite:

  $Members = @("member1","member2",...,"member10000")
  
  Update-DistributionGroupMember -Identity DG01 -Members $Members
  

  Em vez disso, use o comando Update-DistributionGroupMember para atualizar menos membros e, em seguida, adicione os membros restantes individualmente usando um comando Add-DistributionGroupMember . Por exemplo:

  Update-DistributionGroupMember -Identity DG01 -Members $Members[0..4999]
  
  $Remaining = $Members[-5000..-1]
  
  foreach ($Member in $Remaining)
  
  {
     Add-DistributionGroupMember -Identity DG01 -Member $Member
  }
  

Para obter mais informações sobre as novidades do módulo EXO V3, consulte a seção Notas de versão mais adiante neste artigo.

Relatar bugs e problemas para versões de visualização do módulo do PowerShell do Exchange Online

Somente para versões de visualização do módulo, use exocmdletpreview[at]service[dot]microsoft[dot]com para relatar quaisquer problemas que você possa encontrar. Certifique-se de incluir os arquivos de log em sua mensagem de email. Para gerar os arquivos de log, substitua <Path> por uma pasta de saída e execute o seguinte comando:

Connect-ExchangeOnline -EnableErrorReporting -LogDirectoryPath <Path> -LogLevel All

Cmdlets no módulo do PowerShell do Exchange Online

O módulo EXO contém nove cmdlets Get-EXO* exclusivos que são otimizados para velocidade em cenários de recuperação de dados em massa (milhares e milhares de objetos) no Exchange Online PowerShell. Os cmdlets aprimorados no módulo estão listados na tabela a seguir:

Os cmdlets relacionados à conexão no módulo estão listados na tabela a seguir:

Os cmdlets diversos de recursos do Exchange Online que por acaso estão no módulo estão listados na tabela a seguir:

Sistemas operacionais com suporte para o módulo do PowerShell do Exchange Online

O módulo é oficialmente suportado no PowerShell 7 no Windows, Linux e Apple macOS:

• As versões do módulo 3.10.0 (junho de 2026) ou posteriores exigem o PowerShell 7.6.0 (março de 2026) ou posterior devido a dependências de assembly do .NET 10.0.
• As versões do módulo 3.5.0 (maio de 2024) a 3.9.2 (janeiro de 2026) exigem o PowerShell 7.4.0 (novembro de 2023) ou posterior devido a dependências de assembly do .NET 8.0. Versões anteriores do PowerShell 7 podem encontrar problemas de compatibilidade (o PowerShell 7.3.6 é mais compatível com o módulo do que 7.3.7).
• As versões do módulo 3.0.0 (setembro de 2022) a 3.4.0 (outubro de 2023) exigem o PowerShell 7.2.0 (novembro de 2021) ou posterior devido às dependências de assembly do .NET 6.0 em cmdlets e conexões da API REST.
• O suporte para o módulo no PowerShell 7 começou com a versão 2.0.4 (fevereiro de 2021) no PowerShell 7.0.3 (julho de 2020).

Para obter mais informações sobre o PowerShell 7, consulte O que é o PowerShell?.

Suporte do macOS para o módulo

Para instruções sobre como instalar o Windows PowerShell 7 no macOS, consulte Instalando o PowerShell no macOS. Depois de instalar o PowerShell 7, você pode fazer os pré-requisitos regulares do PowerShell e instalar e atualizar o módulo do PowerShell do Exchange Online.

O módulo é compatível com as seguintes versões do macOS:

macOS 14 Sonoma ou posterior

7.4.0 (.NET 8.0) é a versão mais antiga com suporte do PowerShell 7 no macOS 14 Sonoma ou posterior.

macOS 13 Ventura

A versão mais recente com suporte do módulo é 3.9.2 porque a versão mais recente com suporte do PowerShell 7 é 7.5.x (.NET 9.0).

macOS 12 Monterey e macOS 11 Big Sur

A versão mais recente com suporte do módulo é 3.9.2 porque a versão mais recente com suporte do PowerShell 7 é 7.4.x (.NET 8.0).

As versões de módulo 3.0.0 a 3.9.2 são suportadas em todos os processadores.

As versões de módulo 2.0.4 e 2.0.5 são executadas nativamente em processadores Intel. Os processadores Apple M1 ou Apple M2 requerem o Apple Rosetta 2.

macOS 10.15 Catalina

A versão mais recente com suporte do módulo é 3.4.0 porque a versão mais recente com suporte do PowerShell 7 é 7.2.22 (.NET 6.0).

macOS 10.14 Mojave

A versão mais recente com suporte do módulo é 2.0.5 porque a última versão com suporte do PowerShell 7 é 7.1.5 (.NET 5.0).

Suporte do Linux para o módulo

Para instruções sobre como instalar o Windows PowerShell 7 no Linux, consulte Instalando o PowerShell no Linux. Depois de instalar o PowerShell 7, você pode fazer os pré-requisitos regulares do PowerShell e instalar e atualizar o módulo do PowerShell do Exchange Online.

O módulo é oficialmente suportado nas seguintes distribuições do Linux:

Ubuntu 24.04 LTS

7.2.0 (.NET 6.0) é a versão mais antiga com suporte do PowerShell 7 no Ubuntu 24.04 LTS.

Ubuntu 22.04 LTS

7.2.0 (.NET 6.0) é a versão mais antiga com suporte do PowerShell 7 no Ubuntu 22.04 LTS.

Ubuntu 20.04 LTS

A versão mais recente com suporte do módulo é 3.9.2 porque a versão mais recente com suporte do PowerShell 7 é 7.4.x (.NET 8.0).

As versões de módulo 3.7.0 a 3.9.2 podem falhar com erros de protocolo SSL.

Ubuntu 18.04 LTS

A versão mais recente com suporte do módulo é 3.9.2 porque a versão mais recente com suporte do PowerShell 7 é 7.4.x (.NET 8.0).

As versões de módulo 3.7.0 a 3.9.2 podem ter problemas de confiabilidade no Ubuntu 18.04 LTS.

Suporte do Windows para o módulo

O suporte à versão de módulo específica no Windows depende do suporte do Windows PowerShell e do suporte ao .NET Framework e/ou ao .NET, conforme descrito nas seguintes subseções:

Windows 11

No Windows PowerShell 5.1, o módulo requer o .NET Framework 4.7.2 (4.8.x está incluído no Windows 11, portanto, você não precisa instalar o .NET Framework).

7.2.0 (.NET 6.0) é a versão mais antiga com suporte do PowerShell 7 no Windows 11.

Windows Server 2022 e Windows Server 2025

No Windows PowerShell 5.1, o módulo requer o .NET Framework 4.7.2 (4.8.x está incluído, portanto, você não precisa instalar o .NET Framework).

7.2.0 (.NET 6.0) é a versão mais antiga com suporte do PowerShell 7 no Windows Server 2022 e no Windows Server 2025.

Windows 10

No Windows PowerShell 5.1, o módulo requer o .NET Framework 4.7.2. A Atualização do Windows 10 de abril de 2018 (versão 1803) ou posterior inclui o .NET Framework 4.7.2, portanto, você não precisa baixá-lo.

No Windows 10, o .NET 8.0 e o .NET 10.0 (e, portanto, o PowerShell 7.4 ou posterior e as versões de módulo 3.5.0 ou posterior) têm suporte apenas nas edições Enterprise e IoT LTSC que ainda têm suporte (versões 1607, 1809 e 21H2).

As edições para consumidor do Windows 10 chegaram ao fim do suporte em outubro de 2025 e não dão suporte ao .NET 8.0 ou .NET 10.0.

Windows Server 2016 e Windows Server 2019

No Windows PowerShell 5.1, o módulo requer o .NET Framework 4.7.2 (incluído no Windows Server 2019).

Windows 8.1, Windows Server 2012 e Windows Server 2012 R2

No Windows PowerShell 5.1, o módulo requer o .NET Framework 4.7.2.

7.2.22 (.NET 6.0) é a versão mais recente com suporte do PowerShell 7 no Windows 8.1, Windows Server 2012 e Windows Server 2012 R2.

Windows 7.1 SP1 e Windows Server 2008 R2 SP1

No Windows PowerShell 5.1, o módulo requer o .NET Framework 4.7.1.

Pré-requisitos para o módulo do PowerShell do Exchange Online

Definir a política de execução do PowerShell como RemoteSigned

Windows PowerShell precisa ser configurado para executar scripts e, por padrão, não é. Ao tentar se conectar, você obtém o seguinte erro:

Não é possível carregar arquivos porque a execução de scripts está desabilitada neste sistema. Forneça um certificado válido para assinar os arquivos.

Para exigir a assinatura de fornecedor confiável para todos os scripts do PowerShell baixados da Internet, execute o seguinte comando em uma sessão do PowerShell com privilégios elevados (uma janela do PowerShell que você abre selecionando Executar como administrador):

Set-ExecutionPolicy RemoteSigned

Para obter mais informações sobre as políticas de execução, confira Sobre Políticas de Execução.

Autenticação básica no WinRM

A partir de outubro de 2023, as conexões da API REST substituíram as conexões de autenticação básica (PowerShell remoto) no PowerShell do Exchange Online e o PowerShell de Segurança & Conformidade. As conexões da API REST não exigem autenticação Básica no WinRM.

A versão 3.2.0 (junho de 2023) e versões posteriores do módulo oferecem suporte total a cmdlets de API REST no Exchange Online PowerShell e no PowerShell de Segurança & Conformidade.

PowerShellObter necessário no Windows

As conexões da API REST no Windows exigem o módulo PowerShellGet. Por dependência, o módulo PowerShellGet requer o módulo PackageManagement. A consideração para esses módulos é mais para o PowerShell 5.1 do que para o PowerShell 7, mas todas as versões do PowerShell se beneficiam de ter as versões mais recentes dos módulos instaladas. Para obter instruções de instalação e atualização, consulte Instalando o PowerShellGet no Windows.

Se você não tiver o PowerShellGet instalado ao tentar se conectar, receberá o seguinte erro:

Não é possível encontrar um cmdlet Update-Manifest

Instale e atualize o módulo do PowerShell do Exchange Online

O módulo está disponível na Galeria do PowerShell em https://www.powershellgallery.com/packages/ExchangeOnlineManagement/.

Use o cmdlet Install-Module para instalar o módulo pela primeira vez e o cmdlet Update-Module para atualizar uma instalação existente da Galeria do PowerShell. Ambos os cmdlets usam os mesmos parâmetros, portanto, a mesma sintaxe se aplica se você estiver instalando ou atualizando.

Para ver se o módulo já está instalado e como foi instalado, execute Get-InstalledModule ExchangeOnlineManagement | Format-List Name,Version,InstalledLocation:

• Se o módulo estiver instalado no %ProgramFiles%\WindowsPowerShell\Modules\, ele está instalado para todos os usuários.
• Se o módulo estiver instalado na pasta Documentos, ele será instalado apenas para sua conta de usuário atual.

Antes de instalar o módulo pela primeira vez, instale ou atualize o módulo PowerShellGet conforme descrito em Instalando o PowerShellGet e, em seguida, feche e reabra a janela do PowerShell.

Para instalar ou atualizar o módulo, use a seguinte sintaxe:

<Install-Module | Update-Module> -Name ExchangeOnlineManagement [-Scope CurrentUser] [-RequiredVersion <Version>] [-AllowPrerelease]

• Normalmente, você deseja a versão pública mais recente do módulo, mas também pode instalar ou atualizar para uma versão de visualização.

• Requisitos para a sessão do PowerShell para instalar ou atualizar o módulo:

  • Para todos os usuários: execute o comando em uma sessão do PowerShell com privilégios elevados.
  • Para o usuário atual: uma sessão elevada do PowerShell não é necessária.

  Ao atualizar o módulo, use o mesmo escopo usado para instalá-lo originalmente.

• O parâmetro RequiredVersion especifica a versão do módulo para a qual instalar ou atualizar. Você pode usar esse parâmetro com ou sem a opção AllowPrerelease .

• O switch AllowPrerelease instala ou atualiza para uma versão de visualização do módulo. Para especificar a versão de visualização, use também o parâmetro RequiredVersion .

  Para ver todas as versões disponíveis do módulo, incluindo as versões prévias, execute Find-Module ExchangeOnlineManagement -AllVersions -AllowPrerelease. Para ver apenas versões públicas, omita a opção AllowPrerelease .

Este exemplo instala a versão pública mais recente do módulo para todos os usuários.

Install-Module -Name ExchangeOnlineManagement

Este exemplo atualiza o módulo para a versão pública mais recente para a conta de usuário atual.

Update-Module -Name ExchangeOnlineManagement -Scope CurrentUser

Este exemplo instala a versão prévia mais recente disponível do módulo para todos os usuários.

Install-Module -Name ExchangeOnlineManagement -AllowPrerelease

Para obter informações detalhadas sobre sintaxe e parâmetro, consulte os seguintes artigos:

• find-module
• Install-Module
• Módulo de atualização
• Get-InstalledModule

Desinstalar o módulo do PowerShell do Exchange Online

Para desinstalar o módulo, execute o seguinte comando. Se você instalou originalmente o módulo para todos os usuários, execute o comando em uma sessão elevada do PowerShell.

Uninstall-Module -Name ExchangeOnlineManagement

Para confirmar como o módulo foi instalado (todos os usuários versus a conta de usuário atual), use o Get-InstalledModule comando no início da seção Instalar e atualizar o módulo do PowerShell do Exchange Online.

Para obter informações detalhadas sobre sintaxes e parâmetros, confira Uninstall-Module.

Solucionar problemas de instalação do módulo do PowerShell do Exchange Online

Esta seção descreve os erros que você pode encontrar ao instalar o módulo e como resolvê-los.

• Você recebe um dos seguintes erros:

  O módulo especificado 'ExchangeOnlineManagement' com a '<versão>' PowerShellGetFormatVersion não é compatível com a versão atual do PowerShellGet. Obtenha a versão mais recente do módulo PowerShellGet para instalar esse módulo, "ExchangeOnlineManagement".

  AVISO: Não é possível baixar do URI 'https://go.microsoft.com/fwlink/?LinkID=627338& clcid=0x409' para ''.

  AVISO: Não é possível baixar a lista de provedores disponíveis. Verifique sua conexão com a internet.

  Atualize a instalação do módulo PowerShellGet para a versão mais recente, conforme descrito em Instalando o PowerShellGet. Certifique-se de fechar e reabrir a janela do PowerShell antes de tentar atualizar o módulo ExchangeOnlineManagement novamente.

• Você recebe o seguinte erro:

  Nenhuma correspondência foi encontrada para os critérios de pesquisa especificados e o nome do módulo 'ExchangeOnlineManagement'. Tente executar Get-PSRepository para ver todos os repositórios de módulos registrados disponíveis.

  O repositório padrão para módulos do PowerShell não está definido como PSGallery. Para corrigir esse erro, execute o seguinte comando:

  Register-PSRepository -Default
  

• No Windows PowerShell 5.1, você recebe erros ao tentar instalar o módulo porque a Galeria do PowerShell requer conexões TLS 1.2 ou posteriores (o PowerShell 7 já usa o TLS 1.2 ou posterior). Esse problema normalmente afeta apenas versões mais antigas do Windows em que o .NET Framework não usa TLS 1.2 por padrão. Para obter mais informações e as etapas para resolvê-lo, consulte Suporte a TLS da Galeria do PowerShell.

Propriedades e conjuntos de propriedades no módulo do PowerShell do Exchange Online

Os cmdlets tradicionais do Exchange Online retornam todas as propriedades de objeto possíveis, incluindo muitas propriedades em branco ou desinteressantes. Esse comportamento causa um desempenho degradado (mais computação de servidor e carregamento de rede adicionado). Você raramente (ou nunca) precisará do complemento total de propriedades na saída do cmdlet.

Os cmdlets Get-EXO* no módulo contêm propriedades de saída categorizadas. Em vez de dar a todas as propriedades a mesma importância e retorná-las em todos os cenários, categorizamos propriedades relacionadas específicas em conjuntos de propriedades. Esses conjuntos de propriedades são buckets de duas ou mais propriedades relacionadas no cmdlet.

Os maiores e mais usados cmdlets Get-EXO* usam conjuntos de propriedades:

• Get-EXOCasMailbox
• Get-EXOMailbox
• Get-EXOMailboxStatistics
• Get-EXORecipient

Nesses cmdlets, os seguintes parâmetros controlam os conjuntos de propriedades:

• PropertySets: esse parâmetro aceita um ou mais nomes de conjuntos de propriedades disponíveis separados por vírgulas. Os conjuntos de propriedades disponíveis são descritos em Conjuntos de propriedades nos cmdlets do módulo do PowerShell do Exchange Online.
• Propriedades: esse parâmetro aceita um ou mais nomes de propriedade separados por vírgulas.

Você pode usar os parâmetros PropertySets e Properties em conjunto no mesmo comando.

Também incluímos um conjunto de propriedades Mínimo que inclui um conjunto mínimo de propriedades necessárias para a saída do cmdlet (por exemplo, propriedades de identidade). As propriedades nos conjuntos de propriedades Mínimo também são descritas em Conjuntos de propriedades nos cmdlets do módulo do PowerShell do Exchange Online.

• Se você não usar os parâmetros PropertySets ou Properties, obterá automaticamente as propriedades no conjunto de propriedades Mínimo.
• Se você usar os parâmetros PropertySets ou Properties, obterá as propriedades especificadas e as propriedades no conjunto de propriedades Mínimo.

De qualquer forma, a saída do cmdlet contém muito menos propriedades e os resultados são retornados muito mais rapidamente.

Por exemplo, depois de se conectar ao PowerShell do Exchange Online, o exemplo a seguir retorna apenas as propriedades no conjunto de propriedades Mínimo para as primeiras 10 caixas de correio.

Get-EXOMailbox -ResultSize 10

Por outro lado, a saída do mesmo comando Get-Mailbox retornaria pelo menos 230 propriedades para cada uma das primeiras 10 caixas de correio.

Para obter mais informações sobre filtragem no módulo, consulte Filtros no módulo do PowerShell do Exchange Online.

Notas de versão

Salvo indicação em contrário, a versão atual do módulo do PowerShell do Exchange Online contém todos os recursos das versões anteriores.

Versão atual

Versão 3.10.1

• Correção de bugs de CBA (autenticação baseada em certificado) e outros problemas menores de desempenho.

Versões anteriores

Versão 3.10.0

• A partir desta versão do módulo, a versão mínima necessária do PowerShell 7 é 7.6. O Windows PowerShell 5.1 não é afetado.
• Correção de um problema em que a autenticação baseada em certificado (CBA) falhava em Connect-IPPSSession quando você usava a opção EnableSearchOnlySession .

Versão 3.9.2

• Novos cmdlets Add-WorkforceInsightsDelegationAccess, Get-WorkforceInsightsDelegationAccess e Remove-WorkforceInsightsDelegationAccess para delegação do Workforce Insights.
• Novo parâmetro EXOModuleBasePath em Connect-ExchangeOnline e Connect-IPPSSession para armazenar arquivos temporários do módulo EXO em um caminho personalizado.
• Parâmetro UseRpsSession preterido de Connect-ExchangeOnline e Connect-IPPSSession.

Versão 3.9.0

• Nova opção EnableSearchOnlySession ativada Connect-IPPSSession, que habilita determinados cmdlets de Descoberta Eletrônica e cmdlets relacionados que se conectam a outros serviços do Microsoft 365.

Versão 3.8.0

• Novo parâmetro AccessToken em Connect-IPPSSession.

• Get-VivaModuleFeature agora retorna informações sobre ParentFeature, ChildFeature e PolicyModes. Esses valores representam recursos pai e filho de um recurso do aplicativo Viva, juntamente com modos de habilitação disponíveis para políticas futuras.

• Novos parâmetros IsUserOptedInByDefault nos cmdlets Add-VivaModuleFeaturePolicy e Update-VivaModuleFeaturePolicy e o valor da propriedade correspondente em todos os cmdlets *-VivaModuleFeaturePolicy . O valor indica se os usuários foram recusados pela política, desde que o usuário não defina uma preferência.

  Você pode usar esse parâmetro para manter o recurso habilitado em sua organização enquanto exclui os usuários afetados por padrão, desabilitando efetivamente o recurso para esses usuários.

• Preterido o cmdlet Get-VivaFeatureCategory , todos os parâmetros relacionados à categoria e valores retornados (CategoryId, IsCategoryEnabled).

Versão 3.7.2

• O comutador DisableWAM está disponível no cmdlet Connect-ExchangeOnline para desabilitar o WAM (Gerenciador de Contas da Web) se você receber erros de conexão relacionados ao WAM.

Versão 3.7.1

• Foi adicionada uma nova propriedade nomeada ExoExchangeSecurityDescriptor para a saída de Get-EXOMailbox semelhante à ExchangeSecurityDescriptor propriedade na saída de Get-Mailbox.
• Adicionados novos cmdlets para dar suporte ao recurso Delegação de Insights da Organização do Viva:
  • Add-VivaOrgInsightsDelegatedRole
  • Get-VivaOrgInsightsDelegatedRole
  • Remove-VivaOrgInsightsDelegatedRole

Versão 3.7.0

• WAM (Gerenciador de Contas da Web) integrado em fluxos de autenticação para aumentar a segurança.
• A ajuda de linha de comando para cmdlets do PowerShell do Exchange Online não é mais carregada por padrão. Use a opção LoadCmdletHelp no comando Connect-ExchangeOnline para que a ajuda para cmdlets do PowerShell do Exchange Online esteja disponível para o cmdlet Get-Help.
• Corrigidos problemas de conexão com a autenticação somente do aplicativo no PowerShell de Segurança & Conformidade.

Versão 3.6.0

• Get-VivaModuleFeature agora retorna informações sobre os tipos de identidades para as quais o recurso dá suporte à criação de políticas (por exemplo, usuários, grupos ou toda a organização).
• Os cmdlets para o gerenciamento de acesso a recursos do Viva agora lidam com desafios de declaração de CAE (avaliação contínua de acesso).
• Adicionada correção para problema de compatibilidade com o módulo Microsoft.Graph.

Versão 3.5.1

• Correções de bugs em Get-EXOMailboxPermission e Get-EXOMailbox.
• O módulo é atualizado para ser executado no .NET 8, substituindo a versão anterior baseada no .NET 6.
• Aprimoramentos no Add-VivaModuleFeaturePolicy.

Versão 3.5.0

• Novo cmdlet Get-VivaFeatureCategory .
• Adicionado suporte para operações de política no nível de categoria no Viva VFAM (Gerenciamento de Acesso a Recursos).
• Nova propriedade IsFeatureEnabledByDefault na saída de Get-VivaModuleFeaturePolicy. O valor desta propriedade mostra o estado de ativação padrão para usuários quando nenhuma organização ou políticas de usuário/grupo foram criadas.

Versão 3.4.0

• Correções de bugs em Connect-ExchangeOnline, Get-EXORecipientPermission e Get-EXOMailboxFolderPermission.
• O parâmetro SigningCertificate no Connect-ExchangeOnline agora dá suporte ao Modo de Idioma Restrito (CLM).

Versão 3.3.0

• Parâmetro SkipLoadingCmdletHelp no Connect-ExchangeOnline para dar suporte a ignorar arquivos de ajuda de cmdlet de carregamento.
• A variável EXO_LastExecutionStatus global está disponível para marcar o status do último cmdlet que foi executado.
• Correções de bugs no Connect-ExchangeOnline e no Connect-IPPSSession.
• Parâmetro IsUserControlEnabled em Add-VivaModuleFeaturePolicy e Update-VivaModuleFeaturePolicy para dar suporte à habilitação de controles de usuário por política para recursos integrados ao gerenciamento de acesso a recursos do Viva.

Versão 3.2.0

• Novos cmdlets:
  • Get-DefaultTenantBriefingConfig e Set-DefaultTenantBriefingConfig.
  • Get-DefaultTenantMyAnalyticsFeatureConfig e Set-DefaultTenantMyAnalyticsFeatureConfig.
  • Get-VivaModuleFeature, Get-VivaModuleFeatureEnablement, Add-VivaModuleFeaturePolicy, Get-VivaModuleFeaturePolicy, Remove-VivaModuleFeaturePolicy e Update-VivaModuleFeaturePolicy.
• Suporte de conexão de API REST para o PowerShell de Segurança & Conformidade.
• Parâmetro ConnectionId em Get-ConnectionInformation e Disconnect-ExchangeOnline:
  • Obtenha informações de conexão para conexões específicas da API REST.
  • Desconexão seletiva para conexões da API REST.
• O parâmetro SigningCertificate no Connect-ExchangeOnline permite que você assine os arquivos de formato (*. Format.ps1xml) ou arquivos de módulo de script (.psm1) no módulo temporário que o Connect-ExchangeOnline cria com um certificado de cliente a ser usado em todas as políticas de execução do PowerShell.
• Correções de bugs no Connect-ExchangeOnline.

Versão 3.1.0

• AccessToken disponível em Connect-ExchangeOnline.
• Correções de bugs no Connect-ExchangeOnline e Get-ConnectionInformation.
• Correção de bug em Connect-IPPSSession para se conectar ao PowerShell de Segurança & Conformidade usando CertificateThumbprint.

Versão 3.0.0 (versões prévias conhecidas como v2.0.6-PreviewX)

• Recursos já descritos nas conexões da API REST na seção do módulo EXO V3 :
  • Autenticação baseada em certificado para PowerShell de Segurança & Conformidade (versão 2.0.6-Preview5 ou posterior).
  • O cmdlet Get-ConnectionInformation para conexões baseadas em REST (versão 2.0.6-Preview7 ou posterior).
  • O comutador SkipLoadingFormatData no cmdlet Connect-ExchangeOnline para conexões baseadas em REST (versão 2.0.6-Preview8 ou posterior).
• O parâmetro DelegatedOrganization funciona no cmdlet Connect-IPPSSession , desde que você também use o parâmetro AzureADAuthorizationEndpointUri no comando.
• Determinados cmdlets que solicitaram confirmação em cenários específicos não fazem mais isso. Por padrão, o cmdlet é executado até a conclusão.
• O formato do erro retornado da execução de cmdlet com falha foi ligeiramente modificado. A exceção agora contém mais dados (por exemplo, o tipo de exceção) e FullyQualifiedErrorId a exceção não contém o FailureCategoryarquivo . O formato do erro está sujeito a modificações adicionais.

Versão 2.0.5

• Novos cmdlets Get-OwnerlessGroupPolicy e Set-OwnerlessGroupPolicy para gerenciar Grupos do Microsoft 365 sem proprietário.

  Observação

  Embora os cmdlets estejam disponíveis no módulo, o recurso está disponível apenas para membros de uma Visualização Privada.

• Novos cmdlets Get-VivaInsightsSettings e Set-VivaInsightsSettings para controlar o acesso do usuário aos recursos do Headspace no Viva Insights.

Versão 2.0.4

• O PowerShell 7 tem suporte oficial no Windows, no Linux e no Apple macOS, conforme descrito na seção Pré-requisitos para o módulo do PowerShell do Exchange Online deste artigo.

• O módulo no PowerShell 7 dá suporte ao SSO (logon único) baseado em navegador e outros métodos de entrada. Para obter mais informações, consulte Métodos de conexão exclusivos do PowerShell 7.

• Os cmdlets Get-UserAnalyticsConfig e Set-UserAnalyticsConfig foram substituídos pelos cmdlets Get-MyAnalyticsConfig e Set-MyAnalyticsConfig . Você também pode configurar o acesso no nível do recurso. Para saber mais, consulte Configurar MyAnalytics.

• Imposição de política e segurança em tempo real em todas as autenticações baseadas no usuário. A Avaliação contínua de acesso (CAE) está ativada no módulo. Para obter mais informações, consulte Movendo para política em tempo real e imposição de segurança.

• As propriedades LastUserActionTime e LastInteractionTime agora estão disponíveis na saída do cmdlet Get-EXOMailboxStatistics.

• O processo de login interativo agora usa um método mais seguro para buscar tokens de acesso usando URLs de resposta seguros.

Versão 2.0.3

• Disponibilidade geral de autenticação baseada em certificado (CBA), que permite usar a autenticação moderna em cenários de script autônomo ou automação em segundo plano. Os locais de armazenamento de certificado disponíveis são:
  • Remoto no parâmetro do Azure Key Value (o Certificado). Essa opção melhora a segurança buscando o certificado somente em tempo de execução.
  • Local no repositório de certificados CurrentUser ou LocalMachine (o parâmetro CertificateThumbprint ).
  • Local em um arquivo de certificado exportado (os parâmetros CertificateFilePath e CertificatePassword). Para obter mais informações, consulte as descrições de parâmetro em Connect-ExchangeOnline e Autenticação somente de aplicativo para scripts autônomos no módulo do PowerShell do Exchange Online.
• Conecte-se ao PowerShell do Exchange Online e ao PowerShell de Segurança e Conformidade simultaneamente em uma única janela do PowerShell.
• O novo parâmetro CommandName permite especificar e restringir os cmdlets do Exchange Online PowerShell importados em uma sessão. Essa opção reduz o volume de memória para aplicativos do PowerShell de alto uso.
• Get-EXOMailboxFolderPermission agora dá suporte a ExternalDirectoryObjectID no parâmetro Identidade.
• A latência otimizada da primeira chamada de cmdlet v2. Os resultados do laboratório mostram que a latência da primeira chamada diminuiu de 8 segundos para aproximadamente 1 segundo. Os resultados reais dependem do tamanho do resultado do cmdlet e do ambiente da organização.

Versão 1.0.1

• Versão de Disponibilidade Geral (GA) do módulo EXO V2. É estável e pronto para uso em ambientes de produção.
• O cmdlet Get-ExoMobileDeviceStatistics agora dá suporte ao parâmetro Identidade.
• Confiabilidade aprimorada para reconexão automática de sessões em determinados cenários em que um script estava em execução por ~50 minutos e gerou um erro "Cmdlet não encontrado" devido a um bug na lógica de reconexão automática.
• Corrigidos problemas de tipo de dados de dois atributos "Usuário" e "MailboxFolderUser" comumente usados para facilitar a migração de scripts.
• Suporte aprimorado para filtros, pois agora dá suporte a mais quatro operadores: EndsWith, Contains, Not e NotLike. Verifique os filtros no módulo do PowerShell do Exchange Online para atributos que não têm suporte em filtros.

Versão 0.4578.0

• Adicionado suporte para configurar o Email de Resumo da sua organização no nível do usuário com os cmdlets Set-UserBriefingConfig e Get-UserBriefingConfig.
• Suporte à limpeza de sessão usando o cmdlet Disconnect-ExchangeOnline. Este cmdlet é o equivalente à V2 de Get-PSSession | Remove-PSSession. Além de limpar o objeto de sessão e os arquivos locais, ele também remove o token de acesso do cache, que é usado para autenticação nos cmdlets V2.
• Agora você pode usar FolderId como um parâmetro de identidade em Get-EXOMailboxFolderPermission. Você pode obter o valor FolderId usando Get-MailboxFolder. Por exemplo: Get-MailboxFolderPermission -Identity <UPN>:<Folder-Path>Get-MailboxFolderPermission -Identity <UPN>:\<Folder-Id>
• Confiabilidade aprimorada de Get-EXOMailboxStatistics à medida que determinados erros de roteamento de solicitação que levavam a falhas são resolvidos.
• Uso de memória otimizado para novas sessões criadas a partir da reutilização de módulos existentes em vez de criar uma nova sessão toda vez que uma sessão é importada.

Versão 0.4368.1

• Adicionado suporte para cmdlets do PowerShell de Segurança e Conformidade usando o cmdlet Connect-IPPSSession.
• Ocultar o banner de anúncio está disponível usando a opção ShowBanner (-ShowBanner:$false).
• Terminar a execução do cmdlet na exceção do cliente.
• O PowerShell remoto continha vários tipos de dados complexos que intencionalmente não eram suportados em cmdlets EXO para melhorar o desempenho. As diferenças em tipos de dados não complexos entre cmdlets remotos do PowerShell e cmdlets V2 são resolvidas para permitir a migração perfeita de scripts de gerenciamento.

Versão 0.3582.0

• Suporte para prefixo durante a criação da sessão:
  • Você pode criar apenas uma sessão por vez que contenha cmdlets prefixados.
  • Os cmdlets EXO V2 não são prefixados porque já têm o prefixo EXO, portanto, não use EXO como prefixo.
• Use cmdlets EXO V2 mesmo se a autenticação básica do WinRM estiver desabilitada na máquina do cliente. As conexões remotas do PowerShell exigem a Autenticação Básica do WinRM, e os cmdlets remotos do PowerShell não estarão disponíveis se a Autenticação Básica estiver desabilitada no WinRM.
• O parâmetro Identity para cmdlets V2 agora dá suporte a Nome e Alias. O uso de Alias ou Nome diminui o desempenho dos cmdlets V2, portanto, não recomendamos usá-los.
• Problema corrigido em que o tipo de dados dos atributos retornados pelo cmdlet V2 era diferente dos cmdlets remotos do PowerShell. Ainda temos poucos atributos com diferentes tipos de dados e planejamos lidar com eles nos próximos meses.
• Bug corrigido: Problema de reconexão de sessões frequentes quando Connect-ExchangeOnline era invocado com Credenciais ou UserPrincipalName

Versão 0.3555.1

• Correção de um bug em que os cmdlets canalizados falhavam devido a um problema de autenticação:

  Não é possível invocar o pipeline porque o runspace não está no estado Aberto. O estado atual do runspace é "Fechado".

Versão 0.3527.4

• Conteúdo Get-Help atualizado.
• Correção de um problema em Get-Help em que o parâmetro Online redirecionava para uma página inexistente com código de erro 400.

Versão 0.3527.3

• Adicionado suporte para gerenciar o Exchange para uma organização diferente usando o fluxo de delegação.
• Funciona em conjunto com outros módulos do PowerShell em uma única janela do PowerShell.
• Suporte adicional para os parâmetros de posição.
• O campo data e hora agora tem suporte para a localidade do cliente.
• Correção de bugs: PSCredential vazio quando transmitido durante o Connect-ExchangeOnline.
• Correção de bugs: um erro de módulo de cliente quando o filtro continha $null.
• As sessões criadas internamente no módulo EXO V2 agora têm nomes (padrão de nomenclatura: ExchangeOnlineInternalSession_% SomeNumber%).
• Correção de bug: cmdlets remotos do PowerShell falhando intermitentemente devido ao tempo a diferença entre a expiração do token e a sessão ficar ociosa.
• Atualização de segurança importante.
• Correção de bugs e melhorias.