Add-VivaModuleFeaturePolicy
Этот командлет доступен только в модуле PowerShell Exchange Online версии 3.2.0 или более поздней версии. Дополнительные сведения см. в разделе Сведения о модуле PowerShell Exchange Online.
Примечание. Этот командлет является частью функции, которая в настоящее время находится в закрытой закрытой предварительной версии. Командлет не будет работать, если ваша организация не является участником закрытой предварительной версии.
Используйте командлет Add-VivaModuleFeaturePolicy, чтобы добавить новую политику доступа для определенной функции в Viva. Атрибуты политики определяются с помощью различных параметров командлета . Политики используются для ограничения или предоставления доступа к указанной функции для определенных пользователей, групп или всего клиента. Обратите внимание, что наиболее строгая политика для конкретного пользователя или группы имеет приоритет при определении того, включена ли функция.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Add-VivaModuleFeaturePolicy
-FeatureId <String>
-IsFeatureEnabled <Boolean>
-ModuleId <String>
-Name <String>
[-Confirm]
[-GroupIds <String[]>]
[-UserIds <String[]>]
[-Everyone]
[-ResultSize <Unlimited>]
[-WhatIf]
[<CommonParameters>] Описание
Используйте командлет Add-VivaModuleFeaturePolicy, чтобы добавить новую политику доступа для определенной функции в Viva.
Для проверки подлинности необходимо использовать командлет Connect-ExchangeOnline.
Для этого командлета требуется платформа .NET Framework 4.7.2 или более поздней версии.
В настоящее время для выполнения этого командлета необходимо быть членом роли глобальных администраторов.
Дополнительные сведения о разрешениях роли администратора в Azure Active Directory см. в статье Идентификаторы шаблонов ролей.
Примеры
Пример 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В этом примере добавляется политика для функции отражения в 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 -UserIds user1@contoso.com,user2@contoso.comВ этом примере добавляется политика для функции отражения в Viva Insights. Политика отключает функцию для указанных пользователей и членов группы.
Параметры
-Confirm
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Everyone
Параметр Все указывает, что политика применяется ко всем пользователям в организации. Указывать значение для этого параметра необязательно.
Не используйте этот параметр с параметрами GroupIds или UserIds.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-FeatureId
Параметр FeatureId указывает компонент в модуле Viva, для которого требуется добавить политику.
Чтобы просмотреть сведения о функциях в модуле Viva, которые поддерживают элементы управления доступом к функциям, используйте командлет Get-VivaModuleFeature. Значение FeatureId возвращается в выходных данных командлета.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-GroupIds
Параметр GroupIds указывает SMTP-адреса (адреса электронной почты) групп, к которым применяется политика. Поддерживаются группы AAD с поддержкой почты. Update
Можно указать не более 20 пользователей или групп (20 пользователей и без групп, 10 пользователей и 10 групп и т. д.).
Чтобы применить политику ко всем пользователям в организации, используйте параметр Все.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-IsFeatureEnabled
Параметр IsFeatureEnabled указывает, включена ли эта функция политикой. Допустимые значения:
- $true: эта функция включена политикой.
- $false: эта функция не включена политикой.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ModuleId
Параметр ModuleId указывает модуль Viva, для которого требуется добавить политику компонентов.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Name
Параметр Name указывает имя политики. Максимальная длина имени составляет 256 символов. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Допустимыми символами являются английские буквы, цифры, запятые, точки и пробелы.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ResultSize
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-UserIds
Параметр UserIds указывает имена субъектов-пользователей (UPN) пользователей, к которым применяется политика. Update
Можно указать не более 20 пользователей или групп (20 пользователей и без групп, 10 пользователей и 10 групп и т. д.).
Чтобы применить политику ко всем пользователям в организации, используйте параметр Все.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-WhatIf
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |