Update-VivaModuleFeaturePolicy
Этот командлет доступен только в модуле PowerShell Exchange Online версии 3.2.0 или более поздней версии. Дополнительные сведения см. в разделе Сведения о модуле PowerShell Exchange Online.
Примечание. Этот командлет является частью функции, которая в настоящее время находится в закрытой закрытой предварительной версии. Командлет не будет работать, если ваша организация не является участником закрытой предварительной версии.
Используйте командлет Update-VivaModuleFeaturePolicy для обновления политики доступа для компонента в модуле Viva. Наиболее строгая политика для конкретного пользователя или группы имеет приоритет при определении того, включена ли функция.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Update-VivaModuleFeaturePolicy
-FeatureId <String>
-ModuleId <String>
-PolicyId <String>
[-Confirm]
[-IsFeatureEnabled <Boolean>]
[-GroupIds <String[]>]
[-Everyone <Boolean>]
[-Name <String>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>] Описание
Используйте командлет Update-VivaModuleFeaturePolicy для обновления политики доступа для компонента в модуле Viva.
Этот командлет обновляет атрибуты указанной политики. К этим атрибутам относятся:
- Имя политики (параметр Name).
- Указывает, включает ли политика эту функцию (параметр IsFeatureEnabled).
- К кому применяется политика (параметры UserIds и GroupIds или параметр Все).
Эти атрибуты можно обновлять независимо друг от друга. Например, если указать параметр Name, но не параметр IsFeatureEnabled, имя политики будет обновлено, но независимо от того, включает ли политика эту функцию, остается без изменений.
Важно! Значения, указанные для параметров UserIds и (или) GroupIds или параметра Все , перезаписывают все существующие пользователи или группы. Чтобы сохранить существующих пользователей и группы, необходимо указать этих существующих пользователей или группы , а также всех дополнительных пользователей или групп, которые вы хотите добавить. Если не включить в команду существующих пользователей или групп, эти пользователи или группы будут удалены из политики. Дополнительные сведения см. в примерах.
Для проверки подлинности необходимо использовать командлет Connect-ExchangeOnline.
Для этого командлета требуется платформа .NET Framework 4.7.2 или более поздней версии.
В настоящее время для выполнения этого командлета необходимо быть членом роли глобальных администраторов.
Дополнительные сведения о разрешениях роли администратора в Azure Active Directory см. в статье Идентификаторы шаблонов ролей.
Примеры
Пример 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 -UserIds user1@contoso.comВ этом примере обновляется имя указанной политики, делается так, чтобы она включила функцию, а также обновляется, к кому применяется политика. Теперь политика применяется только к указанным пользователям и группам, перезаписав пользователей и групп, к которым применялась политика.
Параметры
-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
Параметр Все указывает, что обновленная политика применяется ко всем пользователям в организации. Допустимые значения:
- $true: политика применяется ко всем пользователям. Это единственное полезное значение для этого параметра.
- $false: не используйте это значение.
Если вы не хотите обновлять пользователей, к которым применяется политика, не используйте этот параметр.
Не используйте этот параметр с параметрами GroupIds или UserIds.
| Type: | Boolean |
| 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 указывает адреса электронной почты групп, к которым применяется обновленная политика. Поддерживаются группы AAD с поддержкой почты. Update
Если вы не хотите обновлять пользователей, к которым применяется политика, не используйте этот параметр.
Значения, указанные для этого параметра или параметра UserIds, заменяют все существующие группы. Чтобы сохранить существующие группы, включите их вместе с новыми пользователями или группами, которые вы указали.
Можно указать не более 20 пользователей или групп (20 пользователей и без групп, 10 пользователей и 10 групп и т. д.).
Чтобы применить обновленную политику ко всем пользователям в организации, используйте параметр Все со значением $true.
| 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: | False |
| 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: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PolicyId
Параметр PolicyId указывает политику для компонента в модуле Viva, который требуется обновить.
Чтобы просмотреть сведения о политиках для компонента в модуле Viva, используйте командлет Get-VivaModuleFeaturePolicy. Значение PolicyId возвращается в выходных данных командлета.
| 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
Если вы не хотите обновлять пользователей, к которым применяется политика, не используйте этот параметр.
Значения, указанные для этого параметра или параметра GroupIds, заменяют всех существующих пользователей. Чтобы сохранить существующих пользователей, включите их вместе с новыми пользователями или группами, которые вы указали.
Можно указать не более 20 пользователей или групп (20 пользователей и без групп, 10 пользователей и 10 групп и т. д.).
Чтобы применить обновленную политику ко всем пользователям в организации, используйте параметр Все со значением $true.
| 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 |
Связанные ссылки
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по