Get-MailboxFolder

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Используйте командлет Get-MailboxFolder для просмотра папок в собственном почтовом ящике. Администраторы не могут использовать этот командлет для просмотра папок в других почтовых ящиках (командлет доступен только из роли пользователя MyBaseOptions).

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

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

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

Описание

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

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Get-MailboxFolder -Identity :\Inbox | Format List

В этом примере возвращаются подробные сведения о папке "Входящие" в вашем почтовом ящике.

Пример 2

Get-MailboxFolder

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

Пример 3

Get-MailboxFolder -GetChildren -MailFolderOnly

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

Пример 4

Get-MailboxFolder -Identity :\Inbox -GetChildren

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

Пример 5

Get-MailboxFolder -Identity :\Inbox -Recurse

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

Параметры

-DomainController

Этот параметр доступен только в локальной среде Exchange.

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-GetChildren

Параметр GetChildren указывает, будет ли возвращен только первый уровень подпапок в указанной родительской папке. Для этого переключателя не требуется указывать значение.

Этот параметр невозможно использовать с параметром Recurse.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

Параметр Identity определяет папку почтового ящика, которую нужно просмотреть. Используется следующий синтаксис: [MailboxID]:[\ParentFolder][\SubFolder].

Этот командлет можно выполнять только в собственном почтовом ящике, поэтому указывать значение не нужно или не MailboxID удается.

Для значения MailboxIDможно использовать любое значение, которое однозначно идентифицирует почтовый ящик. Например:

Имя
Псевдоним
различающееся имя (DN);
различающееся имя (DN);
Домен\Имя пользователя
Адрес электронной почты
GUID
LegacyExchangeDN
SamAccountName
Идентификатор пользователя или имя участника-пользователя

Если папка не указана, команда возвращает сведения о папках в корневой иерархии указанного почтового ящика.

Примерами значений для этого параметра являются john@contoso.com:, John:\Inbox.

Type:	MailboxFolderIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-MailFolderOnly

Параметр MailFolderOnly указывает, будут ли возвращены только почтовые папки в указанном почтовом ящике. Указывать значение для этого параметра необязательно.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Recurse

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

Этот параметр невозможно использовать с параметром GetChildren.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ResultSize

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

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.