Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-04-23

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

Синтаксис

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

Параметры

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

Anr

Необязательный

System.String

Параметр Anr определяет строку, по которой будет выполнен поиск с разрешением неоднозначных имен (ANR). Можно указать частичное строковое значение и выполнить поиск объектов, имеющих атрибут, который соответствует этой строке. По умолчанию искомыми атрибутами являются:

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

Необязательный

System.Management.Automation.PSCredential

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

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

Параметр DomainController указывает имя FQDN контроллера домена, получающего данные из Служба каталогов Active Directory.

Filter

Необязательный

System.String

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

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

Identity

Необязательный

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

  • ADObjectID

  • GUID

  • Различающееся имя

  • Домен\Учетная_запись

  • UPN

  • LegacyExchangeDN

  • SmtpAddress

  • Псевдоним

IgnoreDefaultScope

Необязательный

System.Management.Automation.SwitchParameter

Параметр IgnoreDefaultScope указывает, что при выполнении команды необходимо игнорировать параметр, определяющий для сеанса командной консоли Exchange область получателя по умолчанию, и задает в качестве области действия весь лес. Это обеспечивает команде доступ к объектам Служба каталогов Active Directory, которые на текущий момент не относятся к области действия по умолчанию. Для параметра IgnoreDefaultScope действуют следующие ограничения.

  • При этом параметр DomainController использовать нельзя. Команда автоматически использует соответствующий сервер глобального каталога.

  • В качестве значения параметра Identity можно использовать только различающееся имя. Другие формы идентификации, например с помощью псевдонима или идентификатора GUID, не допускаются.

  • Невозможно использовать параметры OrganizationalUnit и Identity вместе.

  • При этом параметр Credential использовать нельзя.

Organization

Необязательный

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

Параметр Organization зарезервирован для внутреннего использования корпорацией Майкрософт.

OrganizationalUnit

Необязательный

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

ReadFromDomainController

Необязательный

System.Management.Automation.SwitchParameter

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

ResultSize

Необязательный

Microsoft.Exchange.Data.Unlimited

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

SortBy

Необязательный

System.String

Параметр SortBy указывает атрибут, используемый для сортировки результатов. Результаты нельзя сортировать одновременно по нескольким атрибутам. Доступна сортировка по следующим атрибутам:

  • Alias

  • DisplayName

  • Name

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

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

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

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

Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделе Запись «Почтовый ящик единой системы обмена сообщениями» в разделе Разрешения единой системы обмена сообщениями.

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

Тип Описание

 

 

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

Тип Описание

 

 

Ошибки

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

 

 

Примеры

ПРИМЕР 1

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

Скопировать код 
Get-UMMailbox | Format-List

ПРИМЕР 2

В этом примере отображаются свойства почтового ящика единой системы обмена сообщениями для веб-узла alexorekhov@contoso.com.

Скопировать код 
Get-UMMailbox -Identity tonysmith@contoso.com