Get-MailboxLocation

Referência

Módulo:: ExchangePowerShell

Aplica-se a:: Exchange Server 2016, Exchange Server 2019, Exchange Online

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

Use o cmdlet Get-MailboxLocation para exibir 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.

Syntax

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

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

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

Description

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. 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

Em Exchange Online, este exemplo retorna as informações de localização da caixa de correio para o usuário chris@contoso.com.

Exemplo 2

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

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

Parâmetros

-Confirm

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, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
A maioria dos outros cmdlets (por exemplo, cmdlets 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.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-Database

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

O parâmetro Banco de Dados retorna as informações de localização da caixa de correio para todas as caixas de correio no banco de dados de caixa de correio especificado. É 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

Type:	DatabaseIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-Identity

O parâmetro Identity especifica o objeto de localização da caixa de correio que você deseja exibir. O valor usa um dos seguintes formatos:

TenantGUID\MailboxGUID
Mailboxguid

Em Exchange Server ou Exchange Online, você pode executar o seguinte comando para localizar e comparar os valores do MailboxGUID para o usuário: Get-Mailbox -Identity <MailboxIdentity> | Format-List *GUID,MailboxLocations.

Em Exchange Online, você pode encontrar os valores TenantGUID e MailboxGUID depois de executar Get-MailboxLocation com o parâmetro Usuário.

Você não pode usar esse parâmetro com o parâmetro Usuário.

Type:	MailboxLocationIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludePreviousPrimary

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

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

Você só pode usar essa opção com o parâmetro Usuário.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-MailboxLocationType

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

Agregados
AuxArchive
AuxPrimary
ComponentShared
MainArchive
PreviousPrimary (somente Exchange Online)
Primário

Type:	MailboxLocationType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-ResultSize

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.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-User