Use Exchange Online PowerShell para exibir informações da caixa de correio do Microsoft 365 ou Office 365
Importante
Confira o novo centro de administração do Exchange! A experiência é moderna, inteligente, acessível e melhor. Personalize seu painel, gerencie a migração entre locatários, experimente o recurso Grupos aprimorado e muito mais. Experimente agora!
Os administradores podem aprender a usar Exchange Online PowerShell para exibir informações sobre caixas de correio em sua organização microsoft 365 ou Office 365.
Para dar uma ideia de algumas das coisas que você pode fazer com o PowerShell no Microsoft 365 e Office 365, vamos dar uma olhada nas caixas de correio do usuário no Exchange Online PowerShell.
Antes de começar
Para se conectar ao PowerShell do Exchange Online, confira Conectar ao PowerShell do Exchange Online.
Exibir informações da caixa de correio com Exchange Online PowerShell
É fácil obter informações sobre a caixa de correio de um só usuário. Por exemplo, este é um comando que retorna algumas informações sobre a caixa de correio de Paulo Araújo:
Get-Mailbox -Identity "Ken Myer"
Este comando retornará algo similar a isso:
Name Alias ServerName ProhibitSendQuota
---- ----- ---------- -----------------
kenmyer kenmyer bn1pr02mb038 49.5 GB (53,150,220,288 bytes)
Você pode ver coisas como o alias de Ken e sua cota de tamanho de caixa de correio. Mas há muito mais informações associadas a uma caixa de correio Exchange Online do que apenas as quatro propriedades retornadas pelo cmdlet Get-Mailbox.
Veja um exemplo de comando que exibe todas as informações para uma caixa de correio específica:
Get-Mailbox -Identity "Ken Myer" | Format-List
O comando instrui Exchange Online PowerShell a retornar todas as propriedades disponíveis para a caixa de correio em uma lista. Há cerca de 200 propriedades e valores de propriedade diferentes. Você também pode usar os cmdlets Format-List e Format-Table para retornar apenas valores de propriedade específicos. Por exemplo, você também pode ver as propriedades relacionadas à retenção de litígio de Paulo Araújo com estes comandos:
Get-Mailbox -Identity "Ken Myer" | Format-List DisplayName, LitigationHoldEnabled, LitigationHoldDate, LitigationHoldOwner, LitigationHoldDuration
Você também pode usar caracteres curinga ao trabalhar com o cmdlet Format-List . Por exemplo, todas as propriedades de contencioso começam com as letras lit. Isso significa que é possível recuperar essas informações com este comando:
Get-Mailbox -Identity "Ken Myer" | Format-List DisplayName, Lit*
Este comando informa ao Get-Mailbox para recuperar o valor da propriedade DisplayName do Ken, juntamente com os valores de todas as propriedades que têm nomes que começam com as letras lit. Aqui está um exemplo do que recebemos de volta:
DisplayName : Ken Myer
LitigationHoldEnabled : False
LitigationHoldDate :
LitigationHoldOwner :
LitigationHoldDuration : Unlimited
Você pode retornar informações sobre várias caixas de correio deixando de fora o parâmetro Identidade . Este exemplo retorna as propriedades DisplayName e LitigationHoldEnabled para todas as caixas de correio:
Get-Mailbox -ResultSize unlimited | Format-Table DisplayName, LitigationHoldEnabled -Auto
Em muitos casos, você só deseja examinar um subconjunto de suas caixas de correio. Por exemplo, suponha que seja solicitado que você apresente uma lista de todas as caixas de correio atribuídas a uma suspensão de litígio. Você pode usar o cmdlet Where-Object em conjunto com o cmdlet Get-Mailbox . O cmdlet Where-Object precisa de uma frase de filtro para dizer Exchange Online PowerShell em qual conjunto de caixas de correio você está interessado.
Em seu formulário mais simples, as frases de filtro usam a sintaxe "<PropertyName> -<ComparisonOperator> <PropertyValue>".
Alguns operadores de comparação comumente usados são:
eq(iguais; não sensíveis a maiúsculas de maiúsculas e minúsculas)ne(não é igual; não diferencia maiúsculas de maiúsculas de minúsculas)gt(maior que)lt(menor que)
Para obter uma lista completa de operadores de comparação, consulte Where-Object.
Os valores para <PropertyValue> dependem da propriedade e podem ser valores como cadeias de caracteres, números, valores boolianos ( $True ou $False), ou nenhum valor ( $Null). Os valores de texto com espaços exigem aspas em torno do valor. Valores numéricos, valores boolianos e $Null não exigem aspas em torno do valor.
Retornando ao nosso exemplo de todas as caixas de correio atribuídas a uma retenção de litígio, a frase de filtro é "LitigationHoldEnabled -eq $True":
O nome da propriedade é
LitigationHoldEnabled.O operador de comparação é
eq.O valor da propriedade que estamos procurando é
$True.
Depois de ter a frase de filtro, você poderá construir a parte Where-Object do comando usando essa sintaxe:
Get-Mailbox -ResultSize unlimited | Where-Object {$_.<Filter Phrase>}
Aqui está o comando para nosso exemplo:
Get-Mailbox -ResultSize unlimited | Where-Object {$_.LitigationHoldEnabled -eq $True}
Há outro exemplo, suponha que você quisesse garantir que todos os seus usuários tivessem a regra de lixo eletrônico habilitada. Aqui está um comando rápido para localizar os usuários que não têm essa regra habilitada:
Get-Mailbox -ResultSize unlimited | Get-MailboxJunkEmailConfiguration | Where-Object {$_.Enabled -eq $False}
Este é apenas um exemplo. Se você quiser exibir um conjunto de caixas de correio com base em uma configuração e não puder filtrar essa configuração no Centro de administração do Microsoft 365, execute estas etapas:
Localize a propriedade da caixa de correio que corresponde à configuração em que você está interessado executando o comando
Get-Mailbox -Identity "<MailboxIdentity" | Select-Object *para listar todas as propriedades de uma caixa de correio.<MailboxIdentity>é qualquer identificador exclusivo para a caixa de correio (nome, endereço de email, alias etc.)Crie seu comando Office 365 PowerShell assim:
Get-Mailbox -ResultSize unlimited | Where-Object {$_.<PropertyName> -<ComparisonOperator> <PropertyValue>}