New-CaseHoldPolicy

Référence

Module:: ExchangePowerShell

S’applique à:: Security & Compliance

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-CaseHoldPolicy pour créer de nouvelles stratégies de conservation de cas dans le portail de conformité Microsoft Purview.

Une fois la cmdlet New-CaseHoldPolicy utilisée pour créer une stratégie de conservation, vous devez utiliser la cmdlet New-CaseHoldRule pour créer une règle de conservation et attribuer la règle à la stratégie. Si vous ne créez pas de règle pour cette stratégie, la conservation ne sera pas créée et les emplacements de contenu ne seront pas soumis à une obligation de conservation.

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-CaseHoldPolicy
   [-Name] <String>
   -Case <String>
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExchangeLocation <MultiValuedProperty>]
   [-Force]
   [-PublicFolderLocation <MultiValuedProperty>]
   [-SharePointLocation <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Description

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-CaseHoldPolicy -Name "Regulation 123 Compliance" -Case "123 Compliance Case" -ExchangeLocation "Kitty Petersen", "Scott Nakamura" -SharePointLocation "https://contoso.sharepoint.com/sites/teams/finance"

Cet exemple crée une stratégie de conservation de cas nommée « Conformité au règlement 123 » pour les boîtes aux lettres de Kitty Petersen et Scott Nakamura, et le site SharePoint Online financier pour le cas eDiscovery nommé « 123 Compliance Case ».

N’oubliez pas, une fois la stratégie créée, vous devez créer une règle correspondante à l’aide de la cmdlet New-CaseHoldRule.

Paramètres

-Case

Le paramètre Case spécifie le cas eDiscovery à associer à la stratégie de conservation. Vous pouvez utiliser les valeurs suivantes pour identifier le cas eDiscovery :

Nom
Identité (Valeur GUID).

Vous pouvez trouver ces valeurs en exécutant la commande : Get-ComplianceCase | Format-Table -Auto Name,Status,Identity.

Type:	String
Position:	Named
Default value:	None
Required:	True
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

Pour spécifier une boîte aux lettres ou un groupe de distribution, vous pouvez utiliser les valeurs suivantes :

Nom
Adresse SMTP. Pour spécifier une boîte aux lettres inactive, précédez l’adresse d’un point (.).
Id d’objet Azure AD. Utilisez les applets de commande Get-MgUser ou Get-MgGroup dans Microsoft Graph PowerShell pour rechercher cette valeur.

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

-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

-Name

Le paramètre Name spécifie le nom unique de la stratégie de conservation. 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

-PublicFolderLocation

Le paramètre PublicFolderLocation indique que vous souhaitez inclure tous les dossiers publics dans la stratégie de conservation. 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

-SharePointLocation

Le paramètre SharePointLocation spécifie les sites SharePoint Online et OneDrive Entreprise à inclure. Vous identifiez un site par sa valeur d’URL.