Set-AutoSensitivityLabelPolicy

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

Используйте командлет Set-AutoSensitivityLabelPolicy для изменения политик автоматической маркировки в организации.

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

Синтаксис

Set-AutoSensitivityLabelPolicy
   [-Identity] <PolicyIdParameter>
   [-AddExchangeLocation <MultiValuedProperty>]
   [-AddOneDriveLocation <MultiValuedProperty>]
   [-AddOneDriveLocationException <MultiValuedProperty>]
   [-AddSharePointLocation <MultiValuedProperty>]
   [-AddSharePointLocationException <MultiValuedProperty>]
   [-ApplySensitivityLabel <String>]
   [-AutoEnableAfter <Timespan>]
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExchangeSender <SmtpAddress[]>]
   [-ExchangeSenderException <SmtpAddress[]>]
   [-ExchangeSenderMemberOf <SmtpAddress[]>]
   [-ExchangeSenderMemberOfException <SmtpAddress[]>]
   [-ExternalMailRightsManagementOwner <SmtpAddress>]
   [-Force]
   [-Mode <PolicyMode>]
   [-OverwriteLabel <Boolean>]
   [-PolicyRBACScopes <MultiValuedProperty>]
   [-PolicyTemplateInfo <PswsHashtable>]
   [-Priority <System.Int32>]
   [-RemoveExchangeLocation <MultiValuedProperty>]
   [-RemoveOneDriveLocation <MultiValuedProperty>]
   [-RemoveOneDriveLocationException <MultiValuedProperty>]
   [-RemoveSharePointLocation <MultiValuedProperty>]
   [-RemoveSharePointLocationException <MultiValuedProperty>]
   [-SpoAipIntegrationEnabled <Boolean>]
   [-StartSimulation <Boolean>]
   [-SystemOperation]
   [-WhatIf]
   [<CommonParameters>]
Set-AutoSensitivityLabelPolicy
   [-Identity] <PolicyIdParameter>
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-Force]
   [-Mode <PolicyMode>]
   [-WhatIf]
   [<CommonParameters>]
Set-AutoSensitivityLabelPolicy
   [-Identity] <PolicyIdParameter>
   [-Confirm]
   [-Mode <PolicyMode>]
   [-RetryDistribution]
   [-WhatIf]
   [<CommonParameters>]

Описание

Чтобы использовать этот командлет в PowerShell для соответствия требованиям безопасности & , необходимо назначить разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.

Примеры

Пример 1

Set-AutoSensitivityLabelPolicy -Identity "Main PII" -AddSharePointLocation "https://my.url1","https://my.url2" -AddOneDriveLocation "https://my.url3","https://my.url4"

В этом примере указанные URL-адреса добавляются в SharePoint Online и OneDrive для бизнеса расположения для политики автоматической маркировки с именем Main PII, не затрагивая существующие значения URL-адресов.

Параметры

-AddExchangeLocation

Параметр AddExchangeLocation добавляет сообщения электронной почты в политику, если они еще не включены. Допустимое значение для этого параметра — All.

Если политика еще не включает сообщения электронной почты (в выходных данных командлета Get-AutoSensitivityLabelPolicy значение свойства ExchangeLocation пусто), этот параметр можно использовать в следующих процедурах:

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

  • Чтобы включить электронную почту определенных внутренних или внешних пользователей в политику, используйте -AddExchangeLocation All с параметром ExchangeSender в той же команде. В политику включен только адрес электронной почты указанных пользователей.

  • Чтобы включить электронную почту определенных участников группы в политику, используйте -AddExchangeLocation All с параметром ExchangeSenderMemberOf в той же команде. В политику включается только электронная почта членов указанных групп.

  • Чтобы исключить электронную почту определенных внутренних пользователей из политики, используйте -AddExchangeLocation All с параметром ExchangeSenderException в той же команде. Из политики исключается только электронная почта указанных пользователей.

  • Чтобы исключить электронную почту определенных участников группы из политики, используйте -AddExchangeLocation All параметр ExchangeSenderMemberOfException в той же команде. Из политики исключаются только сообщения электронной почты членов указанных групп.

Вы не можете указать включения и исключения в одной политике.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddOneDriveLocation

Параметр AddOneDriveLocation указывает OneDrive для бизнеса сайтов, добавляемых в список включенных сайтов, если для параметра OneDriveLocation не используется значение All. Чтобы добавить сайт, укажите его URL-адрес.

Чтобы ввести несколько значений, используйте следующий синтаксис: <value1>,<value2>,...<valueX>. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddOneDriveLocationException

Параметр AddOneDriveLocationException указывает OneDrive для бизнеса сайтов, добавляемых в список исключенных сайтов при использовании значения Все для параметра OneDriveLocation. Чтобы добавить сайт, укажите его URL-адрес.

Чтобы ввести несколько значений, используйте следующий синтаксис: <value1>,<value2>,...<valueX>. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddSharePointLocation

Параметр AddSharePointLocation указывает сайты SharePoint Online, добавляемые в список включенных сайтов, если для параметра SharePointLocation не используется значение All. Чтобы добавить сайт, укажите его URL-адрес.

Сайты SharePoint Online нельзя добавить в политику, пока они не будут проиндексированы.

Чтобы ввести несколько значений, используйте следующий синтаксис: <value1>,<value2>,...<valueX>. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddSharePointLocationException

Параметр AddSharePointLocationException указывает сайты SharePoint Online, добавляемые в список исключенных сайтов при использовании значения All для параметра SharePointLocation. Чтобы добавить сайт, укажите его URL-адрес.

Чтобы ввести несколько значений, используйте следующий синтаксис: <value1>,<value2>,...<valueX>. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplySensitivityLabel

Параметр ApplySensitivityLabel выбирает метку, используемую для политики. Это переопределит предыдущую метку в политике.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AutoEnableAfter

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

Чтобы указать значение, введите его как период времени: dd.hh:mm:ss (dd — дни, hh — часы, mm — минуты и ss — секунды).

Допустимое значение составляет от 1 часа до 25 дней.

Этот параметр необходимо использовать с параметром -StartSimulation.

Type:System.TimeSpan
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

-Enabled

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

  • $true. Политика включена. Это значение используется по умолчанию.
  • $true. Политика включена. Это значение задается по умолчанию.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExchangeSender

Параметр ExchangeSender указывает пользователей, адрес электронной почты которых включен в политику. Вы указываете пользователей по адресу электронной почты. Можно указать внутренние или внешние адреса электронной почты.

Чтобы ввести несколько значений, используйте следующий синтаксис: <value1>,<value2>,...<valueX>. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "<value1>","<value2>",..."<valueX>".

Чтобы использовать этот параметр, один из следующих операторов должен иметь значение true:

  • Политика уже включает сообщения электронной почты (в выходных данных командлета Get-AutoSensitivityLabelPolicy значение свойства ExchangeLocation равно All).
  • Используйте -AddExchangeLocation All в той же команде с этим параметром.

Этот параметр нельзя использовать с параметрами ExchangeSenderException или ExchangeSenderMemberOfException.

Type:SmtpAddress[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExchangeSenderException

Параметр ExchangeSenderException указывает внутренних пользователей, адрес электронной почты которых исключен из политики. Вы идентифицируете пользователей по адресу электронной почты.

Чтобы ввести несколько значений, используйте следующий синтаксис: <value1>,<value2>,...<valueX>. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "<value1>","<value2>",..."<valueX>".

Чтобы использовать этот параметр, один из следующих операторов должен иметь значение true:

  • Политика уже включает сообщения электронной почты (в выходных данных Get-AutoSensitivityLabelPolicy значение свойства ExchangeLocation — All).
  • Используйте -AddExchangeLocation All в той же команде с этим параметром.

Этот параметр нельзя использовать с параметрами ExchangeSender или ExchangeSenderMemberOf.

Type:SmtpAddress[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExchangeSenderMemberOf

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

Чтобы ввести несколько значений, используйте следующий синтаксис: <value1>,<value2>,...<valueX>. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "<value1>","<value2>",..."<valueX>".

Чтобы использовать этот параметр, один из следующих операторов должен иметь значение true:

  • Политика уже включает сообщения электронной почты (в выходных данных Get-AutoSensitivityLabelPolicy значение свойства ExchangeLocation — All).
  • Используйте -AddExchangeLocation All в той же команде с этим параметром.

Этот параметр нельзя использовать с параметрами ExchangeSenderException или ExchangeSenderMemberOfException.

Этот параметр нельзя использовать для указания Группы Microsoft 365.

Type:SmtpAddress[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExchangeSenderMemberOfException

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

Чтобы ввести несколько значений, используйте следующий синтаксис: <value1>,<value2>,...<valueX>. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "<value1>","<value2>",..."<valueX>".

Чтобы использовать этот параметр, один из следующих операторов должен иметь значение true:

  • Политика уже включает сообщения электронной почты (в выходных данных Get-AutoSensitivityLabelPolicy значение свойства ExchangeLocation — All).
  • Используйте -AddExchangeLocation All в той же команде с этим параметром.

Этот параметр нельзя использовать с параметрами ExchangeSender или ExchangeSenderMemberOf.

Этот параметр нельзя использовать для указания Группы Microsoft 365.

Type:SmtpAddress[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExternalMailRightsManagementOwner

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

Этот параметр работает только в расположениях Exchange, и политика должна применять метку с действием шифрования.

Чтобы очистить существующий адрес электронной почты, используйте значение $null.

Type:SmtpAddress
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:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Security & Compliance

-Mode

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

  • Включить: политика включена для действий и уведомлений.
  • Enable. Политика включена для действий и уведомлений. Это значение используется по умолчанию.
  • TestWithNotifications: не поддерживается.
  • TestWithoutNotifications: режим аудита, в котором никакие действия не выполняются и уведомления не отправляются (тестовый режим).
Type:PolicyMode
Accepted values:Enable, TestWithNotifications, TestWithoutNotifications, Disable, PendingDeletion
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-OverwriteLabel

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

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

Этот параметр работает только в расположениях Exchange.

Type:Boolean
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

-PolicyTemplateInfo

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Type:PswsHashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Priority

Параметр Priority задает значение приоритета для политики, определяющее порядок обработки политики. Меньшее целочисленное значение указывает на более высокий приоритет, значение 0 — это наивысший приоритет, а политики не могут иметь одинаковое значение приоритета.

Допустимые значения и значение по умолчанию для этого параметра зависят от количества существующих политик. Например, если существует 5 существующих политик:

  • Допустимые значения приоритета для существующих 5 политик находятся в диапазоне от 0 до 4.
  • Допустимые значения приоритета для новой 6-й политики — от 0 до 5.
  • Значение по умолчанию для новой 6-й политики — 5.

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

Type:System.Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveExchangeLocation

Параметр RemoveExchangeLocation удаляет сообщения электронной почты из политики, если они уже включены. Допустимое значение для этого параметра — All.

Если политика уже включает сообщения электронной почты (в выходных данных командлета Get-AutoSensitivityLabelPolicy значение свойства ExchangeLocation равно All), можно использовать, -RemoveExchangeLocation All чтобы запретить применение политики к сообщениям электронной почты.

Этот параметр нельзя использовать, если электронная почта (значение Exchange) используется каким-либо из связанных правил.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveOneDriveLocation

Параметр RemoveOneDriveLocation указывает OneDrive для бизнеса сайтов, удаляемых из списка включенных сайтов, если для параметра OneDriveLocation не используется значение All. Чтобы добавить сайт, укажите его URL-адрес.

Чтобы ввести несколько значений, используйте следующий синтаксис: <value1>,<value2>,...<valueX>. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveOneDriveLocationException

Этот параметр RemoveOneDriveLocationException указывает OneDrive для бизнеса сайтов, которые необходимо удалить из списка исключенных сайтов при использовании значения Все для параметра OneDriveLocation. Чтобы добавить сайт, укажите его URL-адрес.

Чтобы ввести несколько значений, используйте следующий синтаксис: <value1>,<value2>,...<valueX>. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveSharePointLocation

Параметр RemoveSharePointLocation указывает сайты SharePoint Online, которые нужно удалить из списка включенных сайтов, если для параметра SharePointLocation не используется значение All. Чтобы добавить сайт, укажите его URL-адрес.

Чтобы ввести несколько значений, используйте следующий синтаксис: <value1>,<value2>,...<valueX>. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveSharePointLocationException

Параметр RemoveSharePointLocationException указывает сайты SharePoint Online, которые нужно удалить из списка исключенных сайтов при использовании значения Все для параметра SharePointLocation. Чтобы добавить сайт, укажите его URL-адрес.

Чтобы ввести несколько значений, используйте следующий синтаксис: <value1>,<value2>,...<valueX>. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RetryDistribution

Параметр RetryDistribution перераспределяет политику для всех расположений OneDrive для бизнеса и SharePoint Online. Указывать значение для этого параметра необязательно.

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

Примечание. Так как процесс повторного распределения является важной операцией, запускайте ее только при необходимости и для одной политики за раз. Он не предназначен для запуска при каждом обновлении политики. При запуске скрипта для обновления нескольких политик дождитесь успешного распространения политики, прежде чем снова запустить команду для следующей политики.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SpoAipIntegrationEnabled

{{ Fill SpoAipIntegrationEnabled Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-StartSimulation

Используйте параметр StartSimulation, чтобы перезапустить имитацию для обновленных результатов. Допустимые значения:

  • $true. Перезапустите симуляцию для обновленных результатов.
  • $false: это значение по умолчанию
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SystemOperation

{{ Fill SystemOperation Description }}

Type:SwitchParameter
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