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

Последнее изменение раздела: 2011-03-19

Командлет Get-CASMailbox используется для возвращения полного списка атрибутов почтового ящика Microsoft Exchange Server 2010 на компьютере с установленной ролью сервера клиентского доступа.

Синтаксис

Get-CASMailbox [-Identity <MailboxIdParameter>] [-ActiveSyncDebugLogging <SwitchParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-GetImapProtocolLog <SwitchParameter>] [-GetPopProtocolLog <SwitchParameter>] [-IgnoreDefaultScope <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ProtocolSettings <SwitchParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SendLogsTo <MultiValuedProperty>] [-SortBy <String>]
Get-CASMailbox [-ActiveSyncDebugLogging <SwitchParameter>] [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-GetImapProtocolLog <SwitchParameter>] [-GetPopProtocolLog <SwitchParameter>] [-IgnoreDefaultScope <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ProtocolSettings <SwitchParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SendLogsTo <MultiValuedProperty>] [-SortBy <String>]

Параметры

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

ActiveSyncDebugLogging

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

System.Management.Automation.SwitchParameter

Параметр ActiveSyncDebugLogging указывает, включено ли ведение журнала Microsoft Exchange ActiveSync для почтового ящика.

Anr

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

System.String

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

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

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

System.Management.Automation.PSCredential

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

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

Filter

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

System.String

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

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

GetImapProtocolLog

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

System.Management.Automation.SwitchParameter

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

GetPopProtocolLog

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

System.Management.Automation.SwitchParameter

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

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

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

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

  • SMTP-адрес

  • Псевдоним

IgnoreDefaultScope

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

Organization

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

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

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

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

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Параметр OrganizationalUnit ограничивает поиск указанным контейнером.

ProtocolSettings

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

System.Management.Automation.SwitchParameter

Параметр ProtocolSetting возвращает имена серверов POP3, IMAP4 и SMTP для почтового ящика.

ReadFromDomainController

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

System.Management.Automation.SwitchParameter

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

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

ResultSize

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

Microsoft.Exchange.Data.Unlimited

Параметр ResultSize указывает максимальное число возвращаемых результатов. Значение по умолчанию равно 1000.

SendLogsTo

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр SendLogsTo указывает адрес для возвращения файлов журнала.

SortBy

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

System.String

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

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

Возвращаются различные атрибуты CASMailbox. Типы возвращаемых атрибутов включают в себя Microsoft Office Outlook Web App, Exchange ActiveSync, POP3 и IMAP4.

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

Командлет Get-CASMailbox может выполняться только на компьютере Exchange с установленной ролью сервера почтовых ящиков.

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Примеры

ПРИМЕР 1

В этом примере возвращаются подробные сведения всех почтовых ящиков сервера клиентского доступа пользователя Jeff Hay в домене Contoso.

Скопировать код 
Get-CASMailbox -Identity jeffhay@contoso.com

ПРИМЕР 2

В этом примере возвращаются подробные сведения всех почтовых ящиков сервера клиентского доступа пользователя Tony Smith в домене Contoso.

Скопировать код 
Get-CASMailbox -Identity contoso\tonysmith

ПРИМЕР 3

В этом примере возвращаются подробные сведения о всех почтовых ящиках на серверах клиентского доступа для пользователя «Tony Smith» в домене «fourthcoffee».

Скопировать код 
Get-CASMailbox -Identity fourthcoffee\tonysmith