Get-EXORecipientPermission
Этот командлет доступен только в модуле PowerShell Exchange Online. Дополнительные сведения см. в разделе Сведения о модуле PowerShell Exchange Online.
Используйте командлет Get-EXORecipientPermission для просмотра сведений о разрешениях sendAs, настроенных для пользователей в облачной организации.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
Get-EXORecipientPermission
[-AccessRights <MultiValuedProperty>]
[-ResultSize <Unlimited>]
[-Trustee <String>]
[<CommonParameters>]
Identity
Get-EXORecipientPermission
[[-Identity] <String>]
[-AccessRights <MultiValuedProperty>]
[-ExternalDirectoryObjectId <Guid>]
[-PrimarySmtpAddress <String>]
[-ResultSize <Unlimited>]
[-Trustee <String>]
[-UserPrincipalName <String>]
[<CommonParameters>]
Описание
Этот командлет используется для просмотра и управления сведениями о разрешениях SendAs, настроенных для пользователей в облачной организации. Разрешение Отправить как позволяет делегатам использовать почтовый ящик для отправки сообщений. После назначения этого разрешения делегату все сообщения, отправляемые делегатом из почтового ящика, будут отправлены владельцем почтового ящика. Тем не менее это разрешение не позволяет делегату входить в почтовый ящик этого пользователя. Оно только позволяет пользователям открывать почтовый ящик. Если это разрешение назначено группе, сообщение, отправленное делегатом, как представляется, отправляется группой.
Примеры
Пример 1
Get-EXORecipientPermission -ResultSize 100
В приведенном выше примере возвращается разрешение получателя для первых 100 пользователей почтовых ящиков в порядке сортировки имен.
Параметры
-AccessRights
Применимо: Exchange Online
Параметр AccessRights фильтрует результаты по разрешению. Единственное допустимое значение для этого параметра — SendAs.
Свойства параметров
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExternalDirectoryObjectId
Применимо: Exchange Online
Параметр ExternalDirectoryObjectId определяет получателя, который вы хотите просмотреть с помощью ObjectId в Microsoft Entra ID.
Этот параметр нельзя использовать с параметрами Identity, PrimarySmtpAddress или UserPrincipalName.
Свойства параметров
| Тип: | Guid |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Identity
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Online
Параметр Identity определяет получателя, которого требуется просмотреть. Пользователь или группа, указанные параметром Trustee, имеют разрешения "Отправить как" для этого получателя. Можно указать любой тип получателя, например:
- Почтовые ящики
- Почтовые пользователи
- Почтовые контакты
- Группы рассылки
- Динамические группы рассылки
Для максимальной производительности рекомендуется использовать следующие значения для определения получателя:
- Идентификатор пользователя или имя участника-пользователя
- GUID
В противном случае можно использовать любое значение, однозначно определяющее почтовый ящик. Например:
- Имя
- Псевдоним
- различающееся имя (DN);
- Домен\Имя пользователя
- Адрес электронной почты
- LegacyExchangeDN
- SamAccountName
Этот параметр нельзя использовать с параметрами ExternalDirectoryObjectId, PrimarySmtpAddress или UserPrincipalName.
Внимание! Значение $null или несуществующее значение для параметра Identity возвращает все объекты, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity являются точными и не содержат несуществующих $null значений.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Identity
| Position: | 0 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-PrimarySmtpAddress
Применимо: Exchange Online
PrimarySmtpAddress определяет получателя, которого вы хотите просмотреть по основному SMTP-адресу электронной почты (например, navin@contoso.com).
Этот параметр нельзя использовать с параметрами ExternalDirectoryObjectId, Identity или UserPrincipalName.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Identity
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-ResultSize
Применимо: Exchange Online
Параметр ResultSize указывает максимальное число возвращаемых результатов. Если требуется возвратить все результаты, отвечающие условиям запроса, используйте для этого параметра значение unlimited. Значение по умолчанию — 1000.
Свойства параметров
| Тип: | Unlimited |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Trustee
Применимо: Exchange Online
Параметр Trustee фильтрует результаты по пользователю или группе, имеющим разрешения "Отправить как". Можно указать следующие типы пользователей или групп:
- Пользователи почтовых ящиков.
- Почта пользователей с учетной записью Майкрософт
- Группы безопасности
Можно использовать любое значение, уникальным образом идентифицирующее пользователя или группу. Например:
- Имя
- Псевдоним
- различающееся имя (DN);
- различающееся имя (DN);
- Домен\Имя пользователя
- Адрес электронной почты
- Имя участника-пользователя (UPN)
Этот параметр необходимо использовать с параметрами Identity, PrimarySmtpAddress, UserPrincipalName или ExternalDirectoryObjectId.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-UserPrincipalName
Применимо: Exchange Online
Параметр UserPrincipalName определяет получателя, который вы хотите просмотреть по имени участника-пользователя (например, navin@contoso.onmicrosoft.com).
Этот параметр нельзя использовать с параметрами ExternalDirectoryObjectId, Identity или PrimarySmtpAddress.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Identity
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.