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

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

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

Синтаксис

Get-Mailbox [-Identity <MailboxIdParameter>] [-Arbitration <SwitchParameter>] [-Archive <SwitchParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-ForReconciliation <SwitchParameter>] [-IgnoreDefaultScope <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-RemoteArchive <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Mailbox [-Arbitration <SwitchParameter>] [-Archive <SwitchParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-ForReconciliation <SwitchParameter>] [-IgnoreDefaultScope <SwitchParameter>] [-MailboxPlan <MailboxPlanIdParameter>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-RemoteArchive <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Mailbox [-Arbitration <SwitchParameter>] [-Archive <SwitchParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-ForReconciliation <SwitchParameter>] [-IgnoreDefaultScope <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-RemoteArchive <SwitchParameter>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]
Get-Mailbox [-Arbitration <SwitchParameter>] [-Archive <SwitchParameter>] [-Credential <PSCredential>] [-Database <DatabaseIdParameter>] [-DomainController <Fqdn>] [-Filter <String>] [-ForReconciliation <SwitchParameter>] [-IgnoreDefaultScope <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-RemoteArchive <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Mailbox [-Anr <String>] [-Arbitration <SwitchParameter>] [-Archive <SwitchParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-ForReconciliation <SwitchParameter>] [-IgnoreDefaultScope <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-RemoteArchive <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

Параметры

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

Anr

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

System.String

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

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Arbitration

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

System.Management.Automation.SwitchParameter

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

Archive

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

System.Management.Automation.SwitchParameter

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

Credential

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

System.Management.Automation.PSCredential

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

Для этого параметра требуется создание и передача объекта учетных данных. Этот объект учетных данных создается с помощью командлета Get-Credential. Дополнительные сведения см. в разделе Get-Credential.

Database

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

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

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

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

  • имя базы данных,

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

Filter

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

System.String

Параметр Filter указывает фильтр OPath, используемый для фильтрации получателей.

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

ForReconciliation

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

System.Management.Automation.SwitchParameter

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

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

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

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

  • Основное имя пользователя

  • имя LegacyExchangeDN

  • адрес SmtpAddress

  • псевдоним

IgnoreDefaultScope

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

MailboxPlan

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

Microsoft.Exchange.Configuration.Tasks.MailboxPlanIdParameter

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

Этот параметр доступен для развертываний с несколькими клиентами В случае локального развертывания он недоступен. Дополнительные сведения о развертывании с несколькими клиентами см. в разделе Multi-Tenant Support.

Параметр MailboxPlan указывает на необходимость возвращения почтовых ящиков, связанных с этим планом почтового ящика. План почтового ящика задает разрешения и функции, доступные пользователю почтового ящика. Название плана почтового ящика необходимо включить в план обслуживания организации, в которой размещается этот ящик. Дополнительные сведения см. в разделе Understanding Service Plans and Mailbox Plans.

Organization

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

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

Этот параметр доступен для развертываний с несколькими клиентами В случае локального развертывания он недоступен. Дополнительные сведения о развертывании с несколькими клиентами см. в разделе Multi-Tenant Support.

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

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

ReadFromDomainController

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

System.Management.Automation.SwitchParameter

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

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

RecipientTypeDetails

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

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

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

Параметр может иметь указанные ниже значения.

  • RoomMailbox

  • EquipmentMailbox

  • LegacyMailbox

  • LinkedMailbox

  • UserMailbox

  • DiscoveryMailbox

  • SharedMailbox

RemoteArchive

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

System.Management.Automation.SwitchParameter

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

Этот параметр нельзя использовать вместе с параметром Archive.

ResultSize

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

Microsoft.Exchange.Data.Unlimited

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

Server

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

SortBy

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

System.String

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

  • Псевдоним

  • краткое имя

  • имя

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

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

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

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

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Примеры

ПРИМЕР 1

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

Скопировать код
Get-Mailbox -ResultSize unlimited

ПРИМЕР 2

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

Скопировать код
Get-Mailbox -OrganizationalUnit Users

ПРИМЕР 3

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

Скопировать код
Get-Mailbox -Anr Chr -DomainController DC01

ПРИМЕР 4

В этом примере возвращаются сведения о почтовых ящиках с именем «Юлия», включая сведения об архивных почтовых ящиках.

Скопировать код
Get-Mailbox -Identity Chris -Archive

ПРИМЕР 5

В этом примере возвращаются сведения о почтовом ящике «ed@contoso.com», в том числе сведения о его удаленном архивном почтовом ящике.

Скопировать код
Get-Mailbox -Identity ed@contoso.com -RemoteArchive