Partager via


New-ComplianceRetentionEvent

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 la cmdlet New-ComplianceRetentionEvent pour créer des événements de rétention pour motifs de conformité dans votre organisation.

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 (Par défaut)

New-ComplianceRetentionEvent
    -Name <String>
    [-AssetId <String>]
    [-Comment <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-EventDateTime <DateTime>]
    [-EventTags <MultiValuedProperty>]
    [-EventType <ComplianceRuleIdParameter>]
    [-ExchangeAssetIdQuery <String>]
    [-PreviewOnly]
    [-SharePointAssetIdQuery <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-ComplianceRetentionEvent -Name "Research Project Employees" -EventTag 80e0d620-13ea-4ed9-b6a6-aa883278bcca -EventType e823b782-9a07-4e30-8091-034fc01f9347 -SharePointAssetIDQuery "EmployeeNumber:123456 EmployeeNumber:456789"

Cet exemple crée un événement de rétention de conformité nommé Research Project Employees avec les paramètres suivants :

  • EventTag : 80e0d620-13ea-4ed9-b6a6-aa883278bcca
  • EventTpe : e823b782-9a07-4e30-8091-034fc01f9347
  • SharePointAssetIDQuery : EmployeeNumber :123456 EmployeeNumber :456789

Paramètres

-AssetId

Applicable : Sécurité & Conformité

Le paramètre AssetId spécifie la paire Property :Value qui se trouve dans les propriétés des documents SharePoint ou OneDrive utilisés pour la conservation. Par exemple :

  • Des codes de produit que vous pouvez utiliser pour conserver le contenu relatif à un produit spécifique.
  • Des codes de projet que vous pouvez utiliser pour conserver le contenu relatif à un projet spécifique.
  • ID d’employé à utiliser pour conserver uniquement le contenu d’une personne spécifique.

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

-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

(All)
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’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.

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

-DomainController

Applicable : Sécurité & Conformité

Ce paramètre est réservé à l’usage interne chez Microsoft.

Propriétés du paramètre

Type:Fqdn
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

-EventDateTime

Applicable : Sécurité & Conformité

Le paramètre EventDateTime spécifie la date-heure de l’événement.

Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte MM/jj/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".

Propriétés du paramètre

Type:DateTime
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

-EventTags

Applicable : Sécurité & Conformité

Le paramètre EventTags spécifie la valeur GUID des étiquettes associées à l’événement de rétention de conformité. Exécutez la commande suivante pour afficher les valeurs GUID disponibles : Get-ComplianceTag | Format-Table Name,GUID.

Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

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

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

-EventType

Applicable : Sécurité & Conformité

Le paramètre EventType spécifie la valeur GUID de l’événement qui démarre la période de rétention pour les étiquettes qui utilisent ce type d’événement. Exécutez la commande suivante pour afficher les valeurs GUID disponibles : Get-ComplianceRetentionEventType | Format-Table Name,GUID.

Propriétés du paramètre

Type:ComplianceRuleIdParameter
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

-ExchangeAssetIdQuery

Applicable : Sécurité & Conformité

Le paramètre ExchangeAssetIdQuery spécifie les mots clés utilisés pour définir l’étendue du contenu Exchange pour l’événement de rétention de conformité. Pour plus d’informations, consultez Requêtes par mot clé et conditions de recherche pour la recherche de contenu.

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

-Name

Applicable : Sécurité & Conformité

Le paramètre Name spécifie un nom unique pour l’événement de rétention. 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

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

-PreviewOnly

Applicable : Sécurité & Conformité

{{ Fill PreviewOnly Description }}

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

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

-SharePointAssetIdQuery

Applicable : Sécurité & Conformité

Le paramètre SharePointAssetIdQuery spécifie une ou plusieurs paires Property :Value que vous avez spécifiées dans les propriétés (également appelées Colonnes) des documents SharePoint et OneDrive pour étendre l’événement de rétention de conformité.

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

-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 courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.