Get-VivaModuleFeaturePolicy
Этот командлет доступен только в модуле PowerShell Exchange Online версии 3.2.0 или более поздней. Дополнительные сведения см. в разделе Сведения о модуле PowerShell Exchange Online.
Используйте командлет Get-VivaModuleFeaturePolicy, чтобы просмотреть политики доступа для указанной функции в модуле Viva в Viva. Политики используются для ограничения или предоставления доступа к указанной функции для определенных пользователей, групп или всего клиента. Этот командлет предоставляет сведения о политиках, включая идентификатор, имя и дату создания политики. Командлет может фильтровать политики на основе MemberIds, позволяя администраторам просматривать политики, характерные для определенных пользователей или групп.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
FeaturePolicy
Get-VivaModuleFeaturePolicy
[[-PolicyId] <String>]
-FeatureId <String>
-ModuleId <String>
[-ResultSize <Unlimited>]
[<CommonParameters>]
FeaturePolicyWithMembers
Get-VivaModuleFeaturePolicy
[[-FeatureId] <String>]
[[-MemberIds] <String[]>]
-ModuleId <String>
[-ResultSize <Unlimited>]
[<CommonParameters>]
Описание
Используйте командлет Get-VivaModuleFeaturePolicy, чтобы просмотреть политики доступа для указанной функции в модуле Viva в Viva.
Все политики для указанной функции можно просмотреть в модуле Viva в Viva. Чтобы просмотреть определенную политику, можно включить параметр PolicyId.
Командлет может фильтровать политики на основе MemberIds, позволяя администраторам просматривать политики, характерные для определенных пользователей или групп.
Для проверки подлинности необходимо использовать командлет Connect-ExchangeOnline.
Для этого командлета требуется платформа .NET Framework 4.7.2 или более поздней версии.
В настоящее время для выполнения этого командлета необходимо быть членом роли глобальных администраторов или ролей, назначенных на уровне компонентов.
Дополнительные сведения о назначенных ролях на уровне компонентов см. в статье Функции, доступные для управления доступом к функциям.
Дополнительные сведения о разрешениях роли администратора в идентификаторе Microsoft Entra см. в разделе Идентификаторы шаблонов ролей.
Важно!
Корпорация Майкрософт решительно выступает за принцип наименьших привилегий. Назначение учетным записям только минимальных разрешений, необходимых для выполнения их задач, помогает снизить риски безопасности и повысить общую защиту вашей организации. Глобальный администратор — это роль с высоким уровнем привилегий, которая обычно ограничивается сценариями чрезвычайных ситуаций или когда вы не можете использовать другую роль.
Примеры
Пример 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 user1@contoso.com
В этом примере возвращаются сведения о политиках для функции отражения в Viva Insights, которые применяются к пользователю с сообщением электронной почты user1@contoso.com.
Пример 4
Get-VivaModuleFeaturePolicy -ModuleId * -FeatureId * -MemberIds user1@contoso.com,group1@contoso.com
В этом примере возвращаются сведения о политиках для всех функций во всех модулях Viva, которые применяются к пользователю с сообщением электронной почты user1@contoso.com и группой с сообщением электронной почты group1@contoso.com.
Параметры
-FeatureId
Применимо: Exchange Online
Параметр FeatureId указывает компонент в модуле Viva, для которого требуется просмотреть политики.
Дополнительные сведения о функциях в модуле Viva, поддерживающем элементы управления доступом к функциям, см. в командлете Get-VivaModuleFeature. Сведения, предоставляемые командлетом Get-VivaModuleFeature, включают идентификатор компонента.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FeaturePolicy
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
FeaturePolicyWithMembers
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MemberIds
Применимо: Exchange Online
Примечание. Этот параметр доступен в модуле версии 3.8.1-Preview1 или более поздней.
Параметр MemberIds указывает конкретных пользователей или группы, для которых требуется просмотреть политики для компонента в модуле Viva.
Вы можете указать до трех идентификаторов участников. Используйте символ *, чтобы указать все модули или компоненты.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FeaturePolicyWithMembers
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ModuleId
Применимо: Exchange Online
Параметр ModuleId указывает Viva модуль политик компонентов, которые требуется просмотреть.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PolicyId
Применимо: Exchange Online
Параметр PolicyId указывает конкретную политику для компонента в модуле Viva, который требуется просмотреть.
Чтобы просмотреть сведения обо всех политиках для компонента в модуле Viva, выполните этот командлет без параметра PolicyId. Эти сведения включают идентификаторы всех политик для компонента в модуле Viva.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FeaturePolicy
| Position: | Positional |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ResultSize
Применимо: Exchange Online
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | Microsoft.Exchange.Management.RestApiClient.Unlimited`1[System.UInt32] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.