Get-Mailbox

O parâmetro Anr especifica uma cadeia de caracteres na qual executar uma pesquisa ANR (resolução de nomes ambíguos). Você pode especificar uma cadeia de caracteres parcial para objetos com um atributo correspondente a esta cadeia de caracteres. Os atributos padrão pesquisados são:

• CommonName (CN)
• DisplayName
• FirstName
• Sobrenome
• Alias

Este parâmetro está disponível somente no Exchange local.

O comutador Arbitragem especifica se pretende devolver apenas caixas de correio de arbitragem nos resultados. Não é preciso especificar um valor com essa opção.

As caixas de correio de arbitragem são caixas de correio do sistema que são utilizadas para armazenar diferentes tipos de dados do sistema e para gerir o fluxo de trabalho de aprovação de mensagens.

Para devolver caixas de correio de arbitragem que são utilizadas para armazenar dados ou definições de registo de auditoria, não utilize este comutador. Em vez disso, utilize os comutadores AuditLog ou AuxAuditLog.

O comutador Arquivo especifica se pretende devolver apenas caixas de correio que tenham um arquivo ativado nos resultados. Não é preciso especificar um valor com essa opção.

Este parâmetro está disponível somente no Exchange local.

O comutador AuditLog especifica se pretende devolver apenas caixas de correio de registo de auditoria nos resultados. Não é preciso especificar um valor com essa opção.

As caixas de correio de registo de auditoria são caixas de correio de arbitragem que são utilizadas para armazenar as definições do registo de auditoria.

Para devolver outros tipos de caixas de correio de arbitragem, não utilize este comutador. Em vez disso, utilize o comutador Arbitragem.

Este parâmetro está disponível somente no Exchange local.

O comutador AuxAuditLog especifica se pretende devolver apenas caixas de correio de registo de auditoria auxiliares nos resultados. Não é preciso especificar um valor com essa opção.

As caixas de correio de registo de auditoria são caixas de correio de arbitragem que são utilizadas para armazenar as definições do registo de auditoria.

Para devolver outros tipos de caixas de correio de arbitragem, não utilize este comutador. Em vez disso, utilize o comutador Arbitragem.

Este parâmetro está disponível somente no Exchange local.

O parâmetro Credential especifica o nome de utilizador e a palavra-passe utilizados para executar este comando. Normalmente, você usa esse parâmetro em scripts ou quando você precisa fornecer credenciais diferentes que têm as permissões necessárias.

Um valor para esse parâmetro requer o cmdlet Get-Credential. Para pausar o comando e receber uma solicitação de credenciais, use o valor (Get-Credential). Ou, antes de executar esse comando, armazene as credenciais em uma variável (por exemplo, $cred = Get-Credential) e, em seguida, use o nome da variável ($cred) para esse parâmetro. Para saber mais, confira Obter credencial.

Este parâmetro está disponível somente no Exchange local.

O parâmetro Database filtra os resultados por banco de dados de caixa de correio. Quando você usa esse parâmetro, apenas as caixas de correio no banco de dados especificados são incluídas nos resultados. É possível usar qualquer valor que identifique o banco de dados com exclusividade. Por exemplo:

• Nome
• DN (nome diferenciado)
• GUID

Não é possível usar este parâmetro com os parâmetros Anr, Identity ou Server

Este parâmetro está disponível somente no Exchange local.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

O parâmetro Filter utiliza a sintaxe OPATH para filtrar os resultados pelas propriedades e valores especificados. Os critérios de pesquisa utilizam a sintaxe "Property -ComparisonOperator 'Value'".

• Coloque todo o filtro OPATH entre aspas " ". Se o filtro contiver valores de sistema (por exemplo, $true, $falseou $null), utilize aspas únicas ' ' em vez disso. Embora este parâmetro seja uma cadeia (não um bloco de sistema), também pode utilizar chavetas { }, mas apenas se o filtro não contiver variáveis.
• A propriedade é uma propriedade filtráveis. Para obter mais informações sobre as propriedades filtráveis, veja Propriedades filtráveis para o parâmetro Filter.
• ComparisonOperator é um operador de comparação OPATH (por exemplo -eq , para igual e -like para comparação de cadeias). Para obter mais informações sobre operadores de comparação, veja about_Comparison_Operators.
• Valor é o valor da propriedade a procurar. Coloque os valores de texto e as variáveis entre plicas ('Value' ou '$Variable'). Se um valor de variável contiver aspas únicas, terá de identificar (escape) as aspas únicas para expandir a variável corretamente. Por exemplo, em vez de '$User', utilize '$($User -Replace "'","''")'. Não coloque números inteiros ou valores do sistema entre aspas (por exemplo, utilize 500, $true, $falseou $null em alternativa).

Pode encadear múltiplos critérios de pesquisa em conjunto com os operadores lógicos -and e -or. Por exemplo: "Criteria1 -and Criteria2" ou "(Criteria1 -and Criteria2) -or Criteria3".

Para obter informações detalhadas sobre filtros OPATH no Exchange, veja Informações adicionais sobre sintaxe OPATH.

O comutador GroupMailbox especifica se pretende devolver apenas Grupos do Microsoft 365 nos resultados. Não é preciso especificar um valor com essa opção.

O parâmetro Identity especifica a caixa de correio que você deseja exibir. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:

• Nome
• Alias
• Nome diferenciado (DN)
• Nome diferenciado (DN)
• Domínio\Nome de Utilizador
• Endereço de email
• GUID
• LegacyExchangeDN
• SamAccountName
• ID de usuário ou nome UPN

Não é possível usar este parâmetro com os parâmetros Anr, Database, MailboxPlan ou Server.

Este parâmetro está disponível somente no Exchange local.

O comutador IgnoreDefaultScope indica ao comando para ignorar a definição de âmbito de destinatário predefinida para a sessão do Exchange PowerShell e utilizar toda a floresta como âmbito. Não é preciso especificar um valor com essa opção.

Este comutador permite que o comando aceda a objetos do Active Directory que não estão atualmente disponíveis no âmbito predefinido, mas também introduz as seguintes restrições:

• Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.
• Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.

Esse parâmetro só está disponível no serviço baseado em nuvem.

O comutador InactiveMailboxOnly especifica se pretende devolver apenas caixas de correio inativas nos resultados. Não é preciso especificar um valor com essa opção.

Uma caixa de correio inativa é uma caixa de correio colocada em Suspensão de Litigação ou Suspensão no Local antes de uma exclusão reversível. O conteúdo de uma caixa de correio inativa é preservado até que a retenção seja removida.

Para incluir caixas de correio ativas e inativas nos resultados, não utilize este comutador. Em vez disso, utilize o comutador IncludeInactiveMailbox.

Esse parâmetro só está disponível no serviço baseado em nuvem.

{{ Fill IncludeAcceptMessagesOnlyFromDLMembersWithDisplayNames Description }}

Esse parâmetro só está disponível no serviço baseado em nuvem.

{{ Fill IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames Description }}

Esse parâmetro só está disponível no serviço baseado em nuvem.

{{ Fill IncludeAcceptMessagesOnlyFromWithDisplayNames Description }}

Esse parâmetro só está disponível no serviço baseado em nuvem.

{{ Fill IncludeEmailAddressDisplayNames Description }}

Esse parâmetro só está disponível no serviço baseado em nuvem.

{{ Fill IncludeGrantSendOnBehalfToWithDisplayNames Description }}

Esse parâmetro só está disponível no serviço baseado em nuvem.

A opção IncludeInactiveMailbox especifica se é necessário incluir caixas de correio inativas nos resultados. Não é preciso especificar um valor com essa opção.

Uma caixa de correio inativa é uma caixa de correio colocada em Suspensão de Litigação ou Suspensão no Local antes de uma exclusão reversível. O conteúdo de uma caixa de correio inativa é preservado até que a retenção seja removida.

Para devolver apenas caixas de correio inativas nos resultados, não utilize este comutador. Em vez disso, utilize o comutador InactiveMailboxOnly.

Esse parâmetro só está disponível no serviço baseado em nuvem.

O parâmetro MailboxPlan filtra os resultados por plano de caixa de correio. Quando você usa esse parâmetro, apenas as caixas de correio que são atribuídas ao plano de caixa de correio são retornadas nos resultados. É possível usar qualquer valor que identifique o plano de caixa de correio com exclusividade. Por exemplo:

• Nome
• Alias
• Nome para exibição
• DN (nome diferenciado)
• GUID

Um plano de caixa de correio especifica as permissões e os recursos disponíveis para um usuário de caixa de correio em organizações baseadas em nuvem. Você pode ver os planos de caixa de correio disponíveis usando o cmdlet Get-MailboxPlan.

Não é possível usar este parâmetro com os parâmetros Anr ou Identity.

O Comutador de migração especifica se pretende devolver apenas caixas de correio de migração nos resultados. Não é preciso especificar um valor com essa opção.

Este parâmetro está disponível somente no Exchange local.

O comutador Monitorização especifica se pretende devolver apenas caixas de correio de monitorização nos resultados. Não é preciso especificar um valor com essa opção.

As caixas de correio de monitorização estão associadas à disponibilidade gerida e ao serviço Exchange Health Manager e têm um valor de propriedade RecipientTypeDetails de MonitoringMailbox.

O parâmetro OrganizationalUnit filtra os resultados com base na localização do objeto no Active Directory. Somente objetos que existem na localização especificada são retornados. A entrada válida para este parâmetro é uma unidade organizacional (UO) ou domínio que é devolvido pelo cmdlet Get-OrganizationalUnit. É possível usar qualquer valor que identifique a UO ou o domínio com exclusividade. Por exemplo:

• Nome
• Nome
• Nome diferenciado (DN)
• GUID

O comutador PublicFolder especifica se pretende devolver apenas caixas de correio de pastas públicas nos resultados. Não é preciso especificar um valor com essa opção.

As caixas de correio de pasta pública são caixas de correio desenvolvidas especialmente para armazenar a hierarquia e o conteúdo das pastas públicas.

Este parâmetro está disponível somente no Exchange local.

A opção ReadFromDomainController especifica se as informações devem ser lidas de um controlador de domínio no domínio do usuário. Não é preciso especificar um valor com essa opção.

O comando: Set-AdServerSettings -ViewEntireForest $true para incluir todos os objetos na floresta, é necessário o comutador ReadFromDomainController. Caso contrário, o comando poderá utilizar um catálogo global que contenha informações desatualizadas. Além disso, poderá ter de executar várias iterações do comando com o comutador ReadFromDomainController para obter as informações.

Por predefinição, o âmbito do destinatário está definido como o domínio que aloja os seus servidores Exchange.

O parâmetro RecipientTypeDetails filtra os resultados pelo subtipo de caixa de correio especificado. Os valores válidos são:

• DiscoveryMailbox
• Caixa de Correio de Equipamento
• GroupMailbox (Exchange 2013 ou posterior e cloud)
• LegacyMailbox
• LinkedMailbox
• LinkedRoomMailbox (Exchange 2013 ou posterior e cloud)
• RoomMailbox
• SchedulingMailbox (Exchange 2016 ou posterior e cloud)
• SharedMailbox
• TeamMailbox (Exchange 2013 ou posterior e cloud)
• UserMailbox

Vários valores, separados por vírgulas, podem ser especificados.

Este parâmetro está disponível somente no Exchange local.

O comutador RemoteArchive especifica se pretende devolver apenas caixas de correio de arquivo remoto nos resultados. Não é preciso especificar um valor com essa opção.

As caixas de correio de arquivo remoto são caixas de correio de arquivo no serviço baseado na nuvem que estão associadas a utilizadores de caixas de correio em organizações do Exchange no local.

O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Caso pretenda retornar todas as solicitações correspondentes à consulta, use unlimited como valor desse parâmetro. O valor padrão é 1000.

Este parâmetro está disponível somente no Exchange local.

O parâmetro Server filtra os resultados pelo servidor Exchange. Quando utiliza este parâmetro, apenas as caixas de correio no servidor Exchange especificado são incluídas nos resultados.

É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:

• Nome
• FQDN
• DN (nome diferenciado)
• DN Herdado do Exchange

Não é possível usar este parâmetro com os parâmetros Anr, Database ou Identity

As propriedades ServerName e ServerLegacyDN de uma caixa de correio podem não ser atualizadas imediatamente depois que uma caixa de correio é movida em um grupo de disponibilidade de banco de dados (DAG). Para obter os valores mais atualizados para estas propriedades da caixa de correio, execute o comando Get-Mailbox <Identity> | Get-MailboxStatistics | Format-List Name,ServerName,ServerLegacyDN.

Nota: o resultado deste parâmetro pode ser um valor legado antes da migração. Para obter melhores resultados, utilize o parâmetro Base de Dados.

Esse parâmetro só está disponível no serviço baseado em nuvem.

O comutador SoftDeletedMailbox especifica se pretende devolver apenas caixas de correio eliminadas de forma recuperável nos resultados. Não é preciso especificar um valor com essa opção.

Caixas de correio excluídas de forma flexível são caixas de correio excluídas e que ainda podem ser recuperadas.

O parâmetro SortBy especifica a propriedade pela qual classificar os resultados. Você pode classificar apenas por uma propriedade de cada vez. Os resultados são classificados em ordem crescente.

Se a vista predefinida não incluir a propriedade pela qual está a ordenar, pode acrescentar o comando com | Format-Table -Auto Property1,Property2,...PropertyX. para criar uma nova vista que contenha todas as propriedades que pretende ver. Os caracteres curinga (*) nos nomes de propriedade são permitidos.

É possível classificar pelas seguintes propriedades:

• Nome
• DisplayName
• Alias
• Office
• ServerLegacyDN

Este parâmetro está disponível somente no Exchange local.

Esse parâmetro está reservado para uso interno da Microsoft.