Get-EXOMailboxFolderPermission

  • Ссылка
Модуль:
ExchangePowerShell
Применяется к:
Exchange Online

Этот командлет доступен только в модуле 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