Compartilhar via

Get-MailboxLocation

Módulo:
Exchange PowerShell

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e definições podem ser exclusivos de um ambiente ou outro.

Utilize o cmdlet Get-MailboxLocation para ver as informações de localização da caixa de correio no Exchange Online.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Sintaxe

DatabaseSet 

Get-MailboxLocation
    -Database <DatabaseIdParameter>
    [-Confirm]
    [-MailboxLocationType <MailboxLocationType>]
    [-ResultSize <Unlimited>]
    [-WhatIf]
    [<CommonParameters>]

Identity 

Get-MailboxLocation
    -Identity <MailboxLocationIdParameter>
    [-Confirm]
    [-MailboxLocationType <MailboxLocationType>]
    [-ResultSize <Unlimited>]
    [-WhatIf]
    [<CommonParameters>]

User 

Get-MailboxLocation
    -User <UserIdParameter>
    [-IncludePreviousPrimary]
    [-Confirm]
    [-MailboxLocationType <MailboxLocationType>]
    [-ResultSize <Unlimited>]
    [-WhatIf]
    [<CommonParameters>]

Description

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Get-MailboxLocation -User chris@contoso.com

No Exchange Online, este exemplo devolve as informações de localização da caixa de correio para o utilizador chris@contoso.com.

Exemplo 2

Get-MailboxLocation -Identity e15664af-82ed-4635-b02a-df7c2e03d950

Em Exchange Server ou Exchange Online, este exemplo devolve as informações de localização da caixa de correio para o GUID da caixa de correio especificada (o valor da propriedade ExchangeGuid dos resultados de Get-Mailbox -Identity <MailboxIdentity> | Format-List ExchangeGuid).

Parâmetros

-Confirm

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Database

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

O parâmetro Base de Dados devolve as informações de localização da caixa de correio para todas as caixas de correio na base de dados da caixa de correio especificada. É possível usar qualquer valor que identifique o banco de dados com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID

Nome do banco de dados

Propriedades do parâmetro

Tipo:DatabaseIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

DatabaseSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro Identidade especifica o objeto de localização da caixa de correio que pretende ver. O valor utiliza um dos seguintes formatos:

  • TenantGUID\MailboxGUID
  • MailboxGUID

No Exchange Server ou Exchange Online, pode executar o seguinte comando para localizar e comparar os valores mailboxGUID para o utilizador: Get-Mailbox -Identity <MailboxIdentity> | Format-List *GUID,MailboxLocations.

No Exchange Online, pode encontrar os valores TenantGUID e MailboxGUID depois de executar Get-MailboxLocation com o parâmetro Utilizador.

Não pode utilizar este parâmetro com o parâmetro Utilizador.

Atenção: o valor $null ou um valor inexistente para o parâmetro Identidade devolve todos os objetos como se tivesse executado o comando Get- sem o parâmetro Identity. Verifique se as listas de valores do parâmetro Identity estão corretas e não contêm valores de $null inexistentes.

Propriedades do parâmetro

Tipo:MailboxLocationIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-IncludePreviousPrimary

Aplicável: Exchange Online

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

O comutador IncludePreviousPrimary especifica se deve incluir a caixa de correio primária anterior nos resultados. Não é preciso especificar um valor com essa opção.

Só pode utilizar este comutador com o parâmetro Utilizador.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

User
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MailboxLocationType

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O MailboxLocationType filtra os resultados pelo tipo de caixa de correio. Os valores válidos são:

  • Agregado
  • AuxArchive
  • AuxPrimary
  • Componente Partilhado
  • Arquivo Principal
  • PreviousPrimary (apenas Exchange Online)
  • Primário

Propriedades do parâmetro

Tipo:MailboxLocationType
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ResultSize

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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.

Propriedades do parâmetro

Tipo:Unlimited
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-User

Aplicável: Exchange Online

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

O parâmetro Utilizador especifica o utilizador cuja localização da caixa de correio pretende ver. É possível usar qualquer valor que identifique o usuário com exclusividade. Por exemplo:

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

Nome do banco de dados

Propriedades do parâmetro

Tipo:UserIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

User
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.