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