Командлет 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 действуют ограничения, описанные ниже.
|
||
OrganizationalUnit |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
Параметр OrganizationalUnit определяет подразделение (OU), которым будет ограничен поиск. Может быть задано подразделение или домен. Должно быть задано каноническое имя подразделения. |
||
ReadFromDomainController |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр ReadFromDomainController указывает, что сведения о пользователе будут считываться из контроллера домена в домене пользователя. Если установлена область получателей для включения всех получателей в лесе, и этот параметр не используется, сведения о пользователе могут быть считаны с сервера глобального каталога с устаревшими сведениями. Если этот параметр используется, возможно, понадобится выполнить считывание несколько раз, чтобы получить сведения.
|
||
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 |