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 и добавляется в существующую политику удержания с именем "Внутренняя политика компании". Содержимое хранится неограниченное время.
Пример 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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ComplianceTag
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Comment
Применимо: соответствие требованиям & безопасности
Параметр Comment указывает необязательный комментарий. Если вы указываете значение, содержащее пробелы, заключите его в кавычки ("), например:" Это примечание администратора ".
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Default
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: соответствие требованиям & безопасности
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли для этого командлета подтверждение перед продолжением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Подтвердить без значения приводит к приостановке, которая заставляет подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | 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[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ComplianceTag
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ContentMatchQuery
Применимо: соответствие требованиям & безопасности
Параметр ContentMatchQuery указывает фильтр поиска контента.
Этот параметр использует строку текстового поиска или запрос, созданный с использованием языка запросов по ключевым словам (KQL). Дополнительные сведения см. в разделах Справочник по синтаксису язык KeyQL (KQL) и Запросы ключевых слов и условия поиска для обнаружения электронных данных.
Этот параметр нельзя использовать для правил хранения Teams.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ComplianceTag
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
Default
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Default
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExpirationDateOption
Применимо: соответствие требованиям & безопасности
Параметр ExpirationDateOption указывает, вычисляется ли дата окончания срока действия с даты создания контента или даты последнего изменения. Допустимые значения:
- CreationAgeInDays
- ModificationAgeInDays
Этот параметр нельзя использовать для правил хранения Teams.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IRMRiskyUserProfiles
Применимо: соответствие требованиям & безопасности
{{ Fill IRMRiskyUserProfiles Description }}
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ComplianceTag
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MachineLearningModelIDs
Применимо: соответствие требованиям & безопасности
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ComplianceTag
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Применимо: соответствие требованиям & безопасности
Параметр Name указывает уникальное имя правила хранения. Если значение содержит пробелы, его необходимо заключить в кавычки.
Этот параметр невозможно использовать вместе с параметром ApplyComplianceTag или PublishComplianceTag.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Default
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Policy
Применимо: соответствие требованиям & безопасности
Параметр Policy определяет политику, которая должна содержать правило.
Свойства параметров
| Тип: | PolicyIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PriorityCleanup
Применимо: соответствие требованиям & безопасности
Параметр PriorityCleanup указывает, следует ли создавать правило, связанное с политикой очистки приоритета. С этим параметром не нужно указывать значение.
Политики очистки приоритета ускоряют удаление конфиденциального содержимого, переопределяя все существующие параметры хранения или удержания обнаружения электронных данных. Дополнительные сведения см. в разделе Очистка приоритета.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PublishComplianceTag
Применимо: соответствие требованиям & безопасности
Параметр PublishComplianceTag указывает метку, опубликованную для правила, которая делает метку видимой для пользователей в приложениях (например, Outlook, SharePoint и OneDrive). Допустимое значение этого параметра — имя существующей метки. Если значение содержит пробелы, его необходимо заключить в кавычки.
Для просмотра и создания меток используются командлеты Get-ComplianceTag и New-ComplianceTag.
Этот параметр нельзя использовать в следующих сценариях:
- С параметрами Name или ApplyComplianceTag.
- Для правил хранения Teams.
- С политиками облачных вложений.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
PublishComplianceTag
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RetentionComplianceAction
Применимо: соответствие требованиям & безопасности
Параметр RetentionComplianceAction указывает действие хранения для правила. Допустимые значения:
- Удалить
- Оставить
- KeepAndDelete
Если этот параметр не используется, политика хранения создается как политика UniH вместо политики mbx. Этот параметр является обязательным для предотвращения удаления, не соответствующего требованиям.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RetentionDuration
Применимо: соответствие требованиям & безопасности
Параметр RetentionDuration указывает срок хранения для правила хранения. Допустимые значения:
- Целое число: длительность удержания в днях.
- Неограниченно: содержимое хранится неограниченное время.
Свойства параметров
| Тип: | Unlimited |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Default
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RetentionDurationDisplayHint
Применимо: соответствие требованиям & безопасности
Параметр RetentionDurationDisplayHint указывает единицы измерения, используемые для отображения длительности хранения в Портал соответствия требованиям Microsoft Purview. Допустимые значения:
- Дни
- Месяцы
- Годы
Например, если для этого параметра задано значение Года, а параметру RetentionDuration присвоено значение 365, Портал соответствия требованиям Microsoft Purview будет отображаться 1 год в качестве длительности хранения содержимого.
Этот параметр нельзя использовать для правил хранения Teams.
Свойства параметров
| Тип: | HoldDurationHint |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Default
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: соответствие требованиям & безопасности
Параметр WhatIf не поддерживается в PowerShell безопасности и соответствия требованиям.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | 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.