Get-VivaModuleFeatureEnablement
Этот командлет доступен только в модуле PowerShell Exchange Online версии 3.2.0 или более поздней. Дополнительные сведения см. в статье О модуле PowerShell Exchange Online.
Используйте командлет Get-VivaModuleFeatureEnablement, чтобы проверить, включена ли функция в модуле Viva для определенного пользователя или группы. Включение функции или нет называется "состоянием включения" функции. Состояние включения, возвращаемое этим командлетом, основано на политиках доступа, настроенных администратором.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
Get-VivaModuleFeatureEnablement
-FeatureId <String>
-Identity <String>
-ModuleId <String>
[-Detailed]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Описание
Используйте командлет Get-VivaModuleFeatureEnablement, чтобы проверить, включена ли функция в модуле Viva для определенного пользователя или группы.
Для проверки подлинности необходимо использовать командлет Connect-ExchangeOnline.
Для этого командлета требуется платформа .NET Framework 4.7.2 или более поздней версии.
В настоящее время для запуска этого командлета необходимо иметь роль глобального администратора.
Подробнее о разрешениях ролей администраторов в Microsoft Entra ID см. в разделе Идентификаторы шаблонов ролей.
Важно!
Корпорация Майкрософт решительно выступает за принцип минимальных привилегий. Назначение учетным записям только минимальных разрешений, необходимых для выполнения их задач, помогает снизить риски безопасности и усилить общую защиту организации. Глобальный администратор — это роль с высоким уровнем привилегий, которую вы обычно ограничиваете в чрезвычайных ситуациях или когда невозможно использовать другую роль.
Примеры
Пример 1
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com
В этом примере возвращается состояние включения функции Reflection в Viva Insights для user@contoso.com пользователя.
Пример 2
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity group@contoso.com
В этом примере возвращается состояние включения функции Reflection в Viva Insights для group@contoso.com группы.
Пример 3
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com -Detailed
В этом примере возвращается состояние включения функции Reflection в Viva Insights для user@contoso.com пользователя. Отклик расширен для предоставления дополнительных сведений о политиках, определяющих состояние включения функции
Параметры
-Detailed
Применимо: Exchange Online
Примечание: Этот параметр доступен в модуле версии 3.8.1-Preview1 или более поздней.
Переключатель "Подробные сведения" расширяет выходные данные команды, предоставляя более подробные сведения. С этим параметром не нужно указывать значение.
Этот переключатель возвращает подробные сведения, включая связанные политики и их эффективность.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-FeatureId
Применимо: Exchange Online
Параметр FeatureId определяет функцию в модуле Viva.
Чтобы просмотреть сведения о функциях в модуле Viva, поддерживающих управление доступом к функциям, обратитесь к командлету Get-VivaModuleFeature. Сведения, предоставленные командлетом Get-VivaModuleFeature, включают идентификатор функции.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Online
Параметр Identity указывает имя участника-пользователя (UPN) пользователя или SMTP-адрес (адрес электронной почты) группы, для которой необходимо просмотреть состояние включения функции.
Поддерживаются группы Microsoft Entra с поддержкой почты.
Внимание: значение $null или несуществующее значение параметра Identity возвращает все объекты так, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity точны и не содержат несуществующих значений $null.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ModuleId
Применимо: Exchange Online
Параметр ModuleId определяет модуль Viva.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ResultSize
Применимо: Exchange Online
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | Unlimited |
| Значение по умолчанию: | 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.