Поделиться через


Get-VivaModuleFeaturePolicy

Этот командлет доступен только в модуле PowerShell Exchange Online версии 3.2.0 или более поздней версии. Дополнительные сведения см. в разделе Сведения о модуле PowerShell Exchange Online.

Используйте командлет Get-VivaModuleFeaturePolicy, чтобы просмотреть политики доступа для указанной функции в модуле Viva в Viva. Политики используются для ограничения или предоставления доступа к указанной функции для определенных пользователей, групп или всего клиента. Этот командлет предоставляет сведения о политиках, включая идентификатор, имя и дату создания политики. Командлет может фильтровать политики на основе MemberIds, позволяя администраторам просматривать политики, характерные для определенных пользователей или групп.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Get-VivaModuleFeaturePolicy
   -FeatureId <String>
   -ModuleId <String>
   [[-PolicyId] <String>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-VivaModuleFeaturePolicy
   -ModuleId <String>
   [[-FeatureId] <String>]
   [[-MemberIds] <String[]>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Описание

Используйте командлет Get-VivaModuleFeaturePolicy, чтобы просмотреть политики доступа для указанной функции в модуле Viva в Viva.

Все политики для указанной функции можно просмотреть в модуле Viva в Viva. Чтобы просмотреть определенную политику, можно включить параметр PolicyId.

Командлет может фильтровать политики на основе MemberIds, позволяя администраторам просматривать политики, характерные для определенных пользователей или групп.

Для проверки подлинности необходимо использовать командлет Connect-ExchangeOnline.

Для этого командлета требуется платформа .NET Framework 4.7.2 или более поздней версии.

В настоящее время для выполнения этого командлета необходимо быть членом роли глобальных администраторов или ролей, назначенных на уровне компонентов.

Дополнительные сведения о назначенных ролях на уровне компонентов см. в статье Функции, доступные для управления доступом к функциям.

Дополнительные сведения о разрешениях роли администратора в Microsoft Entra ID см. в разделе Идентификаторы шаблонов ролей.

Важно!

Microsoft рекомендует использовать роли с наименьшим количеством разрешений. Использование учетных записей с более низкими разрешениями помогает повысить безопасность организации. Глобальный администратор — это роль с высокими привилегиями, которую следует ограничивать экстренными сценариями, когда вы не можете использовать существующую роль.

Примеры

Пример 1

Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection

В этом примере возвращаются сведения обо всех политиках, добавленных для функции отражения в Viva Insights.

Пример 2

Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b

В этом примере возвращаются сведения о конкретной политике, добавленной для функции отражения в Viva Insights.

Пример 3

Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -MemberIds [email protected]

В этом примере возвращаются сведения о политиках для функции отражения в Viva Insights, которые применяются к пользователю с сообщением электронной почты [email protected].

Пример 4

Get-VivaModuleFeaturePolicy -ModuleId * -FeatureId * -MemberIds [email protected],[email protected]

В этом примере возвращаются сведения о политиках для всех функций во всех модулях Viva, которые применяются к пользователю с сообщением электронной почты [email protected] и группой с сообщением электронной почты [email protected].

Параметры

-FeatureId

Параметр FeatureId указывает компонент в модуле Viva, для которого требуется просмотреть политики.

Дополнительные сведения о функциях в модуле Viva, поддерживающем элементы управления доступом к функциям, см. в командлете Get-VivaModuleFeature. Сведения, предоставляемые командлетом Get-VivaModuleFeature, включают идентификатор компонента.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Online

-MemberIds

Параметр MemberIds указывает конкретных пользователей или группы, для которых требуется просмотреть политики для компонента в модуле Viva.

Вы можете указать до трех идентификаторов участников. Используйте символ *, чтобы указать все модули или компоненты.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Online

-ModuleId

Параметр ModuleId указывает Viva модуль политик компонентов, которые требуется просмотреть.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Online

-PolicyId

Параметр PolicyId указывает конкретную политику для компонента в модуле Viva, который требуется просмотреть.

Чтобы просмотреть сведения обо всех политиках для компонента в модуле Viva, выполните этот командлет без параметра PolicyId. Эти сведения включают идентификаторы всех политик для компонента в модуле Viva.

Тип:String
Position:Positional
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Online

-ResultSize

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Тип:Microsoft.Exchange.Management.RestApiClient.Unlimited`1[System.UInt32]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Online