Применимо к: 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). Можно задать частичное строковое значение и выполнить поиск объектов с атрибутом, который совпадает с этой строкой. По умолчанию искомыми атрибутами являются:
|
||
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 указывает базу данных, из которой будет получен данный почтовый ящик. Можно использовать следующие значения:
Этот параметр нельзя использовать совместно с параметром 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 задает идентификатор нужного почтового ящика. Можно использовать одно из следующих значений:
|
||
IgnoreDefaultScope |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр IgnoreDefaultScope указывает, что при выполнении команды необходимо игнорировать параметр, определяющий для сеанса командной консоли Exchange область получателя по умолчанию, и задает в качестве области действия весь лес. Это обеспечивает команде доступ к объектам Служба каталогов Active Directory, которые на текущий момент не относятся к области действия по умолчанию. Для параметра IgnoreDefaultScope действуют следующие ограничения.
|
||
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 указывает, что сведения о пользователе будут считываться из контроллера домена в домене пользователя. Если установлена область получателей для включения всех получателей в лесу и этот параметр не используется, сведения о пользователе могут быть прочитаны из глобального каталога с устаревшими сведениями. Если этот параметр используется, возможно, понадобится выполнить считывание несколько раз, чтобы получить сведения.
|
||
RecipientTypeDetails |
Необязательный |
Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[] |
Параметр RecipientTypeDetails указывает тип возвращаемых
получателей. Типы получателей разделены на типы и подтипы. Каждый
тип получателя содержит все общие свойства всех подтипов. Например,
тип Параметр может иметь указанные ниже значения.
|
||
RemoteArchive |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр RemoteArchive указывает, следует ли отключать удаленный архив для этого почтового ящика. Удаленный архив существует в облачной службе. Этот параметр нельзя использовать вместе с параметром Archive. |
||
ResultSize |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Параметр ResultSize указывает максимальное число
возвращаемых результатов. Если требуется возвратить все почтовые
ящики, отвечающие условиям запроса, используйте для этого параметра
значение |
||
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 |