Get-PublicFolder

Ссылка

Модуль:: ExchangePowerShell

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

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

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

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

Синтаксис

Get-PublicFolder
   [[-Identity] <PublicFolderIdParameter>]
   [-GetChildren]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-ResultSize <Unlimited>]
   [-Server <ServerIdParameter>]
   [<CommonParameters>]

Get-PublicFolder
   [[-Identity] <PublicFolderIdParameter>]
   [-Recurse]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-ResultSize <Unlimited>]
   [-Server <ServerIdParameter>]
   [<CommonParameters>]

Get-PublicFolder
   [-LostAndFound]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Get-PublicFolder
   [[-Identity] <PublicFolderIdParameter>]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-Server <ServerIdParameter>]
   [<CommonParameters>]

Описание

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

Примеры

Пример 1

Get-PublicFolder

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

Пример 2

Get-PublicFolder -Identity \NON_IPM_SUBTREE -Recurse | Format-List Name

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

Пример 3

Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation"

В этом примере возвращается общая папка "Тяжба на рассмотрении суда" из каталога "\Юридические_сведения\Документы\".

Пример 4

Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse

В этом примере возвращается общедоступная папка "Тяжба на рассмотрении суда" из каталога \Юридические_сведения\Документы\, а также все общедоступные папки из общедоступной папки "Тяжба на рассмотрении суда". Поскольку размер результата не указан, команда вернет не более максимального числа общих папок (10000).

Пример 5

Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse -ResultSize Unlimited

В этом примере возвращается общедоступная папка "Тяжба на рассмотрении суда" из каталога \Юридические_сведения\Документы\, а также все общедоступные папки в ней без ограничения числа возвращаемых результатов.

Пример 6

Get-PublicFolder -Mailbox "Legal Department" -ResidentFolders

В этом примере возвращаются общедоступные папки, которые хранятся в почтовом ящике содержимого общедоступных папок "Legal Department".

Параметры

-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 указывает, следует ли возвращать только дочерние элементы папки, указанной параметром Identity. Для этого переключателя не требуется указывать значение.

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

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 указывает имя и путь к общедоступной папке, которую вы хотите просмотреть. Допустимое значение использует синтаксис: \Level1\Level2\...\LevenN\PublicFolder. Например, "\Customer Discussion" или "\Engineering\Customer Discussion".

Type:	PublicFolderIdParameter
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

-LostAndFound

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

Папка LOST_AND_FOUND содержит отсутствующие папки, повторно созданные процессом выверки иерархии общедоступных папок, если папка существует в дополнительном почтовом ящике общедоступной папки, но не в основном почтовом ящике.

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

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

-Mailbox

Параметр Mailbox указывает идентификатор иерархии почтового ящика общей папки. Вы можете использовать любое значение, которое однозначно определяет почтовый ящик. Пример.

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

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

-Organization

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

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

-Recurse

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

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

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

-ResidentFolders

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

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

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

-ResultSize

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

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

-Server

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

Параметр Server фильтрует результаты по указанному серверу Exchange Server. Можно использовать любое значение, однозначно определяющее сервер. Примеры:

Имя.
полное доменное имя;
различающееся имя (DN);
Устаревшее различающееся имя Exchange

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

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

Input types

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

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

Output types

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

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