Sobre o módulo do Powershell do Exchange Online V2

O módulo do PowerShell do Exchange Online V2 (abreviado como módulo EXO V2) usa autenticação moderna e funciona com autenticação multifator (MFA) para se conectar a todos os ambientes do PowerShell relacionados ao Exchange no Microsoft 365: PowerShell do Exchange Online, PowerShell do Centro de Conformidade e Segurança, e PowerShell autônomo da Proteção do Exchange Online (EOP).

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

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.

Relatar erros e problemas no módulo EXO V2

Ao relatar um problema no exocmdletpreview[at]service[dot]microsoft[dot]com, certifique-se de incluir os arquivos de log na sua mensagem de e-mail. Para gerar os arquivos de log, substitua <Path to store log file> pela pasta de saída desejada e execute o seguinte comando:

Connect-ExchangeOnline -EnableErrorReporting -LogDirectoryPath <Path to store log file> -LogLevel All

Observação

A versão mais recente do módulo EXO V2 e o uso frequente dos cmdlets Connect-ExchangeOnline e Disconnect-ExchangeOnline em uma única sessão ou script do PowerShell pode levar a um vazamento de memória. A melhor maneira de evitar esse problema é usar o parâmetro CommandName no cmdlet Connect-ExchangeOnline para limitar os cmdlets usados na sessão.

Como funciona o módulo EXO V2

O módulo contém um pequeno conjunto de cmdlets exclusivos do Exchange Online PowerShell que são otimizados para cenários de recuperação de dados em massa (imagine: milhares e milhares de objetos). Ao abrir o módulo pela primeira vez, você verá apenas esses cmdlets exclusivos. Depois de se conectar à sua organização do Exchange Online, você verá todos os cmdlets conhecidos disponíveis no PowerShell do Exchange Online.

O módulo usa a autenticação moderna para todos os cmdlets. Não é possível usar a autenticação Básica no módulo EXO V2; no entanto, você ainda precisa habilitar a configuração de autenticação básica no WinRM, conforme explicado mais adiante neste artigo.

Os cmdlets do Exchange Online no módulo EXO V2 devem substituir seus equivalentes mais antigos e menos eficientes, mas os cmdlets equivalentes ainda estarão disponíveis (depois que você se conectar).

Os cmdlets do Exchange Online PowerShell que estão disponíveis apenas no módulo EXO V2 estão listados na tabela a seguir:

Cmdlet do módulo EXO V2 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 à conexão que estão disponíveis no módulo EXO V2 estão listados na tabela a seguir:

Cmdlet do módulo EXO V2 Cmdlet relacionado mais antigo:
Connect-ExchangeOnline Connect-EXOPSSession

ou

New-PSSession

Connect-IPPSSession Connect-IPPSSession
Disconnect-ExchangeOnline Remove-PSSession

Os cmdlets do Exchange Online que estão disponíveis apenas no módulo EXO V2 estão listados na tabela a seguir:

Cmdlet do módulo EXO V2 Comentários
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.

Atualizações para a versão 2.0.6

A versão 2.0.6-Preview6 do módulo EXO V2 já está disponível. Esta versão de visualização melhora os recursos históricos do módulo com os seguintes recursos:

  • A versão 2.0.6 inclui cmdlets que são apoiados pela API REST:

    • Os cmdlets da API REST não dependem da sessão remota do PowerShell, portanto, o PowerShell em seu computador cliente não precisa de autenticação básica no WinRM.
    • Os cmdlets da API REST funcionam exatamente como seus equivalentes remotos do PowerShell, portanto, você não precisa atualizar nenhum de seus scripts.
    • Praticamente todos os cmdlets remotos do PowerShell disponíveis agora são apoiados pela API REST. Alguns cmdlets podem aparecer ou desaparecer temporariamente da disponibilidade usando a API REST à medida que encontramos e corrigimos problemas.
  • A opção UseRPSSession em Connect-ExchangeOnline concede acesso a todos os cmdlets remotos existentes do PowerShell como antes:

    • A opção UseRPSSession exige uma autenticação básica no WinRM no seu computador cliente.
    • Se você não usar a opção UseRPSSession ao se conectar, poderá usar somente os cmdlets da API REST.
  • Alguns cmdlets da API REST foram 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.

    • 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
    • A opção UseCustomRouting está disponível apenas nos seguintes cmdlets da 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

      Use a opção UseCustomRouting experimentalmente e informe quaisquer problemas que encontrar.

Instalar e manter o módulo EXO V2

Você pode baixar o módulo EXO V2 da galeria do PowerShell em https://www.powershellgallery.com/packages/ExchangeOnlineManagement/.

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

Sistemas operacionais com suporte para o módulo EXO V2

A versão mais recente do módulo EXO V2 é oficialmente compatível com PowerShell 7 no Windows, Linux e Apple macOS.

Especificamente, a versão 2.0.4 ou posterior do módulo EXO V2 é compatível com 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 EXO V2 é compatível com as 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.

Observação

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 você pode fazer os pré-requisitos regulares do PowerShell e instalar o módulo EXO V2.

Linux

O módulo EXO V2 é oficialmente compatível com as seguintes distribuições do Linux:

  • Ubuntu 18.04 LTS
  • Ubuntu 20.04 LTS

Se você tiver problemas para usar o módulo EXO V2 em outras distribuições do Linux, envie um email para o seguinte endereço: exocmdletpreview[at]service[dot]microsoft[dot]com. O endereço de email é ofuscado propositadamente para evitar spam.

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 você pode fazer os pré-requisitos regulares do PowerShell e instalar o módulo EXO V2.

Observação

Se você se conectar ao PowerShell do Exchange Online de uma rede que está atrás de um servidor proxy, a v2.0.5 ou versões anteriores do módulo não funcionarão no Linux. Você precisa usar a v2.0.6 ou posterior no Linux para se conectar de uma rede que está atrás de um servidor proxy.

Windows

Todas as versões do módulo EXO V2 são compatíveis com Windows PowerShell 5.1. O PowerShell 7 no Windows requer a versão 2.0.4 ou posterior do módulo EXO V2.

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

  • Windows 11
  • Windows 10
  • Windows 8.14
  • Windows Server 2019
  • Windows Server 2016
  • Windows Server 2012 ou Windows Server 2012 R2 4
  • Windows 7 Service Pack 1 (SP1) 1, 2, 3
  • Windows Server 2008 R2 SP1 1, 2, 3

1 Esta versão do Windows atingiu o fim do suporte e agora é compatível apenas com as máquinas virtuais do Azure.

2 Esta versão do Windows não suporta a versão 2.0.4 ou posterior do módulo EXO V2. Somente a versão 2.0.3 ou anterior é suportada.

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

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

Pré-requisitos para o módulo EXO V2

Observação

As configurações descritas nesta seção são necessárias em todas as versões do Windows PowerShell em todos os sistemas operacionais.

  • 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 é. Você receberá o seguinte erro ao tentar se conectar:

    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.

  • Habilitar a Autenticação básica no WinRM:

    Observação

    Conforme descrito anteriormente neste artigo, a v2.0.6 do módulo EXO V2 não requer Autenticação básica no WinRM para cmdlets da API REST.

    O WinRM precisa permitir a autenticação básica. Não enviamos a combinação com o nome de usuário e a senha, mas o cabeçalho de Autenticação básica é necessário para enviar o token OAuth da sessão, uma vez que a implementação do WinRM do lado do cliente não tem suporte para 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:

    Observação

    Você deve habilitar temporariamente o WinRM para executar os seguintes comandos WinRM. Você pode habilitar o WinRM executando o comando: winrm quickconfig.

    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 para WinRM estiver desabilitada, você receberá um dos seguintes erros ao tentar se conectar:

    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.

Dica

Está tendo problemas? Peça ajuda nos fóruns do Exchange. Visite os fóruns em: Exchange Onlineou Proteção do Exchange Online.

Instalar o módulo EXO V2

Para instalar o módulo EXO v2 pela primeira vez, execute as seguintes etapas:

  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, você pode usar o cmdlet Install-Module para instalar o módulo EXO V2 na Galeria do PowerShell. Geralmente, você vai querer a versão pública mais recente do módulo, mas também poderá instalar uma versão de visualização, se houver uma 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 instalar uma versão prévia 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 EXO V2

Se o módulo já estiver instalado em seu computador, você poderá executar os comandos a seguir para ver a versão instalada no momento e atualizá-la para a versão mais recente da Galeria do PowerShell:

  1. Para ver a versão do módulo EXO instalada no momento, execute os comandos a seguir:

    Import-Module ExchangeOnlineManagement; Get-Module ExchangeOnlineManagement
    
  2. Você pode usar o cmdlet Update-Module para atualizar o módulo EXO V2 da Galeria do PowerShell. Geralmente, você vai querer a versão pública mais recente do módulo, mas também poderá atualizar para uma versão prévia, se houver uma disponível.

    • Para atualizar para a versão pública mais recente do módulo, execute um dos seguintes comandos com base em como você instalou o módulo originalmente (em uma janela elevada do PowerShell vs. Scope CurrentUser):

      • 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, execute o comando: Find-Module ExchangeOnlineManagement -AllVersions -AllowPrerelease.

      Execute um dos seguintes comandos com base em como você instalou originalmente o módulo (em uma janela elevada do PowerShell vs. Scope CurrentUser):

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

        Update-Module -Name ExchangeOnlineManagement -AllowPrerelease [-RequiredVersion <PreviewVersion>]
        
      • Somente para a conta do usuário atual:

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

    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.

Solucionar problemas de instalação do módulo EXO V2

  • Você recebe um dos seguintes erros:

    O módulo especificado 'ExchangeOnlineManagement' com PowerShellGetFormatVersion '<version>' 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 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 a 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.

  • 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.

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

    Register-PSRepository -Default
    

Desinstalar o módulo EXO V2

Para desinstalar o módulo, execute um dos seguintes comandos com base em como você instalou originalmente o módulo (em uma janela elevada do Windows PowerShell vs.Scope CurrentUser):

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

    Uninstall-Module -Name ExchangeOnlineManagement
    
  • Somente para a conta do usuário 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 EXO V2

Os cmdlets tradicionais do Exchange Online retornam todas as propriedades de objeto possíveis na saída, incluindo várias propriedades que geralmente estão em branco ou não são interessantes em muitos cenários. 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* do módulo têm propriedades de saída categorizadas. Em vez de dar a todas as propriedades a mesma importância e devolvê-las em todos os cenários, categorizamos as propriedades relacionadas específicas em conjuntos de propriedades. Em suma, esses conjuntos de propriedades são classificações de duas ou mais propriedades relacionadas no cmdlet.

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

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

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ínimos também são descritas em Conjuntos de propriedades nos cmdlets do PowerShell do Exchange Online V2.

  • 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 conterá muito menos propriedades, e o tempo necessário para retornar esses resultados será muito mais rápido.

Por exemplo, depois de conectar-se ao PowerShell do Exchange Online, o exemplo a seguir retorna apenas as propriedades no conjunto de propriedades mínimo para as dez primeiras 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 dez primeiras caixas de correio.

Observação

Embora o parâmetro PropertySets aceite o valor All, não é recomendável usar esse valor para recuperar todas as propriedades, porque ele torna o comando mais lento e reduz a confiabilidade. Use sempre os parâmetros PropertySets e Properties para recuperar o número mínimo de propriedades necessárias para o seu cenário.

Para obter mais informações sobre a filtragem no módulo EXO V2, confira Filtros no módulo do Exchange Online V2.

Notas de versão

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

Versão atual: Versão 2.0.5

  • Novos cmdlets Get-OwnerlessGroupPolicy e Set-OwnerlessGroupPolicy para gerenciar grupos Microsoft 365 sem proprietários.

    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 de Headspace nos Insights do Microsoft Viva.

Versões anteriores

Versão 2.0.4

  • PowerShell 7 é oficialmente compatível com Windows, Linux e Apple macOS, conforme descrito na seção Pré-requisitos para o módulo EXO V2 deste artigo.

  • O módulo EXO V2 no Windows PowerShell 7 oferece suporte a logon único (SSO) baseado em navegador e outros métodos de logon. Para mais informações, consulte PowerShell 7 log nas experiências.

  • Os cmdlets Get-UserAnalyticsConfig e Set-UserAnalyticsConfig foram substituídos pelos cmdlets Get-MyAnalyticsConfig e Set-MyAnalyticsConfig. Além disso, você pode configurar o acesso no nível do recurso. Para obter mais informações, consulte Configurar o MyAnalytics.

  • Política em tempo real e aplicação de segurança em todas as autenticações baseadas no usuário. Avaliação de Acesso Contínuo (CAE) foi habilitada no Módulo EXO V2. 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 autenticação baseada em certificado (CBA), que permite usar a autenticação moderna em cenários de script autônomo ou de automação em segundo plano. Os locais de armazenamento de certificados 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, confira as descrições de parâmetro no Connect-ExchangeOnline e autenticação somente de aplicativo para scripts não acompanhados no módulo EXO v2.
  • 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 dependerão do tamanho do resultado do cmdlet e do ambiente do locatário.

Versão 1.0.1

  • Versão de Disponibilidade Geral (GA) do módulo EXO V2. Ele é estável e está pronto para ser usado 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 Filtros no módulo EXO V2 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 EXOMailboxStatistics pois determinados erros de roteamento de solicitação que levaram a falha foram resolvidas.
  • Uso otimizado da memória quando uma sessão é criada, usando novamente qualquer módulo existente com uma nova sessão em vez de criar um novo toda vez que a 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 não eram propositadamente compatíveis com 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 de sessão.
    • Você pode criar apenas uma sessão por vez que contenha cmdlets prefixados.
    • Observe que os cmdlets EXO V2 não serão prefixados já que já têm o prefixo EXO. Portanto, não use EXO como um prefixo.
  • Use cmdlets EXO V2 mesmo se a autenticação básica do WinRM estiver desabilitada na máquina do cliente. Observe que os cmdlets remotos do PowerShell requerem a autenticação básica do WinRM e não estarão disponíveis se ela estiver desabilitada.
  • O parâmetro de identidade para cmdlets V2 suporta Nome e Alias. Observe que usar Alias ou Nome reduz 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 que têm tipos de dados diferentes e planejamos tratá-los nos próximos meses.
  • Bug corrigido: sessões frequentes reconectam o problema quando o 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.
  • Correção de um problema em Get-Help em que o parâmetro Online estava redirecionando 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 em uma janela do PS.
  • 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 bugs: os cmdlets remotos do PowerShell falham de forma sincronizada devido à diferença de tempo entre a validade do token e a PSSession ficando ociosa.
  • Atualização de segurança importante.
  • Correção de bugs e melhorias.