Update-VivaModuleFeaturePolicy
Этот командлет доступен только в модуле PowerShell Exchange Online версии 3.2.0 или более поздней. Дополнительные сведения см. в статье О модуле PowerShell Exchange Online.
Используйте командлет Update-VivaModuleFeaturePolicy для обновления политики доступа для функции в модуле Viva в Viva.
- Невозможно обновить политику для определенного пользователя или группы, чтобы включить весь клиент, если для функции уже существует политика для всего клиента. Поддерживается только одна политика на уровне клиента.
- Политики, назначенные определенному пользователю или группе, имеют приоритет над политикой, назначенной всему клиенту, при определении того, включена ли функция. Если пользователю назначено несколько политик для функции (непосредственно в качестве пользователя или участника группы), применяется наиболее строгая политика.
- Некоторые функции поддерживают политики, которые применяются только ко всему клиенту, но не к отдельным пользователям или группам. Вы можете сослаться на поддерживаемые области политик для функции с помощью командлета Get-VivaModuleFeature .
Некоторые функции включают параметр пользовательских элементов управления (отказ пользователя). Обратитесь к документации по функциям, чтобы узнать, доступны ли пользовательские элементы управления для функции, для которой вы собираетесь настроить политику.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
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 или параметр Everyone).
Обновлять эти атрибуты можно независимо друг от друга. Например, если вы указываете параметр Name, но не IsFeatureEnabled, имя политики обновляется, но независимо от того, включает ли политика функцию, остается неизменным.
Важно! Значения, указанные вами для параметров UserIds и (или) GroupIds или параметра Everyone , перезаписывают всех существующих пользователей или группы. Чтобы сохранить существующих пользователей и группы, необходимо указать существующих пользователей или группы, а также любых дополнительных пользователей или групп, которые нужно добавить. Если не включать существующих пользователей или группы в команду, эти конкретные пользователи или группы будут удалены из политики. Дополнительные сведения см. в примерах.
Для проверки подлинности необходимо использовать командлет Connect-ExchangeOnline.
Для этого командлета требуется платформа .NET Framework 4.7.2 или более поздней версии.
В настоящее время для запуска этого командлета необходимо быть участником роли глобальных администраторов или ролей, назначенных на уровне функций.
Дополнительные сведения о назначенных ролях на уровне функций см. в разделе Функции, доступные для управления доступом к функциям.
Подробнее о разрешениях ролей администраторов в Microsoft Entra ID см. в разделе Идентификаторы шаблонов ролей.
Важно!
Корпорация Майкрософт решительно выступает за принцип минимальных привилегий. Назначение учетным записям только минимальных разрешений, необходимых для выполнения их задач, помогает снизить риски безопасности и усилить общую защиту организации. Глобальный администратор — это роль с высоким уровнем привилегий, которую вы обычно ограничиваете в чрезвычайных ситуациях или когда невозможно использовать другую роль.
Примеры
Пример 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 group1@contoso.com,group2@contoso.com
В этом примере обновляется, к кому применяется указанная политика. Политика теперь применяется только к указанным группам, перезаписывая пользователей и группы, к которым раньше применялась политика.
Пример 3
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -UserIds user1@contoso.com,user2@contoso.com
В этом примере обновляется, к кому применяется указанная политика. Теперь политика применяется только к указанным пользователям, перезаписывая пользователей и группы, к которым раньше применялась политика.
Пример 4
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -Name NewPolicyName -IsFeatureEnabled $true -GroupIds group1@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com
В этом примере обновляется имя указанной политики, делается так, чтобы политика включала функцию, и обновляется, к кому применяется политика. Политика теперь применяется только к указанным пользователям и группам, перезаписывая пользователей и группы, к которым раньше применялась политика.
Пример 5
Update-VivaModuleFeaturePolicy -ModuleId PeopleSkills -FeatureId ShowAISkills -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -IsFeatureEnabled $true -IsUserControlEnabled $true -IsUserOptedInByDefault $false
В этом примере обновляется политика для функции ShowAISkills в Viva Skills. Политика включает функцию для пользователей, ранее добавленных в политику, разрешает пользовательские элементы управления и по умолчанию отказывается от них (политика мягкого отключения).
Параметры
-Confirm
Применимо: Exchange Online
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. То, как этот переключатель влияет на командлет, зависит от того, требует ли командлет подтверждения перед продолжением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Everyone
Применимо: Exchange Online
Параметр Everyone указывает, что обновленная политика применяется ко всем пользователям в организации. Допустимые значения:
- $true. Политика применяется ко всем пользователям. Это единственное полезное значение для этого параметра.
- $false. Не используйте это значение.
Если вы не хотите обновлять, к кому применяется политика, не используйте этот параметр.
Не используйте этот параметр с параметрами GroupIds или UserIds.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-FeatureId
Применимо: Exchange Online
Параметр FeatureId указывает функцию в модуле Viva, которую необходимо обновить.
Чтобы просмотреть сведения о функциях в модуле Viva, поддерживающих управление доступом к функциям, используйте командлет Get-VivaModuleFeature. Значение FeatureId возвращается в выходных данных командлета.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-GroupIds
Применимо: Exchange Online
Параметр GroupIds указывает адреса электронной почты или идентификаторы объектов группы безопасности (GUID) групп, к которым применяется обновленная политика. Поддерживаются группы Microsoft Entra с поддержкой и без нее. Update
Если вы не хотите обновлять, к кому применяется политика, не используйте этот параметр.
Значения, указанные для этого параметра или параметра UserIds, заменяют все существующие группы. Чтобы сохранить существующие группы, включите их вместе с новыми пользователями или группами, которых вы укажете.
Можно указать не более 20 пользователей или групп (20 пользователей и ни одной группы, 10 пользователей и 10 групп и т. д.).
Чтобы обновленная политика применялась ко всем пользователям в организации, используйте параметр Everyone со значением $true.
Примечание. В версии 3.5.1-Preview2 или более поздних версиях модуля этот параметр поддерживает идентификаторы объектов группы безопасности (GUID). Предыдущие версии модуля принимали только адреса электронной почты для этого параметра.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IsFeatureEnabled
Применимо: Exchange Online
Параметр IsFeatureEnabled указывает, включена ли функция обновленной политикой. Допустимые значения:
- $true. Эта функция включена политикой.
- $false. Эта функция не включена политикой.
Если вы не хотите обновлять сведения о том, включена ли функция политикой, не используйте этот параметр.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IsUserControlEnabled
Применимо: Exchange Online
Примечание: Этот параметр доступен в модуле версии 3.3.0-Preview1 или более поздней. Если функция поддерживает пользовательские элементы управления для отказа, не забудьте установить параметр IsUserControlEnabled при создании политики. В противном случае пользовательские элементы управления политикой используют состояние по умолчанию для функции.
Параметр IsUserControlEnabled указывает, включена ли политика пользовательским элементом управления. Допустимые значения:
- $true. Политика включает пользовательский контроль. Пользователи могут отказаться от использования этой функции.
- $false. Политика не включает пользовательский контроль. Пользователи не могут выбрать эту функцию.
Этот параметр можно использовать только для тех компонентов, которые позволяют администраторам включать и отключать пользовательские элементы управления с помощью политики. Если функция не поддерживает переключение пользовательских элементов управления администраторами, применяется значение по умолчанию. Дополнительные сведения см. в документации по функциям.
Если вы не хотите обновлять сведения о том, включен ли пользовательский элемент управления политикой, не используйте этот параметр.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IsUserOptedInByDefault
Применимо: Exchange Online
Примечание: Этот параметр доступен в модуле версии 3.8.0-Preview2 или более поздней.
Параметр IsUserOptedInByDefault указывает, включены ли пользователи по умолчанию в политике. Допустимые значения:
- $true. По умолчанию политика дает согласие на ее использование, если пользователь не настроил параметр.
- $false. По умолчанию пользователи отказываются от политики, если пользователь не настроил параметр.
Этот параметр не является обязательным и может использоваться для переопределения значения согласия пользователя по умолчанию, заданного в метаданных функции.
Этот параметр можно задать, только если параметру IsUserControlEnabled присвоено значение $true.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ModuleId
Применимо: Exchange Online
Параметр ModuleId указывает модуль Viva политики, которую требуется обновить.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Применимо: Exchange Online
Параметр Name указывает обновленное имя политики. Максимальная длина имени составляет 256 символов. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Допустимыми знаками являются английские буквы, цифры, запятые, точки и пробелы.
Если вы не хотите обновлять имя политики, не используйте этот параметр.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PolicyId
Применимо: Exchange Online
Параметр PolicyId указывает политику для функции в модуле Viva, которую требуется обновить.
Чтобы просмотреть сведения о политиках функции в модуле Viva, используйте командлет Get-VivaModuleFeaturePolicy. Значение PolicyId возвращается в выходных данных командлета.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ResultSize
Применимо: Exchange Online
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | Unlimited |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-UserIds
Применимо: Exchange Online
Параметр UserIds указывает имена участников-пользователей (UPN) пользователей, к которым применяется обновленная политика. Update
Если вы не хотите обновлять, к кому применяется политика, не используйте этот параметр.
Значения, указанные для этого параметра или параметра GroupIds, заменяют существующих пользователей. Чтобы сохранить существующих пользователей, включите их вместе с новыми пользователями или группами, которые вы укажете.
Можно указать не более 20 пользователей или групп (20 пользователей и ни одной группы, 10 пользователей и 10 групп и т. д.).
Чтобы обновленная политика применялась ко всем пользователям в организации, используйте параметр Everyone со значением $true.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Online
Переключатель WhatIf показывает, что команда делает без каких-либо изменений. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | 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.