Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-03-19

Используйте командлет Get-MailboxFolder для возвращения папок указанного почтового ящика, когда его владелец выполняет команду.

Синтаксис

Get-MailboxFolder [-Identity <MailboxFolderIdParameter>] [-DomainController <Fqdn>]
Get-MailboxFolder [-Identity <MailboxFolderIdParameter>] -Recurse <SwitchParameter> [-DomainController <Fqdn>] [-MailFolderOnly <SwitchParameter>] [-ResultSize <Unlimited>]
Get-MailboxFolder [-Identity <MailboxFolderIdParameter>] -GetChildren <SwitchParameter> [-DomainController <Fqdn>] [-MailFolderOnly <SwitchParameter>] [-ResultSize <Unlimited>]

Параметры

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

GetChildren

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

System.Management.Automation.SwitchParameter

Параметр GetChildren указывает, будет ли возвращен только первый уровень подпапок в указанной родительской папке. Можно одновременно указать оба этих параметра и параметр Recurse. Значение по умолчанию: $false.

Recurse

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

System.Management.Automation.SwitchParameter

Параметр Recurse указывает, будет ли возвращена указанная родительская папка и все вложенные папки. Можно одновременно указать оба этих параметра и параметр GetChildren. Значение по умолчанию: $false.

DomainController

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

Microsoft.Exchange.Data.Fqdn

Identity

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

Microsoft.Exchange.Configuration.Tasks.MailboxFolderIdParameter

Параметр Identity указывает почтовый ящик и папку, сведения о которых возвращает команда. Если папка не указана, команда возвращает сведения о папках в корневой иерархии указанного почтового ящика. Можно задать значения в следующем формате: <Идентификатор почтового ящика>:<Родительский объект>

К допустимым значениям для параметра <Идентификатор почтового ящика> относятся следующие:

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

  • Различающееся имя ADObjectID

  • Домен\имя_пользователя

  • Основное имя пользователя

  • Имя LegacyExchangeDN

  • SMTP-адрес

  • Псевдоним

  • Сохранить идентификатор объекта для родительской папки

Значением параметра <Parent> может быть идентификатор объекта или путь, например «\Входящие\Личные».

MailFolderOnly

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

System.Management.Automation.SwitchParameter

Параметр MailFolderOnly указывает, будут ли возвращены только почтовые папки в указанном почтовом ящике. Значение по умолчанию: $false.

ResultSize

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

Microsoft.Exchange.Data.Unlimited

Параметр ResultSize задает максимальное число возвращаемых параметров. Если требуется, чтобы возвращались все параметры, соответствующие команде, используйте «unlimited» (без ограничений) в качестве значения этого параметра.

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

Если почтовый ящик не указан, командлет возвращает указанные папки в почтовом ящике владельца, выполняющего текущую команду. Перед возвращением запрошенных папок данная команда проверяет, что почтовый ящик, указанный в параметре Identity, является допустимым почтовым ящиком Exchange. Если параметр MailFolderOnly не указан, командлет возвращает все папки.

Подраздел «Параметры пользователя» в разделе Разрешения клиентского доступа.

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

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

Ошибки

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

 

Примеры

ПРИМЕР 1

В этом примере возвращается папка Inbox в почтовом ящике Tony. Параметр Identity поддерживается в формате <идентификатор почтового ящика>:<папка>.

Скопировать код
Get-MailboxFolder -Identity Tony:\Inbox

ПРИМЕР 2

В этом примере возвращаются корневые папки в почтовом ящике Tony. Параметр Identity поддерживается в формате <идентификатор почтового ящика>.

Скопировать код
Get-MailboxFolder -Identity Tony 

ПРИМЕР 3

В этом примере возвращается первый уровень почтовых папок в почтовом ящике Tony.

Скопировать код
Get-MailboxFolder -Identity Tony -GetChildren -MailFolderOnly

ПРИМЕР 4

В этом примере возвращаются сведения обо всех вложенных папках в папке Inbox (Входящие) в почтовом ящике Tony.

Скопировать код
Get-MailboxFolder -Identity Tony:\Inbox -GetChildren

ПРИМЕР 5

В этом примере возвращаются все уровни папок в папке Inbox (Входящие) в почтовом ящике Tony.

Скопировать код
Get-MailboxFolder -Identity Tony:\Inbox -Recurse