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