Partager via

New-CaseHoldPolicy

Module:
Exchange PowerShell

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

Remarque

Cette applet de commande entraîne une synchronisation complète sur votre organization, ce qui est une opération importante. Si vous devez créer plusieurs stratégies, attendez que la distribution de stratégie réussisse avant d’exécuter à nouveau l’applet de commande pour la stratégie suivante. Pour plus d’informations sur la distribution status, consultez Get-CaseHoldPolicy.

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

Applicable : Sécurité & Conformité

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.

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:True
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

-Enabled

Applicable : Sécurité & Conformité

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. Cette valeur est la valeur par défaut.
  • $true : la stratégie est activée. Il s’agit de la valeur par défaut.

Propriétés du paramètre

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

-ExchangeLocation

Applicable : Sécurité & Conformité

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 (.).
  • Microsoft Entra ObjectId. 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.

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

-Force

Applicable : Sécurité & Conformité

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.

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

-Name

Applicable : Sécurité & Conformité

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.

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

-PublicFolderLocation

Applicable : Sécurité & Conformité

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.

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

-SharePointLocation

Applicable : Sécurité & Conformité

Le paramètre SharePointLocation spécifie les sites SharePoint et OneDrive à inclure. Vous identifiez un 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".

Les sites 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.

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

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