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

Get-PublicFolder

  • Статья

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2009-05-12

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

Синтаксис

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

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

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

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

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

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

Параметры

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

GetChildren

Обязательный

System.Management.Automation.SwitchParameter

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

Recurse

Обязательный

System.Management.Automation.SwitchParameter

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

Identity

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

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

Если запустить командлет Get-PublicFolder, и параметр UseDatabaseQuotaDefaults при этому будет иметь значение true, командлет Get-PublicFolderDatabase будет возвращать следующие значения базы данных:

  • MaxItemSize

  • IssueWarningQuota

  • ProhibitPostQuota

Кроме того, к каждому значению будет добавлена строка «(InheritFromDB)».