New-RetentionCompliancePolicy
Cette applet de commande est disponible uniquement dans & Security Compliance PowerShell. Pour plus d’informations, consultez Conformité de la sécurité & PowerShell.
Utilisez l’applet de commande New-RetentionCompliancePolicy pour créer de nouvelles stratégies de rétention et de nouvelles stratégies d’étiquette de rétention dans le portail de conformité Microsoft Purview. La création d’une stratégie nécessite également l’utilisation de l’applet de commande New-RetentionComplianceRule.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntax
New-RetentionCompliancePolicy
[-Name] <String>
[-Applications <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-ExchangeLocation <MultiValuedProperty>]
[-ExchangeLocationException <MultiValuedProperty>]
[-Force]
[-IsSimulation]
[-ModernGroupLocation <MultiValuedProperty>]
[-ModernGroupLocationException <MultiValuedProperty>]
[-OneDriveLocation <MultiValuedProperty>]
[-OneDriveLocationException <MultiValuedProperty>]
[-PolicyTemplateInfo <PswsHashtable>]
[-PublicFolderLocation <MultiValuedProperty>]
[-RestrictiveRetention <Boolean>]
[-RetainCloudAttachment <Boolean>]
[-SharePointLocation <MultiValuedProperty>]
[-SharePointLocationException <MultiValuedProperty>]
[-SkypeLocation <MultiValuedProperty>]
[-SkypeLocationException <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] New-RetentionCompliancePolicy
[-Name] <String>
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-Force]
[-IsSimulation]
[-RestrictiveRetention <Boolean>]
[-RetainCloudAttachment <Boolean>]
[-TeamsChannelLocation <MultiValuedProperty>]
[-TeamsChannelLocationException <MultiValuedProperty>]
[-TeamsChatLocation <MultiValuedProperty>]
[-TeamsChatLocationException <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] New-RetentionCompliancePolicy
[-Name] <String>
-AdaptiveScopeLocation <MultiValuedProperty>
[-Applications <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-Force]
[-IsSimulation]
[-RestrictiveRetention <Boolean>]
[-RetainCloudAttachment <Boolean>]
[-WhatIf]
[<CommonParameters>] Description
Les stratégies ne sont pas valides tant qu’une règle n’est pas ajoutée (pour les stratégies de rétention) ou qu’une étiquette n’est pas ajoutée (pour les stratégies d’étiquette de rétention). Pour plus d’informations, consultez New-RetentionComplianceRule. En outre, au moins un paramètre d’emplacement doit être défini pour créer une stratégie de rétention ou une stratégie d’étiquette de rétention.
Pour utiliser cette applet de commande dans PowerShell de conformité de la sécurité & , 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-RetentionCompliancePolicy -Name "Regulation 123 Compliance" -ExchangeLocation "Kitty Petersen", "Scott Nakamura" -SharePointLocation "https://contoso.sharepoint.com/sites/teams/finance"Cet exemple crée une stratégie de rétention nommée « Conformité au Règlement 123 » pour les boîtes aux lettres de Kitty Petersen et Scott Nakamura, ainsi que pour le site SharePoint Online finance.
L’étape suivante consiste à utiliser l’applet de commande New-RetentionComplianceRule pour ajouter une règle à la stratégie de rétention.
Exemple 2
New-RetentionCompliancePolicy -Name "Marketing Department" -Enabled $true -SharePointLocation https://contoso.sharepoint.com -RetainCloudAttachment $true -Comment "Regulatory compliance for Marketing Dept."Cet exemple crée une stratégie d’étiquette d’application automatique ciblant les pièces jointes cloud nommée Service marketing avec les détails spécifiés.
L’étape suivante consiste à utiliser l’applet de commande New-RetentionComplianceRule pour ajouter une étiquette de rétention à la stratégie d’étiquette de rétention.
Paramètres
-AdaptiveScopeLocation
Le paramètre AdaptiveScopeLocation spécifie l’emplacement de l’étendue adaptative à inclure dans la stratégie. Vous créez des étendues adaptatives à l’aide de l’applet de commande New-AdaptiveScope. Vous pouvez utiliser n’importe quelle valeur qui identifie de façon unique l’étendue adaptative. Par exemple :
- Nom
- Nom unique (DN)
- GUID
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Applications
Le paramètre Applications spécifie la cible lorsque Groupes Microsoft 365 sont incluses dans la stratégie (le paramètre ModernGroups est défini). Les valeurs valides sont les suivantes :
Group:Exchangepour la boîte aux lettres connectée au groupe Microsoft 365.Group:SharePointpour le site SharePoint connecté au groupe Microsoft 365."Group:Exchange,SharePoint"pour la boîte aux lettres et le site SharePoint qui sont connectés au groupe Microsoft 365.- blank (
$null) : il s’agit de la valeur par défaut et est fonctionnellement équivalente à la valeur"Group:Exchange,SharePoint".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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-*) ont 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 |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Enabled
Le paramètre Enabled indique si la stratégie est activée ou désactivée. Les valeurs valides sont les suivantes :
- $true : la stratégie est activée. Il s’agit de la valeur par défaut.
- $true : la stratégie est activée. Il s’agit de la valeur par défaut.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ExchangeLocation
Le paramètre ExchangeLocation spécifie les boîtes aux lettres à inclure dans la stratégie. Les valeurs valides sont les suivantes :
- Le paramètre ExchangeLocation permet de définir les boîtes aux lettres à inclure dans la stratégie. Les valeurs valides sont les suivantes :
- Boîte aux lettres
- Valeur All pour toutes les boîtes aux lettres. Cette valeur ne peut être utilisée que seule.
La valeur All pour toutes les boîtes aux lettres. Vous pouvez uniquement utiliser cette valeur seule.
- Nom
- Nom
- Nom unique
- GUID
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
Si aucune boîte aux lettres n’est définie, aucune boîte aux lettres n’est mise en conservation.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ExchangeLocationException
Le paramètre ExchangeLocationException spécifie les boîtes aux lettres à exclure de la stratégie lorsque vous utilisez la valeur All pour le paramètre ExchangeLocation. Les valeurs valides sont les suivantes :
- Ce paramètre spécifie les boîtes aux lettres à supprimer de la liste des boîtes aux lettres exclues lorsque vous utilisez la valeur All pour le paramètre ExchangeLocation. Les valeurs valides sont les suivantes :
- Boîte aux lettres
La valeur All pour toutes les boîtes aux lettres. Vous pouvez uniquement utiliser cette valeur seule.
- Nom
- Nom
- Nom unique
- GUID
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-IsSimulation
Le commutateur IsSimulation spécifie que la stratégie est créée en mode simulation. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Pour plus d'informations sur le mode simulation, voir En savoir plus sur le mode simulation.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ModernGroupLocation
Le paramètre ModernGroupLocation spécifie les Groupes Microsoft 365 à inclure dans la stratégie. Les valeurs valides sont les suivantes :
- Un groupe Microsoft 365
- Valeur All for all Groupes Microsoft 365. Cette valeur ne peut être utilisée que seule.
Pour identifier le groupe Microsoft 365, vous pouvez utiliser n’importe quelle valeur qui l’identifie de manière unique. Par exemple :
- Nom
- Nom
- Nom unique
- GUID
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ModernGroupLocationException
Le paramètre ModernGroupLocationException spécifie les Groupes Microsoft 365 à exclure de la stratégie lorsque vous utilisez la valeur All pour le paramètre ModernGroupLocation.
Vous pouvez utiliser n’importe quelle valeur qui identifie de façon unique le groupe Microsoft 365. Par exemple :
- Nom
- Nom
- Nom unique
- GUID
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Name
Le paramètre Name permet de définir le nom unique de la stratégie de rétention. Si la valeur contient des espaces, mettez le nom entre guillemets.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-OneDriveLocation
Le paramètre OneDriveLocation spécifie les sites OneDrive Entreprise à inclure. Vous identifiez le site par sa valeur d’URL, ou vous pouvez utiliser la valeur All pour inclure tous les sites.
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-OneDriveLocationException
Ce paramètre spécifie les OneDrive Entreprise sites à exclure lorsque vous utilisez la valeur All pour le paramètre OneDriveLocation. Vous identifiez le site par sa valeur d’URL.
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-PolicyTemplateInfo
Ce paramètre est réservé à l’usage interne chez Microsoft.
| Type: | PswsHashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-PublicFolderLocation
Le paramètre PublicFolderLocation indique que vous souhaitez inclure tous les dossiers publics dans la stratégie de rétention. Vous devez utiliser la valeur All pour ce paramètre.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RestrictiveRetention
Le paramètre RestrictiveRetention spécifie si le verrou de préservation est activé pour la stratégie. Les valeurs valides sont les suivantes :
- $true : le verrouillage de préservation est activé pour la stratégie. Personne, y compris un administrateur, ne peut désactiver la stratégie ou la rendre moins restrictive.
- $false : le verrouillage de préservation n’est pas activé pour la stratégie. Il s’agit de la valeur par défaut.
Lorsqu’une stratégie est verrouillée, personne ne peut la désactiver ou supprimer son contenu. De plus, il est impossible de modifier ou de supprimer le contenu soumis à la stratégie pendant la période de rétention. Vous pouvez seulement ajouter du contenu ou prolonger sa durée de rétention. Une stratégie verrouillée peut être accrue ou étendue, mais elle ne peut pas être réduite ou désactivée.
Par conséquent, avant de verrouiller une stratégie de rétention, il est essentiel de comprendre les exigences de conformité de votre organisation. Ne verrouillez pas une stratégie tant que vous n’êtes pas certain qu’elle répond exactement à vos besoins.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RetainCloudAttachment
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 RetainCloudAttachment spécifie qu’il s’agit d’une stratégie de pièce jointe cloud. Les valeurs valides sont les suivantes :
- $true : la stratégie est une stratégie de pièce jointe cloud.
- $false : la stratégie n’est pas une stratégie de pièce jointe cloud. Il s’agit de la valeur par défaut.
Pour la valeur $true, vous pouvez uniquement utiliser les paramètres d’emplacement suivants :
- SharePointLocation et SharePointLocationException
- OneDriveLocation et OneDriveLocationException
- ModernGroupLocation et ModernGroupLocationException
Une étiquette qui utilise une stratégie de pièce jointe cloud pour créer une règle peut être une étiquette d’enregistrement ou une étiquette réglementaire. Vous ne pouvez pas utiliser une balise de publication pour une stratégie de pièce jointe cloud afin de créer une règle ; seules les balises d’application sont prises en charge.
Le paramètre RetainCloudAttachment n’est pas disponible sur l’applet de commande Set-RetentionCompliancePolicy.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SharePointLocation
Le paramètre SharePointLocation spécifie les sites SharePoint Online à inclure. Vous identifiez le site par sa valeur d’URL, ou vous pouvez utiliser la valeur All pour inclure tous les sites.
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
Les sites SharePoint Online ne peuvent pas être ajoutés à la stratégie tant qu’ils n’ont pas été indexés. Si aucun site n’est défini, aucun site n’est mis en conservation.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SharePointLocationException
Ce paramètre spécifie les sites SharePoint Online à exclure lorsque vous utilisez la valeur All pour le paramètre SharePointLocation. Vous identifiez le site par sa valeur d’URL.
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SkypeLocation
Le paramètre SkypeLocation spécifie les utilisateurs Skype Entreprise Online à inclure dans la stratégie.
Vous pouvez utiliser n’importe quelle valeur qui identifie l’utilisateur de façon unique. Par exemple :
- Nom
- Nom
- Nom unique
- GUID
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SkypeLocationException
Ce paramètre est réservé à l’usage interne chez Microsoft.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-TeamsChannelLocation
Le paramètre TeamsChannelLocation spécifie les Équipes à inclure dans la stratégie.
Vous pouvez utiliser n’importe quelle valeur qui identifie de façon unique l’équipe. Par exemple :
- Nom
- Adresse e-mail
- GUID
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-TeamsChannelLocationException
Le paramètre TeamsChannelLocationException spécifie les Teams à exclure lorsque vous utilisez la valeur All pour le paramètre TeamsChannelLocation. Vous pouvez utiliser n’importe quelle valeur qui identifie de façon unique l’équipe. Par exemple :
- Nom
- Adresse e-mail
- GUID
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-TeamsChatLocation
Le paramètre TeamsChatLocation spécifie les utilisateurs Teams à inclure dans la stratégie.
Vous pouvez utiliser n’importe quelle valeur qui identifie l’utilisateur de façon unique. Par exemple :
- Nom
- Nom
- Nom unique
- GUID
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-TeamsChatLocationException
Le paramètre TeamsChatLocationException spécifie les utilisateurs Teams à exclure lorsque vous utilisez la valeur All pour le paramètre TeamsChatLocation. Vous pouvez utiliser n’importe quelle valeur qui identifie l’utilisateur de façon unique. Par exemple :
- Nom
- Nom
- Nom unique
- GUID
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-WhatIf
Le commutateur WhatIf ne fonctionne pas dans PowerShell conformité de la sécurité & .
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |