New-AppRetentionComplianceRule

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 le New-AppRetentionComplianceRule pour créer des règles de conformité de conservation des applications.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntaxe

Default

New-AppRetentionComplianceRule
    [-Name] <String>
    -Policy <PolicyIdParameter>
    [-Comment <String>]
    [-Confirm]
    [-ContentMatchQuery <String>]
    [-ExcludedItemClasses <MultiValuedProperty>]
    [-ExpirationDateOption <String>]
    [-RetentionComplianceAction <String>]
    [-RetentionDuration <Unlimited>]
    [-RetentionDurationDisplayHint <HoldDurationHint>]
    [-WhatIf]
    [<CommonParameters>]

ComplianceTag

New-AppRetentionComplianceRule
    -Policy <PolicyIdParameter>
    [-Confirm]
    [-ContentContainsSensitiveInformation <PswsHashtable[]>]
    [-ContentMatchQuery <String>]
    [-ExpirationDateOption <String>]
    [-MachineLearningModelIDs <MultiValuedProperty>]
    [-RetentionComplianceAction <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-AppRetentionComplianceRule -Name RetUnlimited -Policy "Regulation 567 Compliance" -RetentionDuration Unlimited

Cet exemple crée une règle de rétention nommée RetUnlimited et l’ajoute à la stratégie de rétention nommée Conformité au Règlement 567.

Paramètres

-Comment

Applicable : sécurité & conformité

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".

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Default
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Applicable : sécurité & conformité

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’impact de ce commutateur sur l’applet de commande varie selon que l’applet de commande nécessite une confirmation avant de continuer.

  • 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 applets de commande, la spécification du commutateur Confirmer sans valeur introduit une pause qui vous oblige à accuser réception de la commande avant de continuer.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ContentContainsSensitiveInformation

Applicable : sécurité & conformité

Le paramètre ContentContainsSensitiveInformation spécifie une condition pour la règle basée sur une correspondance de type d'informations sensibles dans le contenu. La règle est appliquée au contenu contenant le type d’informations sensibles spécifié.

Ce paramètre utilise la syntaxe de base @(@{Name="SensitiveInformationType1";[minCount="Value"],@{Name="SensitiveInformationType2";[minCount="Value"],...). Par exemple : @(@{Name="U.S. Social Security Number (SSN)"; minCount="2"},@{Name="Credit Card Number"}).

Utilisez la cmdlet Get-DLPSensitiveInformationType pour répertorier les types d’informations sensibles pour votre organisation. Pour plus d’informations sur les types d’informations sensibles, consultez Ce que recherchent les types d’informations sensibles dans Exchange.

Propriétés du paramètre

Type:

PswsHashtable[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ComplianceTag
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ContentMatchQuery

Applicable : sécurité & conformité

Le paramètre ContentMatchQuery spécifie un filtre de recherche de contenu.

Ce paramètre utilise une chaîne de recherche de texte ou une requête formatée en utilisant la syntaxe KQL (Keyword Query Language). Pour plus d’informations, voir Référence de syntaxe du langage de requête par mots-clés (KQL) et Requêtes par mot clé et conditions de recherche pour eDiscovery.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Default
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
ComplianceTag
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ExcludedItemClasses

Applicable : sécurité & conformité

Le paramètre ExcludedItemClasses spécifie les types de messages à exclure de la règle. Vous pouvez utiliser ce paramètre uniquement pour exclure des éléments d’une stratégie de conservation, ce qui exclut la classe d’éléments spécifiée de la conservation. L’utilisation de ce paramètre n’exclut pas des éléments des stratégies de suppression. En règle générale, vous utilisez ce paramètre pour exclure les messages vocaux, les conversations de messagerie instantanée et d’autres contenus de Skype Entreprise Online d’être détenus par une stratégie de conservation. Les valeurs courantes de Skype Entreprise sont les suivantes :

  • IPM. Note.Microsoft.Conversation
  • IPM. Note.Microsoft.Conversation.Voice
  • IPM. Note.Microsoft.Missed
  • IPM. Note.Microsoft.Missed .Voice
  • IPM. Microsoft.Messagerie vocale
  • IPM.Note.Microsoft.VoiceMessage.UA
  • IPM. Note.Microsoft.Voicemail.UM
  • IPM.Note.Microsoft.Voicemail.UM.CA

En outre, vous pouvez spécifier des classes de messages pour les éléments Exchange et les classes de messages personnalisées ou non-Microsoft. Les valeurs que vous spécifiez ne sont pas validées, de sorte que le paramètre accepte toute valeur de texte.

Vous pouvez spécifier plusieurs valeurs de classe d’article à l’aide de la syntaxe suivante : "Value1","Value2",..."ValueN".

Propriétés du paramètre

Type:MultiValuedProperty
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Default
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ExpirationDateOption

Applicable : sécurité & conformité

Le paramètre ExpirationDateOption spécifie si la date d’expiration est calculée à partir de la date de création du contenu ou de la date de la dernière modification. Les valeurs valides sont les suivantes :

  • CreationAgeInDays
  • ModificationAgeInDays

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MachineLearningModelIDs

Applicable : sécurité & conformité

{{ Remplir MachineLearningModelIDs Description }}

Propriétés du paramètre

Type:MultiValuedProperty
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ComplianceTag
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

Applicable : sécurité & conformité

Le paramètre Name spécifie un nom unique pour la règle de conformité de rétention d’application. La longueur maximale est de 64 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Default
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Policy

Applicable : sécurité & conformité

Le paramètre de stratégie spécifie la stratégie de conformité de la rétention des applications qui contient la règle de conformité de la rétention des applications. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la stratégie. Par exemple :

  • Nom
  • Nom unique (DN)
  • GUID

Propriétés du paramètre

Type:PolicyIdParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RetentionComplianceAction

Applicable : sécurité & conformité

Le paramètre RetentionComplianceAction spécifie l’action de rétention pour la règle. Les valeurs valides sont les suivantes :

  • Supprimer
  • Conserver
  • KeepAndDelete

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RetentionDuration

Applicable : sécurité & conformité

Le paramètre RetentionDuration permet de définir la durée de conservation pour la règle de rétention. Les valeurs valides sont les suivantes :

  • Un nombre entier : durée de conservation en jours.
  • Illimité : le contenu est conservé indéfiniment.

Propriétés du paramètre

Type:Unlimited
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Default
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RetentionDurationDisplayHint

Applicable : sécurité & conformité

Le paramètre RetentionDurationDisplayHint spécifie les unités utilisées pour afficher la durée de rétention dans le portail de conformité Microsoft Purview. Les valeurs valides sont Days, Months ou Years.

  • Jours
  • Mois
  • Années

Par exemple, si ce paramètre est défini sur la valeur Années et que le paramètre RetentionDuration est défini sur la valeur 365, le portail de conformité Microsoft Purview affiche 1 an comme durée de conservation du contenu.

Propriétés du paramètre

Type:HoldDurationHint
Valeur par défaut:None
Valeurs acceptées:Days, Months, Years
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Default
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Applicable : sécurité & conformité

Le commutateur WhatIf ne fonctionne pas dans le Centre de sécurité et de conformité PowerShell.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.