Get-PublicFolder
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и параметры могут быть эксклюзивными для одной или другой среды.
Использование командлета Get-PublicFolder для получения атрибутов общей папки или набора общих папок.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
GetChildren
Get-PublicFolder
[[-Identity] <PublicFolderIdParameter>]
[-GetChildren]
[-DomainController <Fqdn>]
[-Mailbox <MailboxIdParameter>]
[-Organization <OrganizationIdParameter>]
[-ResidentFolders]
[-ResultSize <Unlimited>]
[-Server <ServerIdParameter>]
[<CommonParameters>]
Recurse
Get-PublicFolder
[[-Identity] <PublicFolderIdParameter>]
[-Recurse]
[-DomainController <Fqdn>]
[-Mailbox <MailboxIdParameter>]
[-Organization <OrganizationIdParameter>]
[-ResidentFolders]
[-ResultSize <Unlimited>]
[-Server <ServerIdParameter>]
[<CommonParameters>]
LostAndFound
Get-PublicFolder
[-LostAndFound]
[-DomainController <Fqdn>]
[-Mailbox <MailboxIdParameter>]
[-Organization <OrganizationIdParameter>]
[-ResidentFolders]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Identity
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 Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
Свойства параметров
| Тип: | Fqdn |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-GetChildren
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Параметр GetChildren указывает, следует ли возвращать только дочерние элементы папки, указанной параметром Identity. С этим параметром не нужно указывать значение.
Этот параметр нельзя использовать с параметрами Recurse или LostAndFound.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
GetChildren
| Позиция: | Named |
| Обязательный: | True |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Параметр Identity указывает имя и путь к общедоступной папке, которую требуется просмотреть. Допустимое значение использует синтаксис: \Level1\Level2\...\LevenN\PublicFolder. Например, "\Customer Discussion" или "\Engineering\Customer Discussion".
Внимание! Значение $null или несуществующее значение для параметра Identity возвращает все объекты, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity являются точными и не содержат несуществующих $null значений.
Свойства параметров
| Тип: | PublicFolderIdParameter |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
GetChildren
| Позиция: | 1 |
| Обязательный: | False |
| Ценность воронки продаж: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
Recurse
| Позиция: | 1 |
| Обязательный: | False |
| Ценность воронки продаж: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
Identity
| Позиция: | 1 |
| Обязательный: | False |
| Ценность воронки продаж: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-LostAndFound
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Параметр LostAndFound указывает, следует ли возвращать только потерянные папки, расположенные в \NON_IPM_SUBTREE\LOST_AND_FOUND. С этим параметром не нужно указывать значение.
Папка LOST_AND_FOUND содержит отсутствующие папки, повторно созданные процессом выверки иерархии общедоступных папок, если папка существует в дополнительном почтовом ящике общедоступной папки, но не в основном почтовом ящике.
Этот параметр нельзя использовать с параметром Identity или параметром Recurse или LostAndFound.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
LostAndFound
| Позиция: | Named |
| Обязательный: | True |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Mailbox
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Параметр Mailbox указывает идентификатор иерархии почтового ящика общей папки. Вы можете использовать любое значение, которое однозначно определяет почтовый ящик. Пример.
- Имя
- Псевдоним
- различающееся имя (DN);
- различающееся имя (DN);
- Домен\Имя пользователя
- Адрес электронной почты
- GUID
- LegacyExchangeDN
- SamAccountName
- Идентификатор пользователя или имя участника-пользователя
Свойства параметров
| Тип: | MailboxIdParameter |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Organization
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | OrganizationIdParameter |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Recurse
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Параметр Recurse указывает, следует ли возвращать указанную общедоступную папку и все ее дочерние элементы. С этим параметром не нужно указывать значение.
Этот параметр нельзя использовать с параметрами GetChildren или LostAndFound.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
Recurse
| Позиция: | Named |
| Обязательный: | True |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ResidentFolders
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Параметр ResidentFolders указывает, следует ли возвращать общедоступные папки, которые находятся в определенном почтовом ящике общедоступных папок содержимого. С этим параметром не нужно указывать значение.
Если этот параметр не используется, команда возвращает только общедоступные папки, содержимое которых находится в почтовом ящике общедоступных папок первичной иерархии.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ResultSize
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Параметр ResultSize указывает максимальное число возвращаемых результатов. Наибольшее значение по умолчанию равно 10 000. Чтобы задать отсутствие ограничения на число возвращаемых результатов, установите для этого параметра значение Unlimited. Этот параметр может передаваться только в сочетании с параметром Recurse или GetChildren.
Свойства параметров
| Тип: | Unlimited |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
GetChildren
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
Recurse
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
LostAndFound
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Server
Применимо: Exchange Server 2010 г.
Этот параметр доступен только в Exchange Server 2010.
Параметр Server фильтрует результаты по указанному серверу Exchange Server. Можно использовать любое значение, однозначно определяющее сервер. Примеры:
- Имя.
- полное доменное имя;
- различающееся имя (DN);
- Устаревшее различающееся имя Exchange
Свойства параметров
| Тип: | ServerIdParameter |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
GetChildren
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
Recurse
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
Identity
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.
Входы
Input types
Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.
Выходы
Output types
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.