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

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

Командлет Get-RemoteMailbox используется для извлечения почтовых атрибутов пользователей в локальной службе Служба каталогов Active Directory, связанных с почтовыми ящиками в облачной службе.

Синтаксис

get-RemoteMailbox [-Identity <RemoteMailboxIdParameter>] [-Archive <SwitchParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OnPremisesOrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
get-RemoteMailbox [-Anr <String>] [-Archive <SwitchParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OnPremisesOrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

Параметры

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

Anr

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

System.String

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

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Archive

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

System.Management.Automation.SwitchParameter

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

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.

Identity

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

Microsoft.Exchange.Configuration.Tasks.RemoteMailboxIdParameter

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

  • GUID.

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

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

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

  • Имя LegacyExchangeDN.

  • Адрес SmtpAddress.

  • Псевдоним.

IgnoreDefaultScope

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

OnPremisesOrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

  • Подразделение: westcoast.contoso.com/users

  • Домен: westcoast.contoso.com

ReadFromDomainController

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

System.Management.Automation.SwitchParameter

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

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

ResultSize

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

Microsoft.Exchange.Data.Unlimited

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

SortBy

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

System.String

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

  • Псевдоним

  • Отображаемое имя.

  • Имя.

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

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

Командлет Get-RemoteMailbox извлекает почтовые атрибуты пользователя почты в локальной системе Служба каталогов Active Directory. Он не извлекает атрибуты связанного почтового ящика в службе. Большинство почтовых атрибутов локальных пользователей почты и их почтовых ящиков в службе должны совпадать. Тем не менее у почтовых ящиков в службе есть дополнительные атрибуты, которые нельзя просмотреть с помощью командлета Get-RemoteMailbox. Чтобы просмотреть атрибуты почтового ящика, следует открыть соответствующий лес в консоли или подключиться к службе в командной консоли Exchange и использовать командлет Get-Mailbox.

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

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

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

Ошибки

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

 

Примеры

ПРИМЕР 1

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

Скопировать код
Get-RemoteMailbox

ПРИМЕР 2

В этом примере для извлечения списка пользователей почты с почтовыми ящиками в службе используются альтернативные учетные данные. Это полезно, если у обычно используемой учетной записи нет административных разрешений. Учетные данные используются для доступа к локальным контроллерам домена Служба каталогов Active Directory.

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

Скопировать код
$Credentials = Get-Credential

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

Скопировать код
Get-RemoteMailbox -Credential $Credentials