Set-LabelPolicy
Этот командлет работает только в PowerShell для обеспечения соответствия требованиям безопасности & . Дополнительные сведения см. в разделе Соответствие требованиям безопасности & PowerShell.
Используйте командлет Set-Label для изменения политик меток конфиденциальности в организации.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Set-LabelPolicy
[-Identity] <PolicyIdParameter>
-RetryDistribution
[-AddLabels <MultiValuedProperty>]
[-AdvancedSettings <PswsHashtable>]
[-Confirm]
[-MigrationId <String>]
[-NextLabelPolicy <PolicyIdParameter>]
[-PreviousLabelPolicy <PolicyIdParameter>]
[-RemoveLabels <MultiValuedProperty>]
[<CommonParameters>] Set-LabelPolicy
[-Identity] <PolicyIdParameter>
[-AddExchangeLocation <MultiValuedProperty>]
[-AddExchangeLocationException <MultiValuedProperty>]
[-AddLabels <MultiValuedProperty>]
[-AddModernGroupLocation <MultiValuedProperty>]
[-AddModernGroupLocationException <MultiValuedProperty>]
[-AddOneDriveLocation <MultiValuedProperty>]
[-AddOneDriveLocationException <MultiValuedProperty>]
[-AddPublicFolderLocation <MultiValuedProperty>]
[-AddSharePointLocation <MultiValuedProperty>]
[-AddSharePointLocationException <MultiValuedProperty>]
[-AddSkypeLocation <MultiValuedProperty>]
[-AddSkypeLocationException <MultiValuedProperty>]
[-AdvancedSettings <PswsHashtable>]
[-Comment <String>]
[-Confirm]
[-MigrationId <String>]
[-NextLabelPolicy <PolicyIdParameter>]
[-PolicyRBACScopes <MultiValuedProperty>]
[-RemoveExchangeLocation <MultiValuedProperty>]
[-RemoveExchangeLocationException <MultiValuedProperty>]
[-RemoveLabels <MultiValuedProperty>]
[-RemoveModernGroupLocation <MultiValuedProperty>]
[-RemoveModernGroupLocationException <MultiValuedProperty>]
[-RemoveOneDriveLocation <MultiValuedProperty>]
[-RemoveOneDriveLocationException <MultiValuedProperty>]
[-RemovePublicFolderLocation <MultiValuedProperty>]
[-RemoveSharePointLocation <MultiValuedProperty>]
[-RemoveSharePointLocationException <MultiValuedProperty>]
[-RemoveSkypeLocation <MultiValuedProperty>]
[-RemoveSkypeLocationException <MultiValuedProperty>]
[<CommonParameters>] Set-LabelPolicy
[-Identity] <PolicyIdParameter>
[-AddLabels <MultiValuedProperty>]
[-AdvancedSettings <PswsHashtable>]
[-Comment <String>]
[-Confirm]
[-Force]
[-MigrationId <String>]
[-NextLabelPolicy <PolicyIdParameter>]
[-PreviousLabelPolicy <PolicyIdParameter>]
[-RemoveLabels <MultiValuedProperty>]
[-Setting <PswsHashtable>]
[-Settings <PswsHashtable>]
[-WhatIf]
[<CommonParameters>] Описание
Чтобы использовать этот командлет в PowerShell для соответствия требованиям безопасности & , необходимо назначить разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.
Примечание. Не используйте команду Foreach-Object по каналу при добавлении или удалении расположений области: "Value1","Value2",..."ValueN" | Foreach-Object {Set-LabelPolicy -Identity "Global Policy" -RemoveExchangeLocation $_ }.
Примеры
Пример 1
Set-LabelPolicy -Identity "Global Policy" -AdvancedSettings @{EnableCustomPermissions="False"}В этом примере настраивается указанный дополнительный параметр для имени политики меток конфиденциальности Global Policy.
Параметры
-AddExchangeLocation
Параметр AddExchangeLocation указывает почтовые ящики, добавляемые в список включенных почтовых ящиков, если для параметра ExchangeLocation не используется значение All. Допустимым значением является почтовый ящик.
Чтобы указать почтовый ящик, можно использовать любое значение, которое однозначно его идентифицирует. Например:
- имя;
- Имя
- Различающееся имя (DN)
- GUID
Update Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddExchangeLocationException
Параметр AddExchangeLocationException указывает почтовые ящики, добавляемые в список исключенных почтовых ящиков при использовании значения All для параметра ExchangeLocation. Допустимым значением является почтовый ящик.
Чтобы указать почтовый ящик, можно использовать любое значение, которое однозначно его идентифицирует. Например:
- имя;
- Имя
- Различающееся имя (DN)
- GUID
Update Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddLabels
Параметр AddLabels указывает метки конфиденциальности, которые нужно добавить в политику. Вы можете использовать любое значение, однозначно определяющее метку. Например,
- имя;
- различающееся имя (DN);
- GUID
Update Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddModernGroupLocation
Параметр AddModernGroupLocation указывает Группы Microsoft 365 для добавления в список включенных Группы Microsoft 365. Чтобы определить группу Microsoft 365, необходимо использовать основной SMTP-адрес.
Update Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddModernGroupLocationException
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddOneDriveLocation
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddOneDriveLocationException
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddPublicFolderLocation
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddSharePointLocation
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddSharePointLocationException
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddSkypeLocation
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddSkypeLocationException
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AdvancedSettings
Параметр AdvancedSettings включает функции и возможности для конкретного клиента для политики меток конфиденциальности.
Укажите этот параметр с помощью удостоверения (имя или GUID) политики с парами "ключ-значение" в хэш-таблице. Чтобы удалить дополнительный параметр, используйте тот же синтаксис параметра AdvancedSettings, но укажите строковое значение NULL.
Большинство параметров, настроенных с помощью этого параметра, поддерживаются только клиентом унифицированных меток Azure Information Protection, а не приложениями Office, поддерживающими встроенные метки. Инструкции см. в статье Пользовательские конфигурации для клиента унифицированных меток Azure Information Protection.
Поддерживаемые параметры для встроенных меток:
AttachmentAction: сообщения электронной почты без метки наследуют метку с наивысшим приоритетом от вложений файлов. Задайте значение Автоматически (для автоматического применения метки) или Рекомендуется (в качестве рекомендуемого запроса пользователю). Пример:
Set-LabelPolicy -Identity Global -AdvancedSettings @{AttachmentAction="Automatic"}. Дополнительные сведения об этом выборе конфигурации см. в разделе Настройка наследования меток из вложений электронной почты.EnableAudit: запретить приложениям Office отправлять данные меток конфиденциальности в решения аудита Microsoft 365. Поддерживаемые приложения: Word, Excel и PowerPoint в Windows (версия 2201+), macOS (версия 16.57+), iOS (версия 2.57+) и Android (версия 16.0.14827+); Outlook в Windows (версия 2201+), Outlook в Интернете и развертывание в macOS, iOS и Android. Пример:
Set-LabelPolicy -Identity Global -AdvancedSettings @{EnableAudit="False"}.DisableMandatoryInOutlook: приложения Outlook, поддерживающие этот параметр, освобождают сообщения Outlook от обязательной маркировки. Пример:
Set-LabelPolicy -Identity Global -AdvancedSettings @{DisableMandatoryInOutlook="True"}. Дополнительные сведения об этом выборе конфигурации см. в разделе Параметры, относящиеся к Outlook, для метки по умолчанию и обязательной маркировки.OutlookDefaultLabel: приложения Outlook, поддерживающие этот параметр, применяют метку по умолчанию или не применяют метку по умолчанию. Пример:
Set-LabelPolicy -Identity Global -AdvancedSettings @{OutlookDefaultLabel="None"}. Дополнительные сведения об этом выборе конфигурации см. в разделе Параметры, относящиеся к Outlook, для метки по умолчанию и обязательной маркировки.TeamworkMandatory. Приложения Outlook и Teams, поддерживающие этот параметр, могут включать или отключать обязательные метки для собраний. Пример:
Set-LabelPolicy -Identity Global -AdvancedSettings @{TeamworkMandatory="True"}. Дополнительные сведения о маркировке собраний см. в статье Использование меток конфиденциальности для защиты элементов календаря, собраний Teams и чата.teamworkdefaultlabelid. Приложения Outlook и Teams, поддерживающие этот параметр, применяют метку по умолчанию или не используют метку для собраний. Пример:
Set-LabelPolicy -Identity Global -AdvancedSettings @{teamworkdefaultlabelid="General"}. Дополнительные сведения о маркировке собраний см. в статье Использование меток конфиденциальности для защиты элементов календаря, собраний Teams и чата.HideBarByDefault. Для приложений Office, поддерживающих панель конфиденциальности, не отображайте имя метки конфиденциальности в заголовке окна, чтобы было больше места для отображения длинных имен файлов. Будут отображаться только значок метки и цвет (при настройке). Пользователи не могут отменить этот параметр в приложении. Пример:
Set-LabelPolicy -Identity Global -AdvancedSettings @{HideBarByDefault="True"}
Кроме того, для Power BI:
powerbimandatory: обязательная маркировка для Power BI. Пример:
Set-LabelPolicy -Identity Global -AdvancedSettings @{powerbimandatory="true"}. Дополнительные сведения об этом выборе конфигурации см. в статье Обязательная политика меток для Power BI.powerbidefaultlabelid: метка по умолчанию для содержимого Power BI. Пример:
Set-LabelPolicy -Identity Global -AdvancedSettings @{powerbidefaultlabelid="General"}. Дополнительные сведения об этом выборе конфигурации см. в статье Политика меток по умолчанию для Power BI.
| Type: | PswsHashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Comment
Параметр Comment указывает необязательный комментарий. Если вы указываете значение, содержащее пробелы, заключите его в кавычки ("), например:" Это примечание администратора ".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-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: | Security & Compliance |
-Force
Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.
Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Identity
Параметр Identity указывает политику, которую требуется просмотреть. Вы можете использовать любое уникальное значение, определяющее политику. Например:
- имя;
- различающееся имя (DN);
- GUID
| Type: | PolicyIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-MigrationId
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-NextLabelPolicy
Параметр NextLabelPolicy обновляет порядок политики, чтобы политика, указанная этим параметром, была после текущей политики, которую вы изменяете. Вы можете использовать любое уникальное значение, определяющее политику. Например:
- имя;
- различающееся имя (DN);
- GUID
| Type: | PolicyIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-PolicyRBACScopes
{{ Заполнение PolicyRBACScopes Description }}
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-PreviousLabelPolicy
Параметр PreviousLabelPolicy обновляет порядок политики, чтобы политика, указанная этим параметром, была раньше текущей политики, которую вы изменяете. Вы можете использовать любое уникальное значение, определяющее политику. Например:
- имя;
- различающееся имя (DN);
- GUID
| Type: | PolicyIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveExchangeLocation
Параметр RemoveExchangeLocation указывает почтовые ящики, которые нужно удалить из списка включенных почтовых ящиков, если для параметра ExchangeLocation не используется значение All. Допустимые значения:
- Параметр ExchangeLocation указывает почтовые ящики, включаемые в политику. Допускаются следующие значения:
- Почтовый ящик
Значение All для всех почтовых ящиков. Это значение можно использовать только само по себе.
- имя;
- Имя
- Различающееся имя (DN)
- GUID
Update Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveExchangeLocationException
Параметр RemoveExchangeLocationException указывает почтовые ящики, которые необходимо удалить из списка исключенных почтовых ящиков при использовании значения Все для параметра ExchangeLocation. Допустимые значения:
- Параметр ExchangeLocation указывает почтовые ящики, включаемые в политику. Допускаются следующие значения:
- Почтовый ящик
Значение All для всех почтовых ящиков. Это значение можно использовать только само по себе.
- имя;
- Имя
- Различающееся имя (DN)
- GUID
Update Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveLabels
Параметр RemoveLabels указывает метки конфиденциальности, которые необходимо удалить из политики. Вы можете использовать любое значение, однозначно определяющее метку. Например,
- имя;
- различающееся имя (DN);
- GUID
Update Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveModernGroupLocation
Параметр RemoveModernGroupLocation указывает Группы Microsoft 365, удаляемый из списка включенных групп. Чтобы определить группу Microsoft 365, необходимо использовать основной SMTP-адрес.
Update Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveModernGroupLocationException
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveOneDriveLocation
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveOneDriveLocationException
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemovePublicFolderLocation
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveSharePointLocation
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveSharePointLocationException
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveSkypeLocation
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveSkypeLocationException
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RetryDistribution
Параметр RetryDistribution указывает, следует ли распространять политику во все Exchange Online расположения. Указывать значение для этого параметра необязательно.
Расположения, для которых первоначальная рассылка прошла успешно, исключаются при повторении. При использовании этого параметра сообщается об ошибках рассылки политики.
Примечание. Так как процесс повторного распределения является важной операцией, запускайте ее только при необходимости и для одной политики за раз. Он не предназначен для запуска при каждом обновлении политики. При запуске скрипта для обновления нескольких политик дождитесь успешного распространения политики, прежде чем снова запустить команду для следующей политики.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Setting
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | PswsHashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Settings
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | PswsHashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-WhatIf
Параметр WhatIf не работает в PowerShell для соответствия требованиям безопасности & .
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |