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

Синтаксис

get-Mailbox [-Identity <MailboxIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
get-Mailbox [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]
get-Mailbox [-Credential <PSCredential>] [-Database <DatabaseIdParameter>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
get-Mailbox [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
get-Mailbox [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Параметры

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

Anr

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

System.String

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

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • псевдоним.

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.

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

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

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

  • GUID;

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

  • Domain\Account

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

  • LegacyExchangeDN

  • SmtpAddress

  • псевдоним.

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 указывает атрибут, используемый для сортировки результатов. Сортировка может выполняться только по одному атрибуту за раз. Можно выполнять сортировку по следующим атрибутам:

  • псевдоним.

  • краткое имя

  • Имя

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

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

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

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

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

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования 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