Использование командлета 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>]

Параметры

Параметр	Обязательный	Тип	Описание
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 используемой учетной записи необходимо делегировать следующую роль:

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

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

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

Ошибки

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

Исключения

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

Пример

В следующих примерах программ показано, как использовать командлет 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 
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)».

Exchange 2007

Get-PublicFolder
	Пример