Get-PublicFolder
Этот командлет доступен в локальной среде 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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по