Acerca do módulo Exchange Online PowerShell

O módulo Exchange Online PowerShell utiliza a autenticação moderna e funciona com ou sem autenticação multifator (MFA) para ligar a todos os ambientes do PowerShell relacionados com o Exchange no Microsoft 365: Exchange Online PowerShell, PowerShell de Conformidade & de Segurança e Proteção do Exchange Online autónomos (EOP) PowerShell.

Para obter instruções de ligação com o módulo, veja os seguintes artigos:

• Conectar-se ao PowerShell do Exchange Online
• Conectar-se ao PowerShell de Segurança e Conformidade
• Conectar-se ao PowerShell da Proteção do Exchange Online
• Autenticação apenas de aplicações para scripts autónomos no PowerShell do Exchange Online PowerShell e conformidade de & de segurança do PowerShell
• Utilizar identidades geridas do Azure para ligar ao Exchange Online PowerShell
• Utilizar C# para ligar ao Exchange Online PowerShell

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.

Ligações à API REST no módulo EXO V3

Exchange Online PowerShell e o PowerShell de Conformidade & de Segurança utilizam agora ligações de API REST para todos os cmdlets:

• Exchange Online PowerShell: módulo EXO V3 v3.0.0 ou posterior.
• PowerShell de Conformidade do & de Segurança: módulo EXO V3 v3.2.0 ou posterior.

As ligações à API REST requerem os módulos PowerShellGet e PackageManagement. Para obter mais informações, veja PowerShellGet para ligações baseadas em REST no Windows.

Os cmdlets nas ligações da API REST têm as seguintes vantagens em relação aos seus homólogos históricos:

• Mais seguro: suporte incorporado para autenticação moderna e nenhuma dependência na sessão remota do PowerShell. O PowerShell no computador cliente não precisa de autenticação Básica no WinRM.
• Mais fiável: as falhas transitórias utilizam repetições incorporadas, pelo que as falhas ou atrasos são minimizados. Por exemplo:
  • Falhas devido a atrasos na rede.
  • Atrasos devido a consultas grandes que demoram muito tempo a concluir.
• Melhor desempenho: as ligações da API REST evitam a configuração de um espaço de execução do PowerShell.

As vantagens dos cmdlets nas ligações à API REST estão descritas na tabela seguinte:

	Cmdlets do PowerShell remotos	Cmdlets Get-EXO*	Cmdlets da API REST
Segurança	Menos segura	Altamente seguro	Altamente seguro
Desempenho	Baixo desempenho	Alto desempenho	Desempenho médio
Confiabilidade	Menos fiável	Altamente fiável	Altamente fiável
Funcionalidade	Todos os parâmetros e propriedades de saída disponíveis	Parâmetros limitados e propriedades de saída disponíveis	Todos os parâmetros e propriedades de saída disponíveis

Os cmdlets da API REST têm os mesmos nomes de cmdlets e funcionam tal como os equivalentes remotos do PowerShell, pelo que não precisa de atualizar os nomes ou parâmetros dos cmdlets em scripts mais antigos.

As ligações de autenticação básica (powerShell remoto) são preteridas no PowerShell Exchange Online PowerShell e no PowerShell de Conformidade do & de Segurança. Para obter mais informações, consulte aqui e aqui.

Alguns cmdlets no Exchange Online PowerShell foram atualizados com o comutador experimental UseCustomRouting nas ligações da API REST. Essa opção roteia o comando diretamente para o servidor de Caixa de Correio necessário e pode melhorar o desempenho geral. Utilize o comutador 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 só está disponível nos seguintes cmdlets Exchange Online PowerShell em ligações à API REST:

  • 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

• Utilize o cmdlet Get-ConnectionInformation para obter informações sobre as ligações da API REST para Exchange Online PowerShell e o PowerShell de Conformidade & de Segurança. Este cmdlet é necessário porque o cmdlet Get-PSSession no Windows PowerShell não devolve informações para ligações à API REST.

  Os cenários em que pode utilizar Get-ConnectionInformation estão descritos na tabela seguinte:

  Cenário	Resultado esperado
  Execute após os comandos Connect-ExchangeOnline ou Connect-IPPSSession para ligações à API REST.	Devolve um objeto de informações de ligação.
  Execute após vários comandos Connect-ExchangeOnline ou Connect-IPPSSession para ligações à API REST.	Devolve uma coleção de objetos de informações de ligação.

• Utilize o comutador SkipLoadingFormatData no cmdlet Connect-ExchangeOnline para evitar carregar dados de formato e executar comandos do 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 exceder o limite de tempo:

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

  Em vez disso, utilize o comando Update-DistributionGroupMember para atualizar menos membros e, em seguida, adicione os restantes membros individualmente com 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 no módulo EXO V3, veja a secção Notas de versão mais adiante neste artigo.

Comunicar erros e problemas relativos a Versões de pré-visualização do módulo Exchange Online PowerShell

Para Versões de pré-visualização do módulo, utilize exocmdletpreview[at]service[dot]microsoft[dot]com para comunicar quaisquer problemas que possa encontrar. Certifique-se de que inclui os ficheiros de registo na sua mensagem de e-mail. Para gerar os ficheiros de registo, substitua <Path> por uma pasta de saída e, em seguida, execute o seguinte comando:

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

Cmdlets no módulo Exchange Online PowerShell

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

Cmdlet do módulo EXO	Cmdlet relacionado mais antigo:
Get-EXOMailbox	Get-Mailbox
Get-EXORecipient	Get-Recipient
Get-EXOCasMailbox	Get-CASMailbox
Get-EXOMailboxPermission	Get-MailboxPermission
Get-EXORecipientPermission	Get-RecipientPermission
Get-EXOMailboxStatistics	Get-MailboxStatistics
Get-EXOMailboxFolderStatistics	Get-MailboxFolderStatistics
Get-EXOMailboxFolderPermission	Get-MailboxFolderPermission
Get-EXOMobileDeviceStatistics	Get-MobileDeviceStatistics

Os cmdlets relacionados com a ligação no módulo estão listados na seguinte tabela:

Cmdlet do módulo EXO	Cmdlet relacionado mais antigo:	Comments
Connect-ExchangeOnline	Connect-EXOPSSession na V1 do módulo ou New-PSSession
Connect-IPPSSession	Connect-IPPSSession na V1 do módulo
Disconnect-ExchangeOnline	Remove-PSSession
Get-ConnectionInformation	Get-PSSession	Disponível na v3.0.0 ou posterior.

Os cmdlets diversos Exchange Online que estão no módulo estão listados na seguinte tabela:

Cmdlet	Comments
Get-DefaultTenantBriefingConfig	Disponível na v3.2.0 ou posterior.
Set-DefaultTenantBriefingConfig	Disponível na v3.2.0 ou posterior.
Get-DefaultTenantMyAnalyticsFeatureConfig	Disponível na v3.2.0 ou posterior.
Set-DefaultTenantMyAnalyticsFeatureConfig	Disponível na v3.2.0 ou posterior.
Get-MyAnalyticsFeatureConfig	Disponível na v2.0.4 ou posterior.
Set-MyAnalyticsFeatureConfig	Disponível na v2.0.4 ou posterior.
Get-UserBriefingConfig	Substituído por Get-MyAnalyticsFeatureConfig.
Set-UserBriefingConfig	Substituído por Set-MyAnalyticsFeatureConfig.
Get-VivaInsightsSettings	Disponível na versão v2.0.5-Preview2 ou posterior.
Set-VivaInsightsSettings	Disponível na versão v2.0.5-Preview2 ou posterior.
Get-VivaModuleFeature	Disponível na v3.2.0 ou posterior.
Get-VivaModuleFeatureEnablement	Disponível na v3.2.0 ou posterior.
Add-VivaModuleFeaturePolicy	Disponível na v3.2.0 ou posterior.
Get-VivaModuleFeaturePolicy	Disponível na v3.2.0 ou posterior.
Remove-VivaModuleFeaturePolicy	Disponível na v3.2.0 ou posterior.
Update-VivaModuleFeaturePolicy	Disponível na v3.2.0 ou posterior.

Instalar e manter o módulo Exchange Online PowerShell

Transfira o módulo a partir da galeria do PowerShell em https://www.powershellgallery.com/packages/ExchangeOnlineManagement/.

Os procedimentos nesta secção explicam como instalar, atualizar e desinstalar o módulo.

Sistemas operativos suportados para o módulo Exchange Online PowerShell

As versões mais recentes do módulo são oficialmente suportadas no PowerShell 7 no Windows, Linux e Apple macOS.

Especificamente, a versão 2.0.4 ou posterior é suportada no PowerShell 7.0.3 ou posterior.

Para mais informações sobre o Windows PowerShell 7, consulte Anunciando o PowerShell 7.0.

Apple macOS

O módulo é suportado nas seguintes versões do macOS:

• macOS 11 Big Sur ou posterior
• macOS 10.15 Catalina
• macOS 10.14 Mojave

Para instruções sobre como instalar o Windows PowerShell 7 no macOS, consulte Instalando o PowerShell no macOS.

Conforme descrito no artigo de instalação, você precisa instalar o OpenSSL, que é necessário para o WSMan.

Depois de instalar o PowerShell 7 e o OpenSSL, execute as seguintes etapas:

1. Execute o PowerShell como super usuário: sudo pwsh

2. Na sessão do super usuário do PowerShell, execute os seguintes comandos:

   Install-Module -Name PSWSMan
   
   Install-WSMan
   

   Se solicitado, aceite PSGallery como a origem dos cmdlets.

Agora, pode efetuar os pré-requisitos normais do PowerShell e instalar o módulo Exchange Online PowerShell.

Linux

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

• Ubuntu 24.04 LTS
• Ubuntu 20.04 LTS
• Ubuntu 18.04 LTS

Para instruções sobre como instalar o Windows PowerShell 7 no Linux, consulte Instalando o PowerShell no Linux.

Depois de instalar o PowerShell 7, execute as seguintes etapas:

1. Execute o PowerShell como super usuário: sudo pwsh

2. Na sessão do super usuário do PowerShell, execute os seguintes comandos:

   Install-Module -Name PSWSMan
   
   Install-WSMan
   

   Se solicitado, aceite PSGallery como a origem dos cmdlets.

Agora, pode efetuar os pré-requisitos normais do PowerShell e instalar o módulo Exchange Online PowerShell.

Windows

Todas as versões do módulo são suportadas no Windows PowerShell 5.1.

O PowerShell 7 no Windows necessita da versão 2.0.4 ou posterior.

A versão 2.0.5 ou posterior do módulo requer que o Microsoft .NET Framework 4.7.2 ou posterior se ligue. Caso contrário, obtém um System.Runtime.InteropServices.OSPlatform erro. Este requisito não deve ser um problema nas versões atuais do Windows. Para obter mais informações sobre as versões do Windows que suportam o .NET Framework 4.7.2, consulte este artigo.

Windows PowerShell requisitos e suporte de módulos em versões mais antigas do Windows estão descritos na seguinte lista:

• Windows 8.1¹

• Windows Server 2012 ou Windows Server 2012 R2¹

• Windows 7 Service Pack 1 (SP1)² ³ ⁴

• Windows Server 2008 R2 SP1² ³ ⁴

• ¹ PowerShell 7 nesta versão do Windows requer o Windows 10 Universal C Runtime (CRT).

• O suporte ² para esta versão do Windows terminou e é agora suportado apenas em máquinas virtuais do Azure.

• ³ Esta versão do Windows suporta apenas versões v2.0.3 ou anteriores do módulo.

• ⁴ Windows PowerShell 5.1 nesta versão do Windows requer o .NET Framework 4.5 ou posterior e o Windows Management Framework 5.1. Para mais informações, consulte Windows Management Framework 5.1.

Pré-requisitos do módulo Exchange Online PowerShell

Defina 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 que todos os scripts do PowerShell baixados da Internet sejam assinados por um editor confiável, execute o seguinte comando em uma janela elevada do PowerShell (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.

Ativar a autenticação Básica no WinRM

Para ligações remotas do PowerShell que não utilizam a API REST (que agora são impossíveis), o WinRM tem de permitir a autenticação Básica. Não enviamos a combinação de nome de utilizador e palavra-passe. O cabeçalho de autenticação Básico é necessário para enviar o token OAuth da sessão, porque a implementação do lado do cliente do WinRM não suporta OAuth.

Para verificar se a autenticação básica está habilitada para WinRM, execute o seguinte comando em um Prompt de comando ou Windows PowerShell:

winrm get winrm/config/client/auth

Se você não vir o valor Basic = true, precisará executar um dos seguintes comandos para habilitar a autenticação básica para WinRM:

• Em um Prompt de comando:

  winrm set winrm/config/client/auth @{Basic="true"}
  

• Em Windows PowerShell:

  winrm set winrm/config/client/auth '@{Basic="true"}'
  

• Em Windows PowerShell para modificar o registro:

  Set-ItemProperty -Path 'HKLM:\SOFTWARE\Policies\Microsoft\Windows\WinRM\Client' -Name 'AllowBasic' -Type DWord -Value '1'
  

Se a autenticação Básica do WinRM estiver desativada, receberá um dos seguintes erros ao tentar ligar-se através de uma ligação de autenticação Básica (PowerShell remoto):

O cliente WinRM não pode processar a solicitação. No momento, a autenticação básica está desabilitada na configuração do cliente. Altere a configuração do cliente e tente a solicitação novamente.

Falha ao criar Sessão do Powershell usando OAuth.

PowerShellGet para ligações à API REST no Windows

As ligações à API REST no Windows requerem o módulo PowerShellGet e, por dependência, o módulo PackageManagement. A consideração para estes módulos é mais para o PowerShell 5.1 do que para o PowerShell 7, mas todas as versões do PowerShell beneficiam de ter as versões mais recentes dos módulos instaladas. Para obter instruções de instalação e atualização, consulte Instalar o PowerShellGet no Windows.

Se não tiver o PowerShellGet instalado quando tentar criar uma ligação à API REST, receberá o seguinte erro quando tentar ligar:

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

Instalar o módulo Exchange Online PowerShell

Para instalar o módulo pela primeira vez, conclua os seguintes passos:

1. Instale ou atualize o módulo PowerShellGet conforme descrito em Instalando o PowerShellGet.

2. Feche e abra novamente a janela do Windows PowerShell.

3. Agora, pode utilizar o cmdlet Install-Module para instalar o módulo a partir do Galeria do PowerShell. Normalmente, quer a versão pública mais recente do módulo, mas também pode instalar uma versão de Pré-visualização, se estiver disponível.

   • Para instalar a versão pública mais recente do módulo, execute um dos seguintes comandos:

     • Em uma janela elevada do PowerShell (todos os usuários):

       Install-Module -Name ExchangeOnlineManagement
       

     • Somente para a conta do usuário atual:

       Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser
       

   • Para ver as versões de Pré-visualização disponíveis do módulo, execute o seguinte comando:

     Find-Module ExchangeOnlineManagement -AllVersions -AllowPrerelease
     

   • Para instalar a versão de Pré-visualização mais recente do módulo, execute um dos seguintes comandos:

     • Em uma janela elevada do PowerShell (todos os usuários):

       Install-Module -Name ExchangeOnlineManagement -AllowPrerelease
       

     • Somente para a conta do usuário atual:

       Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser -AllowPrerelease
       

   • Para instalar uma versão de Pré-visualização específica do módulo, substitua <PreviewVersion> pelo valor necessário e execute um dos seguintes comandos:

     • Em uma janela elevada do PowerShell (todos os usuários):

       Install-Module -Name ExchangeOnlineManagement -RequiredVersion <PreviewVersion> -AllowPrerelease
       

     • Somente para a conta do usuário atual:

       Install-Module -Name ExchangeOnlineManagement -RequiredVersion <PreviewVersion> -AllowPrerelease -Scope CurrentUser
       

   Quando terminar, insira Y para aceitar o contrato de licença.

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

Atualizar o módulo Exchange Online PowerShell

Se o módulo já estiver instalado no seu computador, pode utilizar os procedimentos nesta secção para atualizar o módulo.

1. Para ver a versão do módulo que está atualmente instalada e onde está instalado, execute o seguinte comando:

   Get-InstalledModule ExchangeOnlineManagement | Format-List Name,Version,InstalledLocation
   

   Se o módulo estiver instalado em C:\Program Files\WindowsPowerShell\Modules, este será instalado para todos os utilizadores. Se o módulo estiver instalado na pasta Documentos, este é instalado apenas para a conta de utilizador atual.

2. Pode utilizar o cmdlet Update-Module para atualizar o módulo a partir do Galeria do PowerShell. Normalmente, quer a versão pública mais recente do módulo, mas também pode atualizar para uma versão de Pré-visualização, caso existam.

   • Para atualizar para a versão pública mais recente do módulo, execute um dos seguintes comandos com base na forma como instalou originalmente o módulo (todos os utilizadores vs. apenas para a conta de utilizador atual):

     • Em uma janela elevada do PowerShell (todos os usuários):

       Update-Module -Name ExchangeOnlineManagement
       

     • Somente para a conta do usuário atual:

       Update-Module -Name ExchangeOnlineManagement -Scope CurrentUser
       

   • Para atualizar para uma versão de Pré-visualização do módulo, você pode atualizar para a versão de Pré-visualização mais recente disponível ou pode usar o parâmetro RequiredVersion para atualizar para uma versão de Pré-visualização específica.

     • Para ver as versões de Pré-visualização disponíveis do módulo, execute o seguinte comando:

       Find-Module ExchangeOnlineManagement -AllVersions -AllowPrerelease
       

     • Para atualizar para a versão de Pré-visualização mais recente do módulo, execute um dos seguintes comandos:

       • Em uma janela elevada do PowerShell (todos os usuários):

         Update-Module -Name ExchangeOnlineManagement -AllowPrerelease
         

       • Somente para a conta do usuário atual:

         Update-Module -Name ExchangeOnlineManagement -Scope CurrentUser -AllowPrerelease
         

     • Para atualizar para uma versão de Pré-visualização específica do módulo, substitua <PreviewVersion> pelo valor necessário e execute um dos seguintes comandos:

       • Em uma janela elevada do PowerShell (todos os usuários):

         Update-Module -Name ExchangeOnlineManagement -RequiredVersion <PreviewVersion> -AllowPrerelease
         

       • Somente para a conta do usuário atual:

         Update-Module -Name ExchangeOnlineManagement -Scope CurrentUser -RequiredVersion <PreviewVersion> -AllowPrerelease
         

   Quando terminar, insira Y para aceitar o contrato de licença.

3. Para confirmar se a atualização foi bem-sucedida, execute os seguintes comandos para verificar as informações da versão do módulo instalada:

   Import-Module ExchangeOnlineManagement; Get-Module ExchangeOnlineManagement
   

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

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

• Você recebe um dos seguintes erros:

  O módulo especificado "ExchangeOnlineManagement" com a "<versão>" do PowerShellGetFormatVersion não é suportado pela 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 transferir a partir do URI ;https://go.microsoft.com/fwlink/?LinkID=627338& clcid=0x409" a "".

  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 Windows 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 predefinido para módulos do PowerShell não está definido como PSGallery. Para corrigir esse erro, execute o seguinte comando:

  Register-PSRepository -Default
  

• Em abril de 2020, a Galeria do Windows PowerShell só oferece suporte a conexões usando TLS 1.2 ou posterior. Para obter mais informações, confira Suporte a TLS da galeria do Windows PowerShell.

  Para verificar suas configurações atuais no Microsoft .NET Framework, execute o seguinte comando no Windows PowerShell:

  [Net.ServicePointManager]::SecurityProtocol
  

  Conforme descrito no artigo de Suporte TLS da Galeria do PowerShell, para alterar temporariamente o protocolo de segurança para TLS 1.2 para instalar os módulos PowerShellGet ou ExchangeOnlineManagement, execute o seguinte comando no Windows PowerShell antes de instalar o módulo:

  [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
  

  Para habilitar permanentemente a criptografia forte no Microsoft .NET Framework versão 4.x ou posterior, execute um dos seguintes comandos com base na arquitetura do Windows:

  • x64:

    Set-ItemProperty -Path 'HKLM:\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\v4.0.30319' -Name 'SchUseStrongCrypto' -Type DWord -Value '1'
    

  • x86:

    Set-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\.NETFramework\v4.0.30319' -Name 'SchUseStrongCrypto' -Type DWord -Value '1'
    

  Para obter mais informações, confira SchUseStrongCrypto.

Desinstalar o módulo Exchange Online PowerShell

Para ver a versão do módulo que está atualmente instalada e onde está instalado, execute o seguinte comando:

Get-InstalledModule ExchangeOnlineManagement | Format-List Name,Version,InstalledLocation

Se o módulo estiver instalado em C:\Programas\WindowsPowerShell\Modules, este foi instalado para todos os utilizadores. Se o módulo estiver instalado na pasta Documentos, este foi instalado apenas para a conta de utilizador atual.

Para desinstalar o módulo, execute o seguinte comando num dos seguintes ambientes com base na forma como instalou originalmente o módulo (todos os utilizadores vs. apenas para a conta de utilizador atual):

• Numa janela elevada do PowerShell (todos os utilizadores).

• Numa janela normal do PowerShell (apenas para a conta de utilizador atual).

  Uninstall-Module -Name ExchangeOnlineManagement
  

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

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

Os cmdlets de Exchange Online tradicionais devolvem todas as propriedades de objeto possíveis, incluindo muitas propriedades em branco ou desinteressante. 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 categorizaram as propriedades de saída. Em vez de atribuirmos igual importância a todas as propriedades e de as devolvermos em todos os cenários, categorizámos propriedades relacionadas específicas em conjuntos de propriedades. Estes conjuntos de propriedades são registos de duas ou mais propriedades relacionadas no cmdlet.

Os cmdlets Get-EXO* mais utilizados e mais utilizados utilizam conjuntos de propriedades:

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

Nesses cmdlets, os conjuntos de propriedades são controlados pelos seguintes parâmetros:

• 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 estão descritos em Conjuntos de propriedades no Exchange Online cmdlets do módulo do PowerShell.
• 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 simples de propriedades necessárias para a saída do cmdlet (por exemplo, propriedades de identidade). As propriedades nos conjuntos de propriedades Mínimos também estão descritas em Conjuntos de propriedades no Exchange Online cmdlets do módulo do PowerShell.

• 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 devolvidos muito mais rapidamente.

Por exemplo, depois de ligar ao Exchange Online PowerShell, o exemplo seguinte devolve 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 devolveria, pelo menos, 230 propriedades para cada uma das primeiras 10 caixas de correio.

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

Notas de versão

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

Versão atual

Versão 3.6.0

• Get-VivaModuleFeature devolve agora informações sobre os tipos de identidades para os quais a funcionalidade suporta a criação de políticas (por exemplo, utilizadores, grupos ou todo o inquilino).
• Os cmdlets para Viva gestão de acesso a funcionalidades processam agora os desafios de afirmação de avaliação de acesso contínuo (CAE).
• Foi adicionada uma correção para o problema de compatibilidade com o módulo Microsoft.Graph.

Versões anteriores

Versão 3.5.1

• Correções de erros em Get-EXOMailboxPermission e Get-EXOMailbox.
• O módulo foi atualizado para ser executado no .NET 8, substituindo a versão anterior com base no .NET 6.
• Melhorias em Add-VivaModuleFeaturePolicy.

Versão 3.5.0

• Novo cmdlet Get-VivaFeatureCategory .
• Foi adicionado suporte para operações de política ao nível da categoria no Viva Gestão de Acesso a Funcionalidades (VFAM).
• Nova propriedade IsFeatureEnabledByDefault na saída de Get-VivaModuleFeaturePolicy. O valor desta propriedade mostra o estado de ativação predefinido para os utilizadores no inquilino quando não foram criadas políticas de inquilino ou utilizador/grupo.

Versão 3.4.0

• Correções de erros em Connect-ExchangeOnline, Get-EXORecipientPermission e Get-EXOMailboxFolderPermission.
• O parâmetro SigningCertificate no Connect-ExchangeOnline suporta agora o Modo de Idioma Restrito (CLM).

Versão 3.3.0

• Parâmetro SkipLoadingCmdletHelp no Connect-ExchangeOnline para suportar a ignorar o carregamento de ficheiros de ajuda do cmdlet.
• A variável EXO_LastExecutionStatus global está disponível para marcar a status do último cmdlet que foi executado.
• Correções de erros em Connect-ExchangeOnline e Connect-IPPSSession.
• O parâmetro IsUserControlEnabled em Add-VivaModuleFeaturePolicy e Update-VivaModuleFeaturePolicy para suportar a ativação de controlos de utilizador por política para funcionalidades integradas para Viva gestão de acesso a funcionalidades.

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 ligação da API REST para o PowerShell de Conformidade & de Segurança.
• Parâmetro ConnectionId em Get-ConnectionInformation e Disconnect-ExchangeOnline:
  • Obtenha informações de ligação para ligações à API REST específicas.
  • Desativação seletiva para ligações à API REST.
• O parâmetro SigningCertificate no Connect-ExchangeOnline permite-lhe assinar os ficheiros de formato (*. Format.ps1xml) ou ficheiros de módulo de script (.psm1) no módulo temporário que o Connect-ExchangeOnline cria com um certificado de cliente para utilizar em todas as políticas de execução do PowerShell.
• Correções de erros no Connect-ExchangeOnline.

Versão 3.1.0

• Parâmetro AccessToken disponível no Connect-ExchangeOnline.
• Correções de erros em Connect-ExchangeOnline e Get-ConnectionInformation.
• Correção de erros em Connect-IPPSSession para ligar ao PowerShell de Conformidade do & de Segurança com CertificateThumbprint.

Versão 3.0.0 (Versões de pré-visualização conhecidas como v2.0.6-PreviewX)

• Funcionalidades já descritas nas ligações da API REST na secção módulo EXO V3 :
  • Autenticação baseada em certificados para o PowerShell de Conformidade do & de Segurança (versão 2.0.6-Preview5 ou posterior).
  • O cmdlet Get-ConnectionInformation para ligações baseadas em REST (versão 2.0.6-Preview7 ou posterior).
  • O comutador SkipLoadingFormatData no cmdlet Connect-ExchangeOnline para ligações baseadas em REST (versão 2.0.6-Preview8 ou posterior).
• O parâmetro DelegatedOrganization funciona no cmdlet Connect-IPPSSession , desde que também utilize o parâmetro AzureADAuthorizationEndpointUri no comando .
• Determinados cmdlets que costumavam pedir confirmação em cenários específicos já não o fazem. Por predefinição, o cmdlet é executado até à conclusão.
• O formato do erro devolvido pela execução do cmdlet com falha é ligeiramente modificado. A exceção contém agora mais dados (por exemplo, o tipo de exceção) e o FullyQualifiedErrorId não contém o FailureCategory. O formato do erro está sujeito a modificações adicionais.

Versão 2.0.5

• Novos cmdlets Get-OwnerlessGroupPolicy e Set-OwnerlessGroupPolicy para gerir 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 dos utilizadores às funcionalidades do Headspace no Viva Insights.

Versão 2.0.4

• O PowerShell 7 é oficialmente suportado no Windows, Linux e macOS da Apple, conforme descrito na secção Pré-requisitos do módulo Exchange Online PowerShell neste artigo.

• O módulo no PowerShell 7 suporta o início de sessão único (SSO) baseado no browser e outros métodos de início de sessão. Para obter mais informações, veja Métodos de ligação exclusivos do PowerShell 7.

• Os cmdlets Get-UserAnalyticsConfig e Set-UserAnalyticsConfig foram substituídos pelos cmdlets Get-MyAnalyticsConfig e Set-MyAnalyticsConfig. Além disso, pode configurar o acesso ao nível da funcionalidade. Para saber mais, consulte Configurar MyAnalytics.

• Política em tempo real e aplicação de segurança em todas as autenticações baseadas no usuário. A Avaliação de Acesso Contínuo (CAE) está ativada no módulo. Leia mais sobre CAE aqui.

• 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 da CBA (autenticação baseada em certificado), que permite o uso de autenticação moderna em cenários de script autônomo ou de 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, veja as descrições dos parâmetros em Connect-ExchangeOnline e Autenticação apenas de aplicações para scripts autónomos no módulo Exchange Online PowerShell.
• 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 espaço de memória para aplicativos Windows PowerShell de uso alto.
• 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 a latência da primeira chamada reduzida de 8 segundos para aproximadamente 1 segundo. Os resultados reais dependem do tamanho do resultado do cmdlet e do ambiente do inquilino.

Versão 1.0.1

• Versão de Disponibilidade Geral (GA) do módulo EXO V2. Está estável e pronto para ser utilizado em ambientes de produção.
• O cmdlet Get-ExoMobileDeviceStatistics agora dá suporte ao parâmetro Identidade.
• Confiabilidade aprimorada da sessão de reconexão automática em alguns casos em que um script era executado por aproximadamente 50 minutos e acionava um erro de "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 Exchange Online PowerShell para obter os atributos que não são suportados nos 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>
• Maior fiabilidade de Get-EXOMailboxStatistics, uma vez que determinados erros de encaminhamento de pedidos que levaram a falhas foram resolvidos.
• Utilização otimizada da memória quando uma sessão é criada através da reutilização de qualquer módulo existente com uma nova sessão em vez de criar uma nova sempre 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 nos cmdlets EXO para melhorar o desempenho. As diferenças em tipos de dados não complexos entre os cmdlets remotos do PowerShell e os cmdlets V2 foram resolvidos para permitir a migração contínua dos scripts de gerenciamento.

Versão 0.3582.0

• Suporte para prefixo durante a criação da sessão:
  • Só pode criar uma sessão de cada vez que contenha cmdlets com prefixo.
  • Os cmdlets EXO V2 não têm prefixo porque já têm o prefixo EXO, pelo que não utilize EXO como prefixo.
• Use cmdlets EXO V2 mesmo se a autenticação básica do WinRM estiver desabilitada na máquina do cliente. As ligações remotas do PowerShell requerem Autenticação Básica do WinRM e os cmdlets remotos do PowerShell não estão disponíveis se a Autenticação Básica estiver desativada no WinRM.
• O parâmetro de identidade para cmdlets V2 suporta agora o Nome e o Alias. A utilização de Alias ou Nome reduz o desempenho dos cmdlets V2, pelo que não recomendamos que os utilize.
• 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 tipos de dados diferentes e planeamos processá-los nos próximos meses.
• Erro corrigido: problema frequente de restabelecimento de ligação de sessões quando Connect-ExchangeOnline foi 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.
• Foi corrigido um problema em Get-Help em que o parâmetro Online estava a redirecionar para uma página inexistente com o código de erro 400.

Versão 0.3527.3

• Adicionado suporte para gerenciar o Exchange para um locatário diferente usando o fluxo de delegação.
• Funciona em conjunto com outros módulos do PowerShell numa ú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 erros: os cmdlets remotos do PowerShell falham intermitentemente devido à hora em que a diferença entre a expiração do token e a Sessão fica inativa.
• Atualização de segurança importante.
• Correção de bugs e melhorias.