New-ComplianceTag
Этот командлет доступен только в PowerShell безопасности и соответствия требованиям. Дополнительные сведения см. в статье PowerShell безопасности и соответствия требованиям.
Используйте командлет New-ComplianceTag для создания меток хранения в Портал соответствия требованиям Microsoft Purview. Метки хранения применяют параметры хранения к содержимому.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default
New-ComplianceTag
[-Name] <String>
[-AutoApprovalPeriod <System.Int32>]
[-Comment <String>]
[-ComplianceTagForNextStage <String>]
[-Confirm]
[-EventType <ComplianceRuleIdParameter>]
[-FilePlanProperty <String>]
[-FlowId <System.Guid>]
[-Force]
[-IsRecordLabel <Boolean>]
[-IsRecordUnlockedAsDefault <Boolean>]
[-MultiStageReviewProperty <String>]
[-Notes <String>]
[-Regulatory <Boolean>]
[-RetentionAction <String>]
[-RetentionDuration <Unlimited>]
[-RetentionType <String>]
[-ReviewerEmail <SmtpAddress[]>]
[-WhatIf]
[<CommonParameters>]
PriorityCleanup
New-ComplianceTag
[-Name] <String>
-RetentionAction <String>
-RetentionDuration <Unlimited>
-RetentionType <String>
-MultiStageReviewProperty <String>
[-PriorityCleanup]
[-Comment <String>]
[-Confirm]
[-Force]
[-Notes <String>]
[-WhatIf]
[<CommonParameters>]
Описание
Чтобы использовать этот командлет в PowerShell безопасности и соответствия требованиям, вам должны быть назначены соответствующие разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.
Примеры
Пример 1
New-ComplianceTag -Name "HR Content" -RetentionAction Keep -RetentionDuration 1825 -RetentionType ModificationAgeInDays
Этот пример кода создает метку HR Content со следующими параметрами:
- Действие: Оставить.
- Продолжительность: 5 лет (1825 дней)
- Тип: Возраст модификации в днях.
Параметры
-AutoApprovalPeriod
Применимо: безопасность & соответствие требованиям
{{ Заполнение периода автоутверждения }}
Свойства параметров
| Тип: | System.Int32 |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Comment
Применимо: безопасность & соответствие требованиям
Параметр Comment указывает необязательный комментарий. Если вы указываете значение, содержащее пробелы, заключите его в кавычки ("), например:" Это примечание администратора ".
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ComplianceTagForNextStage
Применимо: безопасность & соответствие требованиям
{{ Fill ComplianceTagForNextStage Description }}
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| 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 |
-EventType
Применимо: безопасность & соответствие требованиям
EventType указывает правило хранения, связанное с меткой. Можно использовать любое значение, уникальным образом идентифицирующее правило. Пример:
- имя;
- различающееся имя (DN);
- GUID
Чтобы просмотреть доступные правила хранения, можно использовать командлет Get-RetentionComplianceRule.
Свойства параметров
| Тип: | ComplianceRuleIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-FilePlanProperty
Применимо: безопасность & соответствие требованиям
Параметр FilePlanProperty определяет свойства плана файлов, которые следует включить в метку. Чтобы просмотреть имена свойств плана файла, которые необходимо использовать в этом параметре, выполните следующие команды:
Get-FilePlanPropertyAuthority | Format-List NameGet-FilePlanPropertyCategory | Format-List NameGet-FilePlanPropertyCitation | Format-List NameGet-FilePlanPropertyDepartment | Format-List NameGet-FilePlanPropertyReferenceId | Format-List NameGet-FilePlanPropertySubCategory | Format-List Name
Допустимое значение этого параметра включает два этапа:
Переменная для хранения свойств плана файла в виде объекта PSCustomObject со следующим синтаксисом:
$Variable1=[PSCustomObject]@{Settings=@(@{Key="FilePlanPropertyDepartment";Value="Name"},@{Key="FilePlanPropertyCategory";Value="Name"},@{Key="FilePlanPropertySubcategory";Value="Name"},@{Key="FilePlanPropertyCitation";Value="Name"},@{Key="FilePlanPropertyReferenceId";Value="Name"},@{Key="FilePlanPropertyAuthority";Value="Name"})}Например, вы можете:
$retentionLabelAction=[PSCustomObject]@{Settings=@(@{Key="FilePlanPropertyDepartment";Value="Legal"},@{Key="FilePlanPropertyCategory";Value="Tax"},@{Key="FilePlanPropertySubcategory";Value="US_Tax"},@{Key="FilePlanPropertyCitation";Value="LegalCitation"},@{Key="FilePlanPropertyReferenceId";Value="ReferenceA"},@{Key="FilePlanPropertyAuthority"; Value="Auth1"})}Вторая переменная для преобразования объекта PSCustomObject в объект JSON с использованием следующего синтаксиса:
$Variable2 = ConvertTo-Json $Variable1Например, вы можете:
$fpStr = ConvertTo-Json $retentionLabelAction
В качестве значения этого параметра используется вторая переменная.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-FlowId
Применимо: безопасность & соответствие требованиям
Примечание. Этот параметр в настоящее время находится в предварительной версии, доступен не во всех организациях и может быть изменен.
Параметр FlowId указывает, какой поток Power Automate запускается в конце периода хранения. Допустимым значением для этого параметра является значение GUID потока.
Значение GUID потока можно найти с помощью любого из следующих методов:
- Перейдите к потоку с портала Power Automate. Значение GUID потока находится в URL-адресе.
- Используйте действие Power Automate с именем "Перечисление потоков от имени администратора".
Свойства параметров
| Тип: | System.Guid |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Применимо: безопасность & соответствие требованиям
Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.
Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IsRecordLabel
Применимо: безопасность & соответствие требованиям
Параметр IsRecordLabel указывает, является ли метка записью. Допустимые значения:
- $true: Лейбл есть звукозаписывающий лейбл. После применения к содержимому метку невозможно удалить.
- $false: Лейбл не является звукозаписывающим лейблом. Это значение используется по умолчанию.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IsRecordUnlockedAsDefault
Применимо: безопасность & соответствие требованиям
{{ Fill IsRecordUnlockedAsDefault Description }}
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MultiStageReviewProperty
Применимо: безопасность & соответствие требованиям
Параметр MultiStageReviewProperty определяет свойства многоступенчатой проверки, которые следует включить в метку. Для этого параметра используется указанный ниже синтаксис.
'{"MultiStageReviewSettings":[{"StageName":"Stage1","Reviewers":[reviewer1,reviewer2,...reviewerN]},{"StageName":"Stage2","Reviewers":[reviewer1,reviewer2,...reviewerN]},]}'
Например, вы можете:
'{"MultiStageReviewSettings":[{"StageName":"Stage1","Reviewers":[jie@contoso.onmicrosoft.com]},{"StageName":"Stage2","Reviewers":[bharath@contoso.onmicrosoft.com,helen@contoso.onmicrosoft.com]},]}'
Этот синтаксис является объектом JSON, который определяет идентификатор каждой стадии проверки, имя стадии проверки и список рецензентов.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Применимо: безопасность & соответствие требованиям
Параметр Name указывает уникальное имя метки. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Notes
Применимо: безопасность & соответствие требованиям
Параметр Notes указывает дополнительные сведения об объекте. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PriorityCleanup
Применимо: безопасность & соответствие требованиям
{{ Fill PriorityCleanup Description }}
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
PriorityCleanup
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Regulatory
Применимо: безопасность & соответствие требованиям
{{ Заполнение нормативного описания }}
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RetentionAction
Применимо: безопасность & соответствие требованиям
Параметр RetentionAction указывает действие для метки. Допустимые значения:
- Удалить
- Оставить
- KeepAndDelete
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Default
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
PriorityCleanup
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RetentionDuration
Применимо: безопасность & соответствие требованиям
Параметр RetentionDuration указывает срок хранения содержимого (в днях). Допустимые значения:
- положительное целое число;
- значение unlimited.
Свойства параметров
| Тип: | Unlimited |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Default
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
PriorityCleanup
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RetentionType
Применимо: безопасность & соответствие требованиям
Параметр RetentionType указывает, рассчитывается ли продолжительность хранения на основе даты создания содержимого, даты тега или даты последнего изменения. Допустимые значения:
- CreationAgeInDays
- EventAgeInDays
- ModificationAgeInDays
- TaggedAgeInDays
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Default
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
PriorityCleanup
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ReviewerEmail
Применимо: безопасность & соответствие требованиям
Параметр ReviewerEmail задает адрес электронной почты проверяющего для действий хранения Delete и KeepAndDelete. Можно указать несколько адресов электронной почты, разделив их запятыми.
Свойства параметров
| Тип: | SmtpAddress[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| 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.