Get-EXOMailboxFolderPermission
Этот командлет доступен только в модуле PowerShell Exchange Online. Дополнительные сведения см. в разделе Сведения о модуле PowerShell Exchange Online.
Используйте командлет Get-ExOMailboxFolderPermission для просмотра разрешений на уровне папок в почтовых ящиках.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Get-EXOMailboxFolderPermission
[[-Identity] <String>]
[-ExternalDirectoryObjectId <Guid>]
[-GroupMailbox]
[-PrimarySmtpAddress <String>]
[-User <String>]
[-UserPrincipalName <String>]
[<CommonParameters>]
Описание
Используйте этот командлет для получения разрешений на уровне папки в почтовом ящике.
Примеры
Пример 1
Get-EXOMailboxFolderPermission -Identity john@contoso.com:\Marketing\Reports
В этом примере возвращается текущий список разрешений пользователя для подпапки Reports из папки Marketing в почтовом ящике пользователя John.
Пример 2
Get-EXOMailboxFolderPermission -Identity john@contoso.com:\Marketing\Reports -User Kim@contoso.com
В этом примере возвращаются разрешения для той же папки в почтовом ящике Джона, но только для пользователя Kim.
Параметры
-ExternalDirectoryObjectId
Параметр ExternalDirectoryObjectId определяет почтовый ящик, который требуется просмотреть с помощью ObjectId в Azure Active Directory.
Этот параметр нельзя использовать с параметрами Identity, PrimarySmtpAddress или UserPrincipalName.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-GroupMailbox
Переключатель GroupMailbox необходим для возврата Группы Microsoft 365 в результатах. Для этого переключателя не требуется указывать значение.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Identity
Параметр Identity определяет папку почтового ящика, которую нужно просмотреть. Этот параметр использует синтаксис: <Mailbox>:\<Folder>
. Для максимальной производительности рекомендуется использовать идентификатор пользователя или имя участника-пользователя (UPN) для идентификации почтового ящика.
В противном случае можно использовать любое значение, однозначно определяющее почтовый ящик. Например:
- Имя
- Псевдоним
- Различающееся имя (DN)
- Различающееся имя (DN)
- LegacyExchangeDN
- SamAccountName
Этот параметр нельзя использовать с параметрами ExternalDirectoryObjectId, PrimarySmtpAddress или UserPrincipalName.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-PrimarySmtpAddress
PrimarySmtpAddress определяет почтовый ящик, который нужно просмотреть по основному SMTP-адресу электронной почты (например, navin@contoso.com).
Этот параметр нельзя использовать с параметрами ExternalDirectoryObjectId, Identity или UserPrincipalName.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-User
Параметр User фильтрует результаты по указанному почтовому ящику, пользователю почты или группе безопасности с включенной поддержкой почты (субъекту безопасности), которым разрешен доступ к папке почтового ящика. Можно использовать любое значение, уникальным образом идентифицирующее пользователя или группу. Например:
- Имя
- Псевдоним
- различающееся имя (DN);
- различающееся имя (DN);
- Каноническое краткое имя
- GUID
Примечание. Если указать пользователя, который не имеет разрешения на доступ к папке почтового ящика, команда вызовет исключение.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-UserPrincipalName
Параметр UserPrincipalName определяет почтовый ящик, который нужно просмотреть по имени участника-пользователя (например, navin@contoso.onmicrosoft.com).
Этот параметр нельзя использовать с параметрами ExternalDirectoryObjectId, Identity или PrimarySmtpAddress.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Online |