Поделиться через

Командлет Get-PublicFolder (окончательная первоначальная версия)

  • Статья

 

Применимо к: Exchange Server 2007

Последнее изменение раздела: 2007-06-06

Использование командлета Get-PublicFolder для получения атрибутов общей папки или набора общих папок.

Синтаксис

Get-PublicFolder [-Identity <PublicFolderIdParameter>] [-DomainController <Fqdn>] [-Server <ServerIdParameter>]

Get-PublicFolder [-Identity <PublicFolderIdParameter>] -GetChildren <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]

Get-PublicFolder [-Identity <PublicFolderIdParameter>] -Recurse <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]

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

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

  • роль администратора Exchange с правами на просмотр.

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

Параметры

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

GetChildren

Обязательность

System.Management.Automation.SwitchParameter

Параметр GetChildren используется для получения только дочерних элементов папки, указанной параметромIdentity. Параметр GetChildren и параметр Recurse являются взаимоисключающими.

Recurse

Обязательность

System.Management.Automation.SwitchParameter

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

DomainController

Дополнительно

Microsoft.Exchange.Data.Fqdn

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

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

Дополнительно

Microsoft.Exchange.Configuration.Tasks.PublicFolderIdParameter

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

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

ResultSize

Дополнительно

Microsoft.Exchange.Data.Unlimited

Параметр ResultSize указывает максимальное число возвращаемых результатов. Наибольшее значение по умолчанию равно 10 000. Чтобы задать отсутствие ограничения на число возвращаемых результатов, установите для этого параметра значение Не ограничено. Данный параметр может передаваться только в сочетании с параметром Recurse или параметром GetChildren.

Server (сервер)

Дополнительно

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Параметр Server указывает сервер для выполнения выбранных операций.

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

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

Ошибки

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

 

Исключения

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

 

Пример

В следующих примерах программ показано, как использовать командлет Get-PublicFolder.

  • В первом примере для возврата объекта корневой общей папки (IPM_SUBTREE) используется команда Get-PublicFolder без параметров.

  • Во втором примере возвращаются имена всех системных папок (не показанных по умолчанию), начиная с корня системных папок (\NON_IPM_SUBTREE).

  • В третьем примере возвращается общая папка с указанным идентификатором долгосрочной записи.

  • В четвертом примере возвращается общая папка «Pending Litigation» из каталога «\Legal\Documents\».

  • В пятом примере возвращается общая папка «Pending Litigation» из каталога "\Legal\Documents\" и до 9999 общих папок из общей папки «Pending Litigation».

  • В шестом примере возвращается общая папка "Тяжба на рассмотрении суда" из каталога «\Legal\Documents\» и все общие папки в ней без ограничения числа возвращаемых результатов.

Get-PublicFolder 
Get-PublicFolder -Identity \NON_IPM_SUBTREE -Recurse | Format-List Name  
Get-PublicFolder -Identity <long-term entry identifier of a public folder>
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation"
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse -ResultSize Unlimited