Partager via


Get-CaseHoldPolicy

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 Get-CaseHoldPolicy pour afficher les stratégies de conservation de cas existantes dans le portail de conformité Microsoft Purview. Pour obtenir des informations pertinentes sur la façon dont la conservation a été appliquée et les emplacements affectés, vous devez inclure le commutateur DistributionDetail.

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)

Get-CaseHoldPolicy
    [[-Identity] <PolicyIdParameter>]
    [-Case <String>]
    [-DistributionDetail]
    [-IncludeBindings]
    [-IncludeBindingsOnly]
    [<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

Get-CaseHoldPolicy -Case "Contoso Legal"

Cet exemple affiche des informations détaillées sur la stratégie associée au cas eDiscovery nommé « Contoso legal ».

Exemple 2

Get-CaseHoldPolicy -Identity "Regulation 123 Compliance"

Cet exemple affiche des informations détaillées sur la stratégie nommée Regulation 123 Compliance.

Paramètres

-Case

Applicable : Sécurité & Conformité

Le paramètre Case spécifie la stratégie de conservation à afficher avec le cas eDiscovery associé à la stratégie. 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 des paramètres

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

-DistributionDetail

Applicable : Sécurité & Conformité

Le commutateur DistributionDetail retourne des informations détaillées sur la distribution de stratégie sur la stratégie de conservation de cas. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Si vous n’utilisez pas ce commutateur, la commande ne retourne pas d’informations sur le status de déploiement actuel et la propriété DistributionStatus indique « Pending ».

Les propriétés suivantes sont affectées par ce commutateur :

  • SharePointLocation
  • ExchangeLocation
  • PublicFolderLocation
  • DistributionStatus
  • DistributionResults
  • LastStatusUpdateTime

Propriétés des paramètres

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

-Identity

Applicable : Sécurité & Conformité

Le paramètre Identity spécifie la stratégie de conservation à afficher. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la stratégie. Par exemple :

  • Nom
  • Nom unique (DN)
  • GUID

Attention : la valeur $null ou une valeur inexistante pour le paramètre Identity retourne tous les objets comme si vous exécutiez la commande Get- sans le paramètre Identity. Vérifiez que les listes de valeurs du paramètre Identity sont exactes et ne contiennent pas de valeurs $null inexistantes.

Propriétés des paramètres

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:1
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-IncludeBindings

Applicable : Sécurité & Conformité

VALEUR_PARAMÈTRE : SwitchParameter

Propriétés des paramètres

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

-IncludeBindingsOnly

Applicable : Sécurité & Conformité

{{ Fill IncludeBindingsOnly Description }}

Propriétés des paramètres

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

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.