Get-MailboxLocation
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и параметры могут быть эксклюзивными для одной или другой среды.
Используйте командлет Get-MailboxLocation для просмотра сведений о расположении почтового ящика в Exchange Online.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
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>]
Описание
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Get-MailboxLocation -User chris@contoso.com
В Exchange Online этот пример возвращает сведения о расположении почтового ящика для пользователя chris@contoso.com.
Пример 2
Get-MailboxLocation -Identity e15664af-82ed-4635-b02a-df7c2e03d950
В Exchange Server или Exchange Online этот пример возвращает сведения о расположении почтового ящика для указанного GUID почтового Get-Mailbox -Identity <MailboxIdentity> | Format-List ExchangeGuidящика (значение свойства ExchangeGuid из результатов ).
Параметры
-Confirm
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Database
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Параметр Database возвращает сведения о расположении почтовых ящиков для всех почтовых ящиков в указанной базе данных почтовых ящиков. Вы можете использовать любое значение, уникальным образом идентифицирующее базу данных. Пример:
- имя;
- различающееся имя (DN);
- GUID
Имя базы данных
Свойства параметров
| Тип: | DatabaseIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
DatabaseSet
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Параметр Identity указывает объект расположения почтового ящика, который требуется просмотреть. Значение использует любой из следующих форматов:
- TenantGUID\MailboxGUID
- MailboxGUID
В Exchange Server или Exchange Online можно выполнить следующую команду, чтобы найти и сравнить значения MailboxGUID для пользователя: Get-Mailbox -Identity <MailboxIdentity> | Format-List *GUID,MailboxLocations.
В Exchange Online можно найти значения TenantGUID и MailboxGUID после запуска Get-MailboxLocation с параметром User.
Этот параметр невозможно использовать вместе с параметром User.
Внимание! Значение $null или несуществующее значение для параметра Identity возвращает все объекты, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity являются точными и не содержат несуществующих $null значений.
Свойства параметров
| Тип: | MailboxLocationIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Identity
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludePreviousPrimary
Применимо: Exchange Online
Этот параметр доступен только в облачной службе.
Параметр IncludePreviousPrimary указывает, следует ли включать предыдущий основной почтовый ящик в результаты. С этим параметром не нужно указывать значение.
Этот параметр можно использовать только с параметром User.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
User
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MailboxLocationType
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
MailboxLocationType фильтрует результаты по типу почтового ящика. Допустимые значения:
- Агрегированные
- AuxArchive
- AuxPrimary
- ComponentShared
- MainArchive
- PreviousPrimary (только Exchange Online)
- Primary
Свойства параметров
| Тип: | MailboxLocationType |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ResultSize
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Параметр ResultSize указывает максимальное число возвращаемых результатов. Если требуется возвратить все результаты, отвечающие условиям запроса, используйте для этого параметра значение unlimited. Значение по умолчанию — 1000.
Свойства параметров
| Тип: | Unlimited |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-User
Применимо: Exchange Online
Этот параметр доступен только в облачной службе.
Параметр User указывает пользователя, расположение почтового ящика которого требуется просмотреть. Можно использовать любое уникальное значение, идентифицирующее пользователя. Пример:
- имя;
- различающееся имя (DN);
- различающееся имя (DN);
- GUID
Имя базы данных
Свойства параметров
| Тип: | UserIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
User
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.