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

Update-VivaModuleFeaturePolicy

Модуль:
ExchangePowerShell
Применяется к:
Exchange Online

Этот командлет доступен только в модуле PowerShell Exchange Online версии 3.2.0 или более поздней версии. Дополнительные сведения см. в разделе Сведения о модуле PowerShell Exchange Online.

Используйте командлет Update-VivaModuleFeaturePolicy для обновления политики доступа для компонента в модуле Viva в Viva.

  • Вы не можете обновить политику для конкретного пользователя или группы, чтобы включить весь клиент, если политика для всего клиента уже существует для этой функции. Поддерживается только одна политика на уровне клиента.
  • Политики, назначенные конкретному пользователю или группе, имеют приоритет над политикой, назначенной всему клиенту, при определении того, включена ли функция. Если пользователю назначено несколько политик для функции (непосредственно в качестве пользователя или члена группы), применяется самая строгая политика.
  • Некоторые функции поддерживают только политики, которые применяются ко всему клиенту, а не к конкретным пользователям или группам. Поддерживаемые области политики для компонента можно найти с помощью командлета Get-VivaModuleFeature .

Некоторые функции включают параметр для пользовательских элементов управления (пользователь отказался). См. документацию по компоненту, чтобы узнать, доступны ли пользовательские элементы управления для функции, для которой вы планируете задать политику.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Update-VivaModuleFeaturePolicy
      -FeatureId <String>
      -ModuleId <String>
      -PolicyId <String>
      [-Confirm]
      [-Everyone <Boolean>]
      [-IsFeatureEnabled <Boolean>]
      [-IsUserControlEnabled <Boolean>]
      [-IsUserOptedInByDefault <Boolean>]
      [-GroupIds <String[]>]
      [-Name <String>]
      [-ResultSize <Unlimited>]
      [-UserIds <String[]>]
      [-WhatIf]
      [<CommonParameters>]

Описание

Используйте командлет Update-VivaModuleFeaturePolicy для обновления политики доступа для компонента в модуле Viva в Viva.

Этот командлет обновляет атрибуты указанной политики. К этим атрибутам относятся:

  • Имя политики (параметр Name).
  • Указывает, включает ли политика эту функцию (параметр IsFeatureEnabled).
  • Указывает, включает ли политика пользовательские элементы управления (параметр IsUserControlEnabled, применимый только к политике компонентов).
  • К кому применяется политика (параметры UserIds и GroupIds или параметр Все).

Эти атрибуты можно обновлять независимо друг от друга. Например, если указать параметр Name, но не параметр IsFeatureEnabled, имя политики будет обновлено, но независимо от того, включает ли политика эту функцию, остается без изменений.

Важно! Значения, указанные для параметров UserIds и (или) GroupIds или параметра Все , перезаписывают все существующие пользователи или группы. Чтобы сохранить существующих пользователей и группы, необходимо указать этих существующих пользователей или группы , а также всех дополнительных пользователей или групп, которые вы хотите добавить. Если не включить в команду существующих пользователей или групп, эти пользователи или группы будут удалены из политики. Дополнительные сведения см. в примерах.

Для проверки подлинности необходимо использовать командлет Connect-ExchangeOnline.

Для этого командлета требуется платформа .NET Framework 4.7.2 или более поздней версии.

В настоящее время для выполнения этого командлета необходимо быть членом роли глобальных администраторов или ролей, назначенных на уровне компонентов.

Дополнительные сведения о назначенных ролях на уровне компонентов см. в статье Функции, доступные для управления доступом к функциям.

Дополнительные сведения о разрешениях роли администратора в Microsoft Entra ID см. в разделе Идентификаторы шаблонов ролей.

Важно!

Microsoft рекомендует использовать роли с наименьшим количеством разрешений. Использование учетных записей с более низкими разрешениями помогает повысить безопасность организации. Глобальный администратор — это роль с высокими привилегиями, которую следует ограничивать экстренными сценариями, когда вы не можете использовать существующую роль.

Примеры

Пример 1

Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b1 -Name NewPolicyName -IsFeatureEnabled $false

В этом примере обновляется имя указанной политики и делается так, что политика не включает эту функцию.

Пример 2

Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -GroupIds [email protected],[email protected]

В этом примере обновляется, к кому применяется указанная политика. Теперь политика применяется только к указанным группам, перезаписав пользователей и группы, к которым применяется политика.

Пример 3

Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -UserIds [email protected],[email protected]

В этом примере обновляется, к кому применяется указанная политика. Теперь политика применяется только к указанным пользователям, перезаписав пользователей и групп, к которым применяется политика.

Пример 4

Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -Name NewPolicyName -IsFeatureEnabled $true -GroupIds [email protected],57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds [email protected]

В этом примере обновляется имя указанной политики, делается так, чтобы она включила функцию, а также обновляется, к кому применяется политика. Теперь политика применяется только к указанным пользователям и группам, перезаписав пользователей и групп, к которым применялась политика.

Пример 5

Update-VivaModuleFeaturePolicy -ModuleId PeopleSkills -FeatureId ShowAISkills -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -IsFeatureEnabled $true -IsUserControlEnabled $true -IsUserOptedInByDefault $false

В этом примере обновляется политика для функции ShowAISkills в Viva Skills. Политика включает функцию для пользователей, ранее добавленных в политику, разрешает пользовательские элементы управления и по умолчанию отключает пользователей (политика обратимого отключения).

Параметры

-Confirm

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

  • Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Online

-Everyone

Параметр Все указывает, что обновленная политика применяется ко всем пользователям в организации. Допустимые значения:

  • $true: политика применяется ко всем пользователям. Это единственное полезное значение для этого параметра.
  • $false: не используйте это значение.

Если вы не хотите обновлять пользователей, к которым применяется политика, не используйте этот параметр.

Не используйте этот параметр с параметрами GroupIds или UserIds.

Тип:Boolean
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

Если вы не хотите обновлять пользователей, к которым применяется политика, не используйте этот параметр.

Значения, указанные для этого параметра или параметра UserIds, заменяют все существующие группы. Чтобы сохранить существующие группы, включите их вместе с новыми пользователями или группами, которые вы указали.

Можно указать не более 20 пользователей или групп (20 пользователей и без групп, 10 пользователей и 10 групп и т. д.).

Чтобы применить обновленную политику ко всем пользователям в организации, используйте параметр Все со значением $true.

Примечание. В версии 3.5.1-Preview2 или более поздней версии модуля этот параметр поддерживает идентификаторы объектов группы безопасности (GUID). Предыдущие версии модуля принимают только адреса электронной почты для этого параметра.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Online

-IsFeatureEnabled

Параметр IsFeatureEnabled указывает, включена ли функция обновленной политикой. Допустимые значения:

  • $true: эта функция включена политикой.
  • $false: эта функция не включена политикой.

Если вы не хотите обновлять, включена ли эта функция политикой, не используйте этот параметр.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Online

-IsUserControlEnabled

Примечание. Этот параметр доступен в модуле 3.3.0 или более поздней версии. Если функция поддерживает пользовательские элементы управления для отказа, убедитесь, что при создании политики задан параметр IsUserControlEnabled . В противном случае пользовательские элементы управления для политики используют состояние по умолчанию для компонента.

Параметр IsUserControlEnabled указывает, включается ли политика пользовательского управления. Допустимые значения:

  • $true. Управление пользователем включается политикой. Пользователи могут отказаться от этой функции.
  • $false. Пользовательский элемент управления не включен политикой. Пользователи не могут выбрать эту функцию.

Использовать этот параметр могут только функции, позволяющие администраторам включать и отключать пользовательские элементы управления с помощью политики. Если функция не поддерживает переключение пользовательских элементов управления администраторами, применяется значение по умолчанию. Дополнительные сведения см. в документации по функциям.

Если вы не хотите обновлять, включен ли пользовательский элемент управления политикой, не используйте этот параметр.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Online

-IsUserOptedInByDefault

Этот параметр доступен в версии 3.8.0-Preview2 или более поздней версии модуля.

Параметр IsUserOptedInByDefault указывает, есть ли у пользователей согласие по умолчанию в политике. Допустимые значения:

  • $true. По умолчанию политика выбирает пользователей, если пользователь не задал предпочтение.
  • $false. По умолчанию политика откловает пользователей, если пользователь не задал предпочтения.

Этот параметр является необязательным и может использоваться для переопределения значения согласия пользователя по умолчанию, заданного в метаданных компонента.

Этот параметр можно задать только в том случае, если для параметра IsUserControlEnabled задано значение $true.

Тип: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
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False
Применяется к:Exchange Online

-PolicyId

Параметр PolicyId указывает политику для компонента в модуле Viva, который требуется обновить.

Чтобы просмотреть сведения о политиках для компонента в модуле Viva, используйте командлет Get-VivaModuleFeaturePolicy. Значение PolicyId возвращается в выходных данных командлета.

Тип: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

Если вы не хотите обновлять пользователей, к которым применяется политика, не используйте этот параметр.

Значения, указанные для этого параметра или параметра GroupIds, заменяют всех существующих пользователей. Чтобы сохранить существующих пользователей, включите их вместе с новыми пользователями или группами, которые вы указали.

Можно указать не более 20 пользователей или групп (20 пользователей и без групп, 10 пользователей и 10 групп и т. д.).

Чтобы применить обновленную политику ко всем пользователям в организации, используйте параметр Все со значением $true.

Тип: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