New-ComplianceTag
Cette cmdlet est disponible uniquement dans le Centre de conformité et sécurité PowerShell. Si vous souhaitez en savoir plus, veuillez consulter l’article Centre de conformité et sécurité PowerShell.
Utilisez l’applet de commande New-ComplianceTag pour créer des étiquettes de rétention dans le portail de conformité Microsoft Purview. Les étiquettes de rétention appliquent des paramètres de rétention au contenu.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
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>]
New-ComplianceTag
[-Name] <String>
-RetentionAction <String>
-RetentionDuration <Unlimited>
-RetentionType <String>
-MultiStageReviewProperty <String>
[-PriorityCleanup]
[-Comment <String>]
[-Confirm]
[-Force]
[-Notes <String>]
[-WhatIf]
[<CommonParameters>]
Description
Pour pouvoir utiliser cette cmdlet dans le Centre de sécurité et de conformité PowerShell, des autorisations doivent vous être attribuées. Pour plus d’informations, consultez la rubrique Autorisations dans le portail de conformité Microsoft Purview.
Exemples
Exemple 1
New-ComplianceTag -Name "HR Content" -RetentionAction Keep -RetentionDuration 1825 -RetentionType ModificationAgeInDays
Cet exemple crée une étiquette nommée HR Content avec les paramètres suivants :
- Action : Conserver.
- Durée : 5 ans (1825 jours)
- Type : Modification de l’âge en jours.
Paramètres
-AutoApprovalPeriod
{{ Fill AutoApprovalPeriod Description }}
Type: | System.Int32 |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |
-Comment
Le paramètre Comment permet d’insérer un commentaire facultatif. Si la valeur que vous saisissez contient des espaces, placez-la entre guillemets ("). Par exemple : "Ceci est une note d’administration".
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |
-ComplianceTagForNextStage
{{ Fill ComplianceTagForNextStage Description }}
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |
-Confirm
Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.
- Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte :
-Confirm:$false
. - La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n'ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
Type: | SwitchParameter |
Alias: | cf |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |
-EventType
EventType spécifie la règle de rétention associée à l’étiquette. Vous pouvez utiliser une valeur quelconque qui identifie distinctement la règle. Par exemple :
- Nom
- Nom unique (DN)
- GUID
Vous pouvez utiliser l'applet de commande Get-RetentionComplianceRule pour afficher les règles de rétention disponibles.
Type: | ComplianceRuleIdParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |
-FilePlanProperty
Le paramètre FilePlanProperty spécifie les propriétés de plan de fichiers à inclure dans l’étiquette. Pour afficher les noms de propriétés de plan de fichiers que vous devez utiliser dans ce paramètre, exécutez les commandes suivantes :
Get-FilePlanPropertyAuthority | Format-List Name
Get-FilePlanPropertyCategory | Format-List Name
Get-FilePlanPropertyCitation | Format-List Name
Get-FilePlanPropertyDepartment | Format-List Name
Get-FilePlanPropertyReferenceId | Format-List Name
Get-FilePlanPropertySubCategory | Format-List Name
Une valeur valide pour ce paramètre implique deux étapes :
Variable pour stocker les propriétés du plan de fichiers en tant que PSCustomObject à l’aide de la syntaxe suivante :
$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"})}
Par exemple :
$retentionLabelAction=[PSCustomObject]@{Settings=@(@{Key="FilePlanPropertyDepartment";Value="Legal"},@{Key="FilePlanPropertyCategory";Value="Tax"},@{Key="FilePlanPropertySubcategory";Value="US_Tax"},@{Key="FilePlanPropertyCitation";Value="LegalCitation"},@{Key="FilePlanPropertyReferenceId";Value="Referen
ceA"},@{Key="FilePlanPropertyAuthority » ; Value="Auth1"})}Deuxième variable pour convertir l’objet PSCustomObject en objet JSON à l’aide de la syntaxe suivante :
$Variable2 = ConvertTo-Json $Variable1
Par exemple :
$fpStr = ConvertTo-Json $retentionLabelAction
Vous utilisez la deuxième variable comme valeur pour ce paramètre.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |
-FlowId
Remarque : Ce paramètre est actuellement en préversion, n’est pas disponible dans toutes les organisations et est susceptible d’être modifié.
Le paramètre FlowId spécifie le flux Power Automate à exécuter à la fin de la période de rétention. Une valeur valide pour ce paramètre est la valeur GUID du flux.
Vous pouvez trouver la valeur GUID du flux à l’aide de l’une des méthodes suivantes :
- Accédez au flux à partir du portail Power Automate. La valeur GUID du flux se trouve dans l’URL.
- Utilisez l’action Power Automate nommée « Répertorier les flux en tant qu’administrateur ».
Type: | System.Guid |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |
-Force
Le commutateur Force masque les messages d’avertissement ou de confirmation. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Vous pouvez utiliser ce commutateur pour exécuter des tâches par programme, lorsqu’une intervention administrative est inappropriée.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |
-IsRecordLabel
Le paramètre IsRecordLabel spécifie si l’étiquette est une étiquette d’enregistrement. Les valeurs valides sont les suivantes :
- $true : l’étiquette est une étiquette d’enregistrement. Une fois que l’intitulé est appliqué au contenu, il ne peut pas être supprimé.
- $false : l’étiquette n’est pas une étiquette d’enregistrement. Il s’agit de la valeur par défaut.
Type: | Boolean |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |
-IsRecordUnlockedAsDefault
{{ Fill IsRecordUnlockedAsDefault Description }}
Type: | Boolean |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |
-MultiStageReviewProperty
Le paramètre MultiStageReviewProperty spécifie les propriétés de révision à plusieurs étapes à inclure dans l’étiquette. Ce paramètre utilise la syntaxe suivante :
'{"MultiStageReviewSettings":[{"StageName":"Stage1","Reviewers":[reviewer1,reviewer2,...reviewerN]},{"StageName":"Stage2","Reviewers":[reviewer1,reviewer2,...reviewerN]},]}'
Par exemple :
'{"MultiStageReviewSettings":[{"StageName":"Stage1","Reviewers":[jie@contoso.onmicrosoft.com]},{"StageName":"Stage2","Reviewers":[bharath@contoso.onmicrosoft.com,helen@contoso.onmicrosoft.com]},]}'
Cette syntaxe est un objet JSON qui définit chaque ID de phase de révision, le nom de la phase de révision et la liste des réviseurs.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |
-Name
Le paramètre Name permet de définir un nom unique pour l’étiquette. Si la valeur contient des espaces, placez-la entre guillemets (").
Type: | String |
Position: | 1 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |
-Notes
Le paramètre Notes spécifie des informations supplémentaires sur l’objet . Si la valeur contient des espaces, placez-la entre guillemets (").
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |
-PriorityCleanup
{{ Fill PriorityCleanup Description }}
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |
-Regulatory
{{ Remplissage description réglementaire }}
Type: | Boolean |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |
-RetentionAction
Le paramètre RetentionAction permet de définir l’action de l’étiquette. Les valeurs valides sont les suivantes :
- Supprimer
- Conserver
- KeepAndDelete
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |
-RetentionDuration
Le paramètre RetentionDuration spécifie la durée de rétention du contenu en nombre de jours. Les valeurs valides sont les suivantes :
- Nombre entier positif.
- Valeur unlimited.
Type: | Unlimited |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |
-RetentionType
Le paramètre RetentionType spécifie si la durée de rétention est calculée à partir de la date de création du contenu, de la date marquée ou de la date de la dernière modification. Les valeurs valides sont les suivantes :
- CreationAgeInDays
- EventAgeInDays
- ModificationAgeInDays
- TaggedAgeInDays
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |
-ReviewerEmail
Le paramètre ReviewerEmail spécifie l’adresse électronique d’un réviseur pour les actions de rétention Delete et KeepAndDelete. Vous pouvez spécifier plusieurs adresses e-mail séparées par des virgules.
Type: | SmtpAddress[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |
-WhatIf
Le commutateur WhatIf ne fonctionne pas dans le Centre de sécurité et de conformité PowerShell.
Type: | SwitchParameter |
Alias: | wi |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
S’applique à: | Security & Compliance |