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 ID см. в разделе Идентификаторы шаблонов ролей.
Важно!
Корпорация Майкрософт решительно выступает за принцип минимальных привилегий. Назначение учетным записям только минимальных разрешений, необходимых для выполнения их задач, помогает снизить риски безопасности и усилить общую защиту организации. Глобальный администратор — это роль с высоким уровнем привилегий, которую вы обычно ограничиваете в чрезвычайных ситуациях или когда невозможно использовать другую роль.
Примеры
Пример 1
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection
В этом примере возвращаются сведения обо всех политиках, добавленных для функции Reflection в Viva Insights.
Пример 2
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b
В этом примере возвращаются сведения о конкретной политике, добавленной для функции Reflection в Viva Insights.
Пример 3
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -MemberIds user1@contoso.com
В этом примере возвращаются сведения о политиках функции Reflection в 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 |
| Значение по умолчанию: | 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[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FeaturePolicyWithMembers
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ModuleId
Применимо: Exchange Online
Параметр ModuleId указывает модуль Viva для политик функций, которые требуется просмотреть.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PolicyId
Применимо: Exchange Online
Параметр PolicyId указывает конкретную политику для функции в модуле Viva, которую вы хотите просмотреть.
Чтобы просмотреть сведения обо всех политиках для функции в модуле Viva, запустите этот командлет без параметра PolicyId. Эти сведения включают идентификаторы всех политик для функции в модуле Viva.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FeaturePolicy
| Position: | Positional |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ResultSize
Применимо: Exchange Online
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | Microsoft.Exchange.Management.RestApiClient.Unlimited`1[System.UInt32] |
| Значение по умолчанию: | 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.