Командлет Get-MailPublicFolder используется для получения связанных с электронной почтой сведений только об общих почтовых папках. Если нужны сведения о базовых, не связанных с почтой настройках общих почтовых папок, используйте другой командлет, Get-PublicFolder.

Синтаксис

Get-MailPublicFolder [-Identity <MailPublicFolderIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]
Get-MailPublicFolder [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]
Get-MailPublicFolder [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]

Параметры

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

Anr

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

System.String

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

Служба каталогов Active Directory использует заданное значение и выполняет поиск в соответствии со своей конфигурацией. К атрибутам поиска по умолчанию относятся общее имя (CN) и псевдоним (mailNickname).

Credential

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

System.Management.Automation.PSCredential

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

Пароль должен запрашиваться безопасным образом.

DomainController

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

Microsoft.Exchange.Data.Fqdn

Чтобы задать полное доменное имя (FQDN) контроллера домена, который записывает эти изменения конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController.

Filter

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

System.String

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

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.MailPublicFolderIdParameter

С помощью параметра Identity можно задать GUID или имя общей папки, которые представляют определенную общую папку. Можно также включить путь в формате «общая_папка_верхнего_уровня\общая_папка».

Можно опустить метку параметра Identity, оставив только имя общей папки или GUID.

IgnoreDefaultScope

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

ReadFromDomainController

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

System.Management.Automation.SwitchParameter

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

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

ResultSize

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

Microsoft.Exchange.Data.Unlimited

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

Server

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Параметр Server задает идентификатор сервера, на котором следует выполнить операцию. Если сервер не указан, команда проверяет, является ли локальный сервер сервером почтовых ящиков с запущенным Microsoft Exchange 2007 и хранилищем общих папок. Если да, папка создается локально. В противном случае команда находит ближайший (по стоимости сайта) сервер почтовых ящиков Exchange Server 2007, на котором подключено хранилище общих папок.

SortBy

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

System.String

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

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

Для выполнения командлета Get-MailPublicFolder используемой учетной записи необходимо делегировать следующую роль:

  • роль администратора общих папок Exchange и членство в локальной группе администраторов на целевом сервере

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования сервера Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

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

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

Ошибки

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

 

Исключения

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

 

Пример

Этот пример возвращает все общие почтовые папки. В этом примере результат команды Get-MailPublicFolder передается на вход команды Format-List, чтобы результат содержал все доступные сведения.

Копировать код
Get-MailPublicFolder | Format-List