Add-VivaModuleFeaturePolicy
Этот командлет доступен только в модуле PowerShell Exchange Online версии 3.2.0 или более поздней версии. Дополнительные сведения см. в разделе Сведения о модуле PowerShell Exchange Online.
Примечание. Поддержка категорий доступна в модуле 3.5.0-0-Preview2 или более поздней, но в Viva в настоящее время категории недоступны. Мы обновим документацию, когда категории будут доступны.
Используйте командлет Add-VivaModuleFeaturePolicy, чтобы добавить новую политику доступа для определенной функции или категории в Viva. Атрибуты политики определяются с помощью параметров командлета. Политики используются для ограничения или предоставления доступа к указанной функции или категории для конкретных пользователей, групп или всего клиента.
- Для каждого компонента или категории можно назначить до 10 политик. Для всего клиента можно назначить дополнительную политику для каждого компонента или категории.
- Политики, назначенные конкретному пользователю или группе, имеют приоритет над политикой, назначенной всему клиенту, при определении того, включена ли функция или категория. Если пользователю назначено несколько политик для функции или категории (непосредственно в качестве пользователя или члена группы), применяется наиболее строгая политика.
- Если категория отключена политиками категорий, все функции в категории отключаются независимо от политик, установленных на уровне компонентов.
- Вы можете обновлять пользовательские элементы управления только на уровне политики компонентов, а не на уровне политики категории.
- Некоторые функции поддерживают только политики, которые применяются ко всему клиенту, а не к конкретным пользователям или группам. Поддерживаемые области политики для компонента можно найти с помощью командлета Get-VivaModuleFeature .
Некоторые функции включают параметр для пользовательских элементов управления (пользователь отказался). См. документацию по компоненту, чтобы узнать, доступны ли пользовательские элементы управления для функции, для которой вы планируете задать политику.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Add-VivaModuleFeaturePolicy
-FeatureId <String>
-IsFeatureEnabled <Boolean>
-ModuleId <String>
-Name <String>
[-Confirm]
[-Everyone]
[-GroupIds <String[]>]
[-IsUserControlEnabled <Boolean>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>] Add-VivaModuleFeaturePolicy
-CategoryId <String>
-IsCategoryEnabled <Boolean>
-Name <String>
[-Confirm]
[-Everyone]
[-GroupIds <String[]>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>] Описание
Используйте командлет Add-VivaModuleFeaturePolicy, чтобы добавить новую политику доступа для определенной функции или категории в Viva.
Поддержка категорий доступна в модуле версии 3.5.0-0-Preview2 или более поздней.
Для проверки подлинности необходимо использовать командлет Connect-ExchangeOnline.
Для этого командлета требуется платформа .NET Framework 4.7.2 или более поздней версии.
В настоящее время для выполнения этого командлета необходимо быть членом роли глобальных администраторов или ролей, назначенных на уровне компонентов.
Дополнительные сведения о назначенных ролях на уровне компонентов см. в статье Функции, доступные для управления доступом к функциям.
Дополнительные сведения о разрешениях роли администратора в Microsoft Entra ID см. в разделе Идентификаторы шаблонов ролей.
Важно!
Microsoft рекомендует использовать роли с наименьшим количеством разрешений. Использование учетных записей с более низкими разрешениями помогает повысить безопасность организации. Глобальный администратор — это роль с высокими привилегиями, которую следует ограничивать экстренными сценариями, когда вы не можете использовать существующую роль.
Примеры
Пример 1
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name DisableFeatureForAll -IsFeatureEnabled $false -EveryoneВ этом примере добавляется политика для функции отражения в Viva Insights. Политика отключает эту функцию для всех пользователей в организации.
Пример 2
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleGroups -IsFeatureEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3В этом примере добавляется политика для функции отражения в Viva Insights. Политика отключает эту функцию для всех пользователей в указанных группах.
Пример 3
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleUsers -IsFeatureEnabled $false -UserIds user1@contoso.com,user2@contoso.comВ этом примере добавляется политика для функции отражения в Viva Insights. Политика отключает функцию для указанных пользователей.
Пример 4
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name UsersAndGroups -IsFeatureEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com,user2@contoso.comВ этом примере добавляется политика для функции отражения в Viva Insights. Политика отключает функцию для указанных пользователей и членов группы.
Пример 5
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name DisableCategoryForAll -IsCategoryEnabled $false -EveryoneВ этом примере добавляется политика для <category_id> категории в Viva. Политика отключает категорию (фактически все функции в категории) для всех пользователей в организации.
Пример 6
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name MultipleGroups -IsCategoryEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3В этом примере добавляется политика для <category_id> категории в Viva. Политика отключает категорию (фактически все функции в категории) для всех пользователей в указанных группах.
Пример 7
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name MultipleUsers -IsCategoryEnabled $false -UserIds user1@contoso.com,user2@contoso.comВ этом примере добавляется политика для <category_id> категории в Viva. Политика отключает категорию (фактически все функции в категории) для указанных пользователей.
Пример 8
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name UsersAndGroups -IsCategoryEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com,user2@contoso.comВ этом примере добавляется политика для <category_id> категории в Viva. Политика отключает категорию (фактически все функции в категории) для указанных пользователей и членов группы.
Пример 9
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name "Disable Category For All" -IsCategoryEnabled $false -EveryoneВ этом примере добавляется политика для <category_id> категории в Viva, где имя политики содержит пробелы. Политика отключает категорию (фактически все функции в категории) для всех пользователей в организации.
Параметры
-CategoryId
Этот параметр доступен в версии 3.5.0-Preview2 или более поздней версии модуля.
Примечание. В настоящее время в Viva нет доступных категорий. Мы обновим документацию, когда категории будут доступны.
Параметр CategoryId указывает Viva категорию, для которой требуется добавить политику.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Exchange Online |
-Confirm
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Этот командлет имеет встроенную паузу, поэтому используйте -Confirm:$false , чтобы пропустить подтверждение.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Exchange Online |
-Everyone
Параметр Все указывает, что политика применяется ко всем пользователям в организации. С этим параметром не нужно указывать значение.
Не используйте этот параметр с параметрами GroupIds или UserIds.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Exchange Online |
-FeatureId
Параметр FeatureId указывает компонент в модуле Viva, для которого требуется добавить политику.
Чтобы просмотреть сведения о функциях в модуле Viva, которые поддерживают элементы управления доступом к функциям, используйте командлет Get-VivaModuleFeature. Значение FeatureId возвращается в выходных данных командлета.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Exchange Online |
-GroupIds
Параметр GroupIds указывает адреса электронной почты или идентификаторы объектов групп безопасности, к которым применяется обновленная политика. Поддерживаются как группы с поддержкой почты, так и группы, не поддерживающие почту, Microsoft Entra. Update
Можно указать не более 20 пользователей или групп (20 пользователей и без групп, 10 пользователей и 10 групп и т. д.).
Чтобы применить политику ко всем пользователям в организации, используйте параметр Все.
Примечание. В версии 3.5.1-Preview2 или более поздней версии модуля этот параметр поддерживает идентификаторы объектов группы безопасности (GUID). Предыдущие версии модуля принимают только адреса электронной почты для этого параметра.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Exchange Online |
-IsCategoryEnabled
Этот параметр доступен в версии 3.5.0-Preview2 или более поздней версии модуля.
Примечание. В настоящее время в Viva нет доступных категорий. Мы обновим документацию, когда категории будут доступны.
Параметр IsCategoryEnabled указывает, включена ли категория политикой. Допустимые значения:
- $true: категория включена политикой.
- $false: категория не включена политикой.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Exchange Online |
-IsFeatureEnabled
Параметр IsFeatureEnabled указывает, включена ли эта функция политикой. Допустимые значения:
- $true: эта функция включена политикой.
- $false: эта функция не включена политикой.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Exchange Online |
-IsUserControlEnabled
Этот параметр доступен в модуле 3.3.0 или более поздней версии.
Параметр IsUserControlEnabled указывает, включается ли политика пользовательского управления. Допустимые значения:
- $true. Управление пользователем включается политикой. Пользователи могут отказаться от этой функции.
- $false. Пользовательский элемент управления не включен политикой. Пользователи не могут выбрать эту функцию.
Использовать этот параметр могут только функции, позволяющие администраторам включать и отключать пользовательские элементы управления с помощью политики. Если функция не поддерживает переключение пользовательских элементов управления администраторами, применяется значение по умолчанию. Дополнительные сведения см. в документации по функциям.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Exchange Online |
-ModuleId
Параметр ModuleId указывает Viva модуль, для которого требуется добавить политику компонентов.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Exchange Online |
-Name
Параметр Name указывает имя политики. Максимальная длина имени составляет 256 символов. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Допустимыми символами являются английские буквы, цифры, запятые, точки и пробелы.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Exchange Online |
-ResultSize
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Тип: | Unlimited |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Exchange Online |
-UserIds
Параметр UserIds указывает имена субъектов-пользователей (UPN) пользователей, к которым применяется политика. Update
Можно указать не более 20 пользователей или групп (20 пользователей и без групп, 10 пользователей и 10 групп и т. д.).
Чтобы применить политику ко всем пользователям в организации, используйте параметр Все.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Exchange Online |
-WhatIf
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Exchange Online |