С помощью командлета Get-Mailbox можно просматривать объекты и атрибуты почтового ящика, заполнять страницы свойств или подставлять данные почтового ящика в другие задачи.

Синтаксис

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

get-Mailbox [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]

get-Mailbox [-Credential <PSCredential>] [-Database <DatabaseIdParameter>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-Mailbox [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-Mailbox [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Параметры

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

Anr

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

System.String

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

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

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

System.Management.Automation.PSCredential

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

Database

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

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

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

  • идентификатор GUID базы данных

  • Имя базы данных

  • Имя сервера\имя базы данных

  • Имя сервера\группа хранения\имя базы данных

Если имя сервера не задано, командлет выполнит поиск базы данных на локальном сервере. Если на одном сервере имеется несколько баз данных с одинаковыми именами, необходимо указать группу хранения.

Данный параметр нельзя использовать совместно с параметром Filter.

DomainController

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

Microsoft.Exchange.Data.Fqdn

Параметр DomainController указывает контроллер домена, используемый для доступа к службе Active Directory. Укажите полное доменное имя необходимого контроллера домена.

Filter

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

System.String

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

Данный параметр нельзя применять совместно с параметром Database.

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Параметр Identity идентифицирует почтовый ящик. Можно использовать одно из следующих значений:

  • GUID

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

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

  • Имя участника-пользователя (UPN)

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

IgnoreDefaultScope

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

ReadFromDomainController

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

System.Management.Automation.SwitchParameter

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

Примечание.
По умолчанию в качестве области получателей задается домен, в котором размещаются серверы Exchange.

RecipientTypeDetails

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

Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[]

Параметр RecipientTypeDetails указывает тип возвращаемых получателей. Типы получателей в сервере Microsoft Exchange Server 2007 разделены на типы и подтипы. Каждый тип получателей содержит свойства, общие для всех подтипов. Например, тип UserMailbox представляет учетную запись пользователя в Active Directory со связанным почтовым ящиком. Поскольку существует несколько типов почтовых ящиков, каждый тип почтового ящика определяется параметром RecipientTypeDetails. Например, для почтового ящика конференц-зал для параметра RecipientTypeDetails установлено значение RoomMailbox, в то время как для почтового ящика пользователя для параметра RecipientTypeDetails установлено значение UserMailbox.

Для этой команды доступны следующие сведения о типе получателей:

  • RoomMailbox

  • EquipmentMailbox

  • LegacyMailbox

  • LinkedMailbox

  • UserMailbox

  • SharedMailbox

ResultSize

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

Microsoft.Exchange.Data.Unlimited

Параметр ResultSize указывает максимальное количество возвращаемых результатов. Если требуется возвратить все почтовые ящики, отвечающие условиям запроса, используйте для этого параметра значение «unlimited». Значение по умолчанию равно 1000.

Server

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

SortBy

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

System.String

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

  • Alias

  • Display name

  • Name

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

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

Командлет Get-Mailbox извлекает атрибуты и объекты почтового ящика. Никакие параметры не являются обязательными. Если этот командлет используется без параметров, выводятся сведения обо всех почтовых ящиках организации.

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

  • роль администратора Exchange с правами на просмотр.

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

Примечание.
Чтобы точно оценить текущее состояние квоты хранения с помощью командлета Get-Mailbox, помимо свойств ProhibitSendQuota, ProhibitSendReceiveQuota и IssueWarningQuota необходимо просмотреть значение свойства UseDatabaseQuotaDefaults. Значение True свойства UseDatabaseQuotaDefaults означает, что параметры, установленные для отдельных ящиков, будут пропущены, а вместо них будут использоваться ограничения базы данных почтовых ящиков. Если это свойство установлено равным True, а для свойств ProhibitSendQuota, ProhibitSendReceiveQuota и IssueWarningQuota установлено значение unlimited (не ограничено), размер почтового ящика не будет неограниченным. Вместо этого необходимо узнать ограничения хранилища для базы данных почтовых ящиков, чтобы узнать ограничения для почтового ящика. Значение False свойства UseDatabaseQuotaDefaults означает, что используются параметры отдельных почтовых ящиков.

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

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

Ошибки

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

 

Исключения

Исключения Описание

 

Пример

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

Во втором примере показано, как получить список всех почтовых серверов организации, находящихся в контейнере «Users» в домене Contoso.com.

В третьем примере показано, как в результате поиска для разрешения неоднозначного имени по строке «Chr» получить все почтовые ящики, которые находятся в домене DC01. Будут возвращены почтовые ящики для таких пользователей, как Chris Ashton, Christian Cletus и Christa Geller.

Копировать код 
Get-Mailbox -ResultSize unlimited
Get-Mailbox -OrganizationalUnit Users
Get-Mailbox -Anr Chr -DomainController DC01