Add-VivaModuleFeaturePolicy
Этот командлет доступен только в модуле PowerShell Exchange Online версии 3.2.0 или более поздней. Дополнительные сведения см. в разделе Сведения о модуле PowerShell Exchange Online.
Используйте командлет Add-VivaModuleFeaturePolicy, чтобы добавить новую политику доступа для определенной функции в Viva. Атрибуты политики определяются с помощью параметров командлета. Политики используются для ограничения или предоставления доступа к указанной функции для определенных пользователей, групп или всего клиента.
- Для каждого компонента можно назначить до 10 политик. Для всего клиента можно назначить дополнительную политику для каждого компонента.
- Политики, назначенные конкретному пользователю или группе, имеют приоритет над политикой, назначенной всему клиенту, при определении того, включена ли функция. Если пользователю назначено несколько политик для функции (непосредственно в качестве пользователя или члена группы), применяется самая строгая политика.
- Некоторые функции поддерживают только политики, которые применяются ко всему клиенту, а не к конкретным пользователям или группам. Поддерживаемые области политики для компонента можно найти с помощью командлета Get-VivaModuleFeature .
Некоторые функции включают параметр для пользовательских элементов управления (пользователь отказался). См. документацию по компоненту, чтобы узнать, доступны ли пользовательские элементы управления для функции, для которой вы планируете задать политику.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (по умолчанию)
Add-VivaModuleFeaturePolicy
-FeatureId <String>
-IsFeatureEnabled <Boolean>
-ModuleId <String>
-Name <String>
[-Confirm]
[-Everyone]
[-GroupIds <String[]>]
[-IsUserControlEnabled <Boolean>]
[-IsUserOptedInByDefault <Boolean>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>]
Описание
Используйте командлет Add-VivaModuleFeaturePolicy, чтобы добавить новую политику доступа для определенной функции в Viva.
Для проверки подлинности необходимо использовать командлет Connect-ExchangeOnline.
Для этого командлета требуется платформа .NET Framework 4.7.2 или более поздней версии.
В настоящее время для выполнения этого командлета необходимо быть членом роли глобальных администраторов или ролей, назначенных на уровне компонентов.
Дополнительные сведения о назначенных ролях на уровне компонентов см. в статье Функции, доступные для управления доступом к функциям.
Дополнительные сведения о разрешениях роли администратора в идентификаторе Microsoft Entra см. в разделе Идентификаторы шаблонов ролей.
Важно!
Корпорация Майкрософт решительно выступает за принцип наименьших привилегий. Назначение учетным записям только минимальных разрешений, необходимых для выполнения их задач, помогает снизить риски безопасности и повысить общую защиту вашей организации. Глобальный администратор — это роль с высоким уровнем привилегий, которая обычно ограничивается сценариями чрезвычайных ситуаций или когда вы не можете использовать другую роль.
Примеры
Пример 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 -ModuleId PeopleSkills -FeatureId ShowAISkills -Name SoftDisableShowAISkillsPolicy -IsFeatureEnabled $true -IsUserControlEnabled $true -IsUserOptedInByDefault $false -UserIds user1@contoso.com,user2@contoso.com
В этом примере добавляется политика для функции ShowAISkills в Viva Skills. Политика включает функцию для указанных пользователей, разрешает пользовательские элементы управления и по умолчанию отключает пользователей (политика обратимого отключения).
Параметры
-Confirm
Применимо: Exchange Online
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Этот командлет имеет встроенную паузу, поэтому используйте -Confirm:$false , чтобы пропустить подтверждение.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Everyone
Применимо: Exchange Online
Параметр Все указывает, что политика применяется ко всем пользователям в организации. С этим параметром не нужно указывать значение.
Не используйте этот параметр с параметрами GroupIds или UserIds.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-FeatureId
Применимо: Exchange Online
Параметр FeatureId указывает компонент в модуле Viva, для которого требуется добавить политику.
Чтобы просмотреть сведения о функциях в модуле Viva, которые поддерживают элементы управления доступом к функциям, используйте командлет Get-VivaModuleFeature. Значение FeatureId возвращается в выходных данных командлета.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-GroupIds
Применимо: Exchange Online
Параметр GroupIds указывает адреса электронной почты или идентификаторы объектов групп безопасности, к которым применяется обновленная политика. Поддерживаются как группы с поддержкой почты, так и группы, не поддерживающие почту, Microsoft Entra. Update
Можно указать не более 20 пользователей или групп (20 пользователей и без групп, 10 пользователей и 10 групп и т. д.).
Чтобы применить политику ко всем пользователям в организации, используйте параметр Все.
Примечание. В версии 3.5.1-Preview2 или более поздней версии модуля этот параметр поддерживает идентификаторы объектов группы безопасности (GUID). Предыдущие версии модуля принимают только адреса электронной почты для этого параметра.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IsFeatureEnabled
Применимо: Exchange Online
Параметр IsFeatureEnabled указывает, включена ли эта функция политикой. Допустимые значения:
- $true: эта функция включена политикой.
- $false: эта функция не включена политикой.
Свойства параметра
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IsUserControlEnabled
Применимо: Exchange Online
Примечание. Этот параметр доступен в модуле версии 3.3.0-Preview1 или более поздней.
Параметр IsUserControlEnabled указывает, включается ли политика пользовательского управления. Допустимые значения:
- $true. Управление пользователем включается политикой. Пользователи могут отказаться от этой функции.
- $false. Пользовательский элемент управления не включен политикой. Пользователи не могут выбрать эту функцию.
Использовать этот параметр могут только функции, позволяющие администраторам включать и отключать пользовательские элементы управления с помощью политики. Если функция не поддерживает переключение пользовательских элементов управления администраторами, применяется значение по умолчанию. Дополнительные сведения см. в документации по функциям.
Свойства параметра
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IsUserOptedInByDefault
Применимо: Exchange Online
Примечание. Этот параметр доступен в модуле версии 3.8.0-Preview2 или более поздней.
Параметр IsUserOptedInByDefault указывает, есть ли у пользователей согласие по умолчанию в политике. Допустимые значения:
- $true. По умолчанию политика выбирает пользователей, если пользователь не задал предпочтение.
- $false. По умолчанию политика откловает пользователей, если пользователь не задал предпочтения.
Этот параметр является необязательным и может использоваться для переопределения значения согласия пользователя по умолчанию, заданного в метаданных компонента.
Этот параметр можно задать только в том случае, если для параметра IsUserControlEnabled задано значение $true.
Свойства параметра
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| 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 |
-Name
Применимо: Exchange Online
Параметр Name указывает имя политики. Максимальная длина имени составляет 256 символов. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Допустимыми символами являются английские буквы, цифры, запятые, точки и пробелы.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ResultSize
Применимо: Exchange Online
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметра
| Тип: | Unlimited |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-UserIds
Применимо: Exchange Online
Параметр UserIds указывает имена субъектов-пользователей (UPN) пользователей, к которым применяется политика. Update
Можно указать не более 20 пользователей или групп (20 пользователей и без групп, 10 пользователей и 10 групп и т. д.).
Чтобы применить политику ко всем пользователям в организации, используйте параметр Все.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Online
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.