New-RetentionComplianceRule

Модуль:

ExchangePowerShell

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

Security & Compliance

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

Используйте командлет New-RetentionComplianceRule для создания новых правил хранения в Портал соответствия требованиям Microsoft Purview.

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

Синтаксис

New-RetentionComplianceRule
   -ApplyComplianceTag <String>
   -Policy <PolicyIdParameter>
   [-ContentContainsSensitiveInformation <PswsHashtable[]>]
   [-Confirm]
   [-ContentMatchQuery <String>]
   [-ExpirationDateOption <String>]
   [-MachineLearningModelIDs <MultiValuedProperty>]
   [-RetentionComplianceAction <String>]
   [-WhatIf]
   [<CommonParameters>]

New-RetentionComplianceRule
   [-Name] <String>
   -Policy <PolicyIdParameter>
   [-Comment <String>]
   [-ExcludedItemClasses <MultiValuedProperty>]
   [-RetentionDuration <Unlimited>]
   [-RetentionDurationDisplayHint <HoldDurationHint>]
   [-Confirm]
   [-ContentMatchQuery <String>]
   [-ExpirationDateOption <String>]
   [-RetentionComplianceAction <String>]
   [-WhatIf]
   [<CommonParameters>]

New-RetentionComplianceRule
   -Policy <PolicyIdParameter>
   -PublishComplianceTag <String>
   [-Confirm]
   [-ExpirationDateOption <String>]
   [-RetentionComplianceAction <String>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Правило хранения необходимо добавить в существующую политику хранения с помощью параметра Policy. В каждую политику хранения можно добавить только одно правило.

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

Примеры

Пример 1

New-RetentionComplianceRule -Name InternalCompanyRule -Policy "Internal Company Policy" -RetentionDuration Unlimited

В этом примере создается новое правило удержания дела с именем InternalCompanyRule и добавляется в существующую политику удержания дела с именем "Внутренняя политика компании". Содержимое будет храниться неограниченное время.

Пример 2

New-RetentionComplianceRule -Name SeptOneYear -Policy "Internal Company Policy" -RetentionDuration 365 -RetentionComplianceAction KeepAndDelete -ExpirationDateOption ModificationAgeInDays

В этом примере создается новое правило хранения с именем SeptOneYear и добавляется в существующую политику хранения с именем "Внутренняя политика компании". Содержимое будет храниться в течение одного года с момента последнего изменения содержимого перед удалением.

Параметры

-ApplyComplianceTag

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

Для просмотра и создания меток используются командлеты Get-ComplianceTag и New-ComplianceTag.

Этот параметр невозможно использовать вместе с параметром Name или PublishComplianceTag.

Этот параметр нельзя использовать для правил хранения Teams.

Type:	String
Position:	Named
Default value:	None
Required:	True
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

-ContentContainsSensitiveInformation

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

Этот параметр использует базовый синтаксис @(@{Name="SensitiveInformationType1";[minCount="Value"],@{Name="SensitiveInformationType2";[minCount="Value"],...). Например, @(@{Name="U.S. Social Security Number (SSN)"; minCount="2"},@{Name="Credit Card Number"}).

Используйте командлет Get-DLPSensitiveInformationType, чтобы получить список типов конфиденциальной информации для вашей организации. Дополнительные сведения о типах конфиденциальной информации см. в статье Поиск типов конфиденциальной информации в Exchange.

Вы можете использовать этот параметр вместе с параметром ApplyComplianceTag.

Этот параметр нельзя использовать для правил хранения Teams.

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

-ContentMatchQuery

Параметр ContentMatchQuery указывает фильтр поиска контента.

Этот параметр использует строку текстового поиска или запрос, созданный с использованием языка запросов по ключевым словам (KQL). Дополнительные сведения см. в статье Справочник по синтаксису языка запросов ключевых слов (KQL) и Запросы ключевых слов и условия поиска для обнаружения электронных данных.

Этот параметр нельзя использовать для правил хранения Teams.

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

-ExcludedItemClasses

Параметр ExcludeedItemClasses указывает типы сообщений, которые следует исключить из правила. Этот параметр можно использовать только для исключения элементов из политики удержания, которая исключает из хранения указанный класс элементов. Использование этого параметра не будет исключать элементы из политик удаления. Как правило, этот параметр используется для исключения сообщений голосовой почты, бесед обмена мгновенными сообщениями и другого содержимого Skype для бизнеса Online из хранения политикой удержания. Ниже перечислены распространенные Skype для бизнеса значения:

• IPM. Примечание. Майкрософт. Разговор
• IPM. Примечание. Майкрософт. Conversation.Voice
• IPM. Примечание. Майкрософт. Пропустил
• IPM. Примечание. Майкрософт. Missed.Voice
• IPM. Примечание. Майкрософт. Голосовую почту
• IPM. Примечание. Майкрософт.VoiceMessage.UA
• IPM. Примечание. Майкрософт. Voicemail.UM
• IPM. Примечание. Майкрософт.Voicemail.UM.CA

Кроме того, можно указать классы сообщений для элементов Exchange и пользовательские или сторонние классы сообщений. Обратите внимание, что указанные значения не проверяются, поэтому параметр принимает любое текстовое значение.

Можно указать несколько значений класса элементов с помощью следующего синтаксиса: "Value1","Value2",..."ValueN".

Этот параметр нельзя использовать для правил хранения Teams.

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

-ExpirationDateOption

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

• CreationAgeInDays
• ModificationAgeInDays

Этот параметр нельзя использовать для правил хранения Teams.

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

-MachineLearningModelIDs

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

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

-Name

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

Этот параметр невозможно использовать вместе с параметром ApplyComplianceTag или PublishComplianceTag.

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

-Policy

Параметр Policy определяет политику, которая должна содержать правило.

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

-PublishComplianceTag

Параметр PublishComplianceTag указывает метку, опубликованную для правила, которая делает метку видимой для пользователей в приложениях (например, Outlook, SharePoint и OneDrive). Допустимое значение этого параметра — имя существующей метки. Если значение содержит пробелы, его необходимо заключить в кавычки.

Для просмотра и создания меток используются командлеты Get-ComplianceTag и New-ComplianceTag.

Этот параметр нельзя использовать в следующих сценариях:

• С параметрами Name или ApplyComplianceTag.
• Для правил хранения Teams.
• С политиками облачных вложений.

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

-RetentionComplianceAction

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

• Удалить
• Оставить
• KeepAndDelete

Если этот параметр не используется, политика хранения создается как политика UniH вместо политики mbx.

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

-RetentionDuration

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

• Целое число: длительность удержания в днях.
• Неограниченно: содержимое хранится неограниченное время.

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

-RetentionDurationDisplayHint

Параметр RetentionDurationDisplayHint указывает единицы измерения, используемые для отображения длительности хранения в Портал соответствия требованиям Microsoft Purview. Допустимые значения:

• Дни
• Месяцы
• Годы

Например, если для этого параметра задано значение Years, а параметру RetentionDuration присвоено значение 365, Портал соответствия требованиям Microsoft Purview будет отображаться в качестве длительности хранения содержимого в течение 1 года.

Этот параметр нельзя использовать для правил хранения Teams.

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