Командлет Get-UMMailbox отображает свойства единой системы обмена сообщениями для получателя, для которого в данный момент включена поддержка единой системы обмена сообщениями.

Синтаксис

Get-UMMailbox [-Identity <MailboxIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-UMMailbox [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-UMMailbox [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

Параметры

Параметр Обязательность Тип Описание

Anr

Дополнительно

System.String

Этот параметр определяет строку, по которой будет выполнен поиск с целью разрешения неоднозначного имени. Можно указать частичное строковое значение и выполнить поиск объектов, имеющих атрибут, который соответствует этой строке. Атрибуты по умолчанию, по которым выполняется поиск:

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • псевдоним.

Credential

Дополнительно

System.Management.Automation.PSCredential

Этот параметр указывает имя пользователя и пароль для получения доступа к службе каталогов Active Directory.

DomainController

Дополнительно

Microsoft.Exchange.Data.Fqdn

Чтобы указать полное доменное имя контроллера домена, записывающего это изменение настройки в службу каталогов Active Directory, включите в командлет параметр DomainController.

Filter

Дополнительно

System.String

Этот параметр позволяет отфильтровывать результаты, возвращенные командлетом.

Дополнительные сведения о фильтруемых свойствах см. в разделе Фильтруемые свойства для параметра -Filter.

Идентификатор

Дополнительно

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Этот параметр определяет пользователя, для которого включается использование единой системы обмена сообщениями. Для этого параметра могут использоваться следующие переменные:

  • ADObjectID

  • GUID;

  • DN

  • Domain\Account

  • UPN;

  • LegacyExchangeDN

  • SmtpAddress

  • псевдоним.

Этот параметр обязателен, если не используется параметр Instance.

OrganizationalUnit

Дополнительно

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Этот параметр указывает подразделение (OU) и служит для ограничения вывода результатов. При использовании данного параметра будут получены только почтовые ящики, содержащиеся в заданном контейнере. Можно использовать подразделение или доменное имя. При использовании подразделения необходимо указать каноническое имя этого подразделения.

ReadFromDomainController

Дополнительно

System.Management.Automation.SwitchParameter

Этот параметр указывает, что сведения о пользователе будут считываться из контроллера домена в домене пользователя. Если задана область получателя, включающая в себя всех получателей в лесу, и если этот параметр не используется, сведения о пользователе могут быть считаны из глобального каталога, данные которого устарели. При использовании этого параметра для получения данных сведений может потребоваться несколько операций чтения. По умолчанию область получателей устанавливается соответствующей домену, в котором размещаются серверы Exchange.

ResultSize

Дополнительно

Microsoft.Exchange.Data.Unlimited

Этот параметр позволяет указать максимальное число возвращаемых результатов. В противном случае максимальное число не задано и командлет возвращает все результаты.

SortBy

Дополнительно

System.String

Этот параметр указывает атрибут, используемый для сортировки результатов. Сортировка может выполняться только по одному атрибуту за раз. Можно выполнять сортировку по следующим атрибутам:

  • псевдоним.

  • DisplayName

  • Имя

Результаты сортируются в порядке возрастания.

Подробное описание

Командлет Get-UMMailbox извлекает свойства единой системы обмена сообщениями для отдельного почтового ящика единой системы обмена сообщениями. Он также может возвращать список почтовых ящиков с включенной поддержкой единой системы обмена сообщениями.

Для выполнения командлета Get-UMMailbox используемой учетной записи необходимо делегировать следующую роль:

  • роль администратора получателей Exchange.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Типы входных данных

Тип Описание

 

 

Типы возвращаемых данных

Тип Описание

 

 

Ошибки

Ошибка Описание

 

 

Пример

В первом примере кода показан список почтовых ящиков единой системы обмена сообщениями в лесу Active Directory в форматированном списке.

Во втором примере кода приведены свойства почтового ящика единой системы обмена сообщениями yanli@contoso.com.

Копировать код
Get-UMMailbox | format-list

Get-UMMailbox -Identity yanli@contoso.com