Поделиться через


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