Get-UMMailbox

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2007-07-20

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

Синтаксис

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

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

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

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

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

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

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

Параметры

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

Anr

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

System.String

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

  • CommonName (CN) (общее имя),

  • DisplayName (Краткое имя)

  • FirstName (имя),

  • LastName (фамилия),

  • Псевдоним

Credential

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

System.Management.Automation.PSCredential

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

Данный параметр определяет полное доменное имя контроллера домена, который записывает это изменение конфигурации в Active Directory.

Filter

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

System.String

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

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

  • идентификатор ADObjectID

  • идентификатор GUID

  • имя DN

  • домен\имя_учетной_записи

  • имя UPN

  • имя LegacyExchangeDN

  • адрес SmtpAddress

  • псевдоним

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

IgnoreDefaultScope

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

ReadFromDomainController

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

System.Management.Automation.SwitchParameter

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

ResultSize

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

Microsoft.Exchange.Data.Unlimited

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

SortBy

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

System.String

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

  • Alias

  • DisplayName

  • Name

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

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

Тип Описание

 

 

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

Тип Описание

 

 

Ошибки

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

 

 

Пример

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

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

Get-UMMailbox | format-list

Get-UMMailbox -Identity yanli@contoso.com