Set-RetentionComplianceRule
Этот командлет доступен только в PowerShell безопасности и соответствия требованиям. Дополнительные сведения см. в статье PowerShell безопасности и соответствия требованиям.
Используйте командлет Set-RetentionComplianceRule для изменения существующих правил хранения в Портал соответствия требованиям Microsoft Purview.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
Set-RetentionComplianceRule
[-Identity] <ComplianceRuleIdParameter>
[-ApplyComplianceTag <String>]
[-Comment <String>]
[-Confirm]
[-ContentContainsSensitiveInformation <PswsHashtable[]>]
[-ContentDateFrom <DateTime>]
[-ContentDateTo <DateTime>]
[-ContentMatchQuery <String>]
[-ExcludedItemClasses <MultiValuedProperty>]
[-ExpirationDateOption <String>]
[-IRMRiskyUserProfiles <String>]
[-PriorityCleanup]
[-RetentionComplianceAction <String>]
[-RetentionDuration <Unlimited>]
[-RetentionDurationDisplayHint <HoldDurationHint>]
[-WhatIf]
[<CommonParameters>]
Описание
Чтобы использовать этот командлет в PowerShell безопасности и соответствия требованиям, вам должны быть назначены соответствующие разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.
Примеры
Пример 1
Set-RetentionComplianceRule -Identity "Internal Company Rule" -RetentionDuration 180 -RetentionDurationDisplayHint Days
Этот пример кода изменяет срок хранения, указанный в правиле хранения Internal Company Rule.
Параметры
-ApplyComplianceTag
Применимо: соответствие требованиям & безопасности
Параметр ApplyComplianceTag указывает метку, применяемую к электронным сообщениям или документам согласно правилу (которое влияет на срок хранения содержимого). Допустимое значение этого параметра — имя существующей метки. Если значение содержит пробелы, его необходимо заключить в кавычки.
Для просмотра и создания меток используются командлеты Get-ComplianceTag и New-ComplianceTag.
Этот параметр невозможно использовать вместе с параметром Name или PublishComplianceTag.
Этот параметр нельзя использовать для правил хранения Teams.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Comment
Применимо: соответствие требованиям & безопасности
Параметр Comment указывает необязательный комментарий. Если вы указываете значение, содержащее пробелы, заключите его в кавычки ("), например:" Это примечание администратора ".
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: соответствие требованиям & безопасности
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Свойства параметров
| Тип: | 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.
Этот параметр нельзя использовать для правил хранения Teams.
Свойства параметров
| Тип: | PswsHashtable[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ContentDateFrom
Применимо: соответствие требованиям & безопасности
Параметр ContentDateFrom указывает дату начала из диапазона дат для содержимого, которое нужно добавить.
Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если на компьютере настроен короткий формат даты ММ/дд/гггг, введите 01.09.2018, чтобы указать 1 сентября 2018 г. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 09/01/2018 5:00 PM ".
Свойства параметров
| Тип: | DateTime |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ContentDateTo
Применимо: соответствие требованиям & безопасности
Параметр ContentDateTo указывает дату окончания из диапазона дат для содержимого, которое нужно добавить.
Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если на компьютере настроен короткий формат даты ММ/дд/гггг, введите 01.09.2018, чтобы указать 1 сентября 2018 г. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 09/01/2018 5:00 PM ".
Свойства параметров
| Тип: | DateTime |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ContentMatchQuery
Применимо: соответствие требованиям & безопасности
Параметр ContentMatchQuery указывает фильтр поиска контента.
Этот параметр использует строку текстового поиска или запрос, созданный с использованием языка запросов по ключевым словам (KQL). Дополнительные сведения см. в статье Справочник по синтаксису языка запросов ключевых слов (KQL) и Запросы ключевых слов и условия поиска для обнаружения электронных данных.
Этот параметр нельзя использовать для правил хранения Teams.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| 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 |
Наборы параметров
(All)
| 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 |
-Identity
Применимо: соответствие требованиям & безопасности
Параметр Identity указывает правило хранения, которое требуется изменить. Можно использовать любое значение, уникальным образом идентифицирующее правило. Пример:
- имя;
- различающееся имя (DN);
- GUID
Свойства параметров
| Тип: | ComplianceRuleIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-IRMRiskyUserProfiles
Применимо: соответствие требованиям & безопасности
{{ Fill IRMRiskyUserProfiles Description }}
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PriorityCleanup
Применимо: соответствие требованиям & безопасности
Параметр PriorityCleanup указывает, следует ли обновлять правило, связанное с политикой очистки приоритета. С этим параметром не нужно указывать значение.
Политики очистки приоритета ускоряют удаление конфиденциального содержимого, переопределяя все существующие параметры хранения или удержания обнаружения электронных данных. Дополнительные сведения см. в разделе Очистка приоритета.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RetentionComplianceAction
Применимо: соответствие требованиям & безопасности
Параметр RetentionComplianceAction указывает действие хранения для правила. Допустимые значения:
- Удалить
- Оставить
- KeepAndDelete
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RetentionDuration
Применимо: соответствие требованиям & безопасности
Параметр RetentionDuration указывает срок хранения для правила хранения. Допустимые значения:
- Целое число: длительность удержания в днях.
- Неограниченно: содержимое хранится неограниченное время.
Свойства параметров
| Тип: | Unlimited |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RetentionDurationDisplayHint
Применимо: соответствие требованиям & безопасности
Параметр RetentionDurationDisplayHint указывает единицы измерения, используемые для отображения длительности хранения в Портал соответствия требованиям Microsoft Purview. Допустимые значения — Days, Months или Years.
- Дни
- Месяцы
- Годы
Например, если для этого параметра задано значение Года, а параметру RetentionDuration присвоено значение 365, Портал соответствия требованиям Microsoft Purview будет отображаться 1 год в качестве длительности хранения содержимого.
Этот параметр нельзя использовать для правил хранения Teams.
Свойства параметров
| Тип: | HoldDurationHint |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| 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.