New-RetentionComplianceRule
Этот командлет доступен только в PowerShell безопасности и соответствия требованиям. Дополнительные сведения см. в статье PowerShell безопасности и соответствия требованиям.
Используйте командлет New-RetentionComplianceRule для создания новых правил хранения в Портал соответствия требованиям Microsoft Purview.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
New-RetentionComplianceRule
-ApplyComplianceTag <String>
-Policy <PolicyIdParameter>
[-ContentContainsSensitiveInformation <PswsHashtable[]>]
[-Confirm]
[-ContentMatchQuery <String>]
[-ExpirationDateOption <String>]
[-IRMRiskyUserProfiles <String>]
[-MachineLearningModelIDs <MultiValuedProperty>]
[-PriorityCleanup]
[-RetentionComplianceAction <String>]
[-WhatIf]
[<CommonParameters>] New-RetentionComplianceRule
[-Name] <String>
-Policy <PolicyIdParameter>
[-Comment <String>]
[-ExcludedItemClasses <MultiValuedProperty>]
[-RetentionDuration <Unlimited>]
[-RetentionDurationDisplayHint <HoldDurationHint>]
[-Confirm]
[-ContentMatchQuery <String>]
[-ExpirationDateOption <String>]
[-PriorityCleanup]
[-RetentionComplianceAction <String>]
[-WhatIf]
[<CommonParameters>] New-RetentionComplianceRule
-Policy <PolicyIdParameter>
-PublishComplianceTag <String>
[-Confirm]
[-ExpirationDateOption <String>]
[-PriorityCleanup]
[-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.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-Comment
Параметр Comment указывает необязательный комментарий. Если вы указываете значение, содержащее пробелы, заключите его в кавычки ("), например:" Это примечание администратора ".
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-Confirm
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | 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.
| Тип: | PswsHashtable[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-ContentMatchQuery
Параметр ContentMatchQuery указывает фильтр поиска контента.
Этот параметр использует строку текстового поиска или запрос, созданный с использованием языка запросов по ключевым словам (KQL). Дополнительные сведения см. в статье Справочник по синтаксису языка запросов ключевых слов (KQL) и Запросы ключевых слов и условия поиска для обнаружения электронных данных.
Этот параметр нельзя использовать для правил хранения Teams.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-ExcludedItemClasses
Параметр ExcludeedItemClasses указывает типы сообщений, которые следует исключить из правила. Этот параметр можно использовать только для исключения элементов из политики удержания, которая исключает из хранения указанный класс элементов. Использование этого параметра не будет исключать элементы из политик удаления. Как правило, этот параметр используется для исключения сообщений голосовой почты, бесед обмена мгновенными сообщениями и другого содержимого Skype для бизнеса Online из хранения политикой удержания. Ниже перечислены распространенные Skype для бизнеса значения:
- IPM. Примечание.Microsoft.Conversation
- IPM. Note.Microsoft.Conversation.Voice
- IPM. Примечание.Microsoft.Missed
- IPM. Note.Microsoft.Missed.Voice
- IPM. Примечание.Microsoft.Voicemail
- IPM.Note.Microsoft.VoiceMessage.UA
- IPM. Примечание.Microsoft.Voicemail.UM
- IPM.Note.Microsoft.Voicemail.UM.CA
Кроме того, можно указать классы сообщений для элементов Exchange и пользовательские или сторонние классы сообщений. Обратите внимание, что указанные значения не проверяются, поэтому параметр принимает любое текстовое значение.
Можно указать несколько значений класса элементов с помощью следующего синтаксиса: "Value1","Value2",..."ValueN".
Этот параметр нельзя использовать для правил хранения Teams.
| Тип: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-ExpirationDateOption
Параметр ExpirationDateOption указывает, вычисляется ли дата окончания срока действия с даты создания контента или даты последнего изменения. Допустимые значения:
- CreationAgeInDays
- ModificationAgeInDays
Этот параметр нельзя использовать для правил хранения Teams.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-IRMRiskyUserProfiles
{{ Fill IRMRiskyUserProfiles Description }}
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-MachineLearningModelIDs
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Тип: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-Name
Параметр Name указывает уникальное имя правила хранения. Если значение содержит пробелы, его необходимо заключить в кавычки.
Этот параметр невозможно использовать вместе с параметром ApplyComplianceTag или PublishComplianceTag.
| Тип: | String |
| Position: | 1 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-Policy
Параметр Policy определяет политику, которая должна содержать правило.
| Тип: | PolicyIdParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-PriorityCleanup
{{ Fill PriorityCleanup Description }}
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-PublishComplianceTag
Параметр PublishComplianceTag указывает метку, опубликованную для правила, которая делает метку видимой для пользователей в приложениях (например, Outlook, SharePoint и OneDrive). Допустимое значение этого параметра — имя существующей метки. Если значение содержит пробелы, его необходимо заключить в кавычки.
Для просмотра и создания меток используются командлеты Get-ComplianceTag и New-ComplianceTag.
Этот параметр нельзя использовать в следующих сценариях:
- С параметрами Name или ApplyComplianceTag.
- Для правил хранения Teams.
- С политиками облачных вложений.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-RetentionComplianceAction
Параметр RetentionComplianceAction указывает действие хранения для правила. Допустимые значения:
- Удалить
- Оставить
- KeepAndDelete
Если этот параметр не используется, политика хранения создается как политика UniH вместо политики mbx.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-RetentionDuration
Параметр RetentionDuration указывает срок хранения для правила хранения. Допустимые значения:
- Целое число: длительность удержания в днях.
- Неограниченно: содержимое хранится неограниченное время.
| Тип: | Unlimited |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-RetentionDurationDisplayHint
Параметр RetentionDurationDisplayHint указывает единицы измерения, используемые для отображения длительности хранения в Портал соответствия требованиям Microsoft Purview. Допустимые значения:
- Дни
- Месяцы
- Годы
Например, если для этого параметра задано значение Года, а параметру RetentionDuration присвоено значение 365, Портал соответствия требованиям Microsoft Purview будет отображаться в качестве длительности хранения содержимого в течение 1 года.
Этот параметр нельзя использовать для правил хранения Teams.
| Тип: | HoldDurationHint |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |
-WhatIf
Параметр WhatIf не поддерживается в PowerShell безопасности и соответствия требованиям.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
| Применяется к: | Security & Compliance |