Set-LabelPolicy

Модуль:

ExchangePowerShell

Применяется к:

Security & Compliance

Этот командлет работает только в 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