Set-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 l’applet de commande Set-CaseHoldPolicy pour modifier les stratégies de conservation de cas existantes dans le portail de conformité Microsoft Purview.
Remarque : L’exécution de cette applet de commande entraîne une synchronisation complète entre vos organization, ce qui est une opération importante. Si vous devez mettre à jour 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. Si vous devez mettre à jour une stratégie plusieurs fois, apportez toutes les modifications dans un seul appel de l’applet de commande. 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
RetryDistribution
Set-CaseHoldPolicy
[-Identity] <PolicyIdParameter>
[-RetryDistribution]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Identity
Set-CaseHoldPolicy
[-Identity] <PolicyIdParameter>
[-AddExchangeLocation <MultiValuedProperty>]
[-AddPublicFolderLocation <MultiValuedProperty>]
[-AddSharePointLocation <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-Force]
[-RemoveExchangeLocation <MultiValuedProperty>]
[-RemovePublicFolderLocation <MultiValuedProperty>]
[-RemoveSharePointLocation <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.
Remarque : n’utilisez pas de commande de Foreach-Object redirigée lors de l’ajout ou de la suppression d’emplacements d’étendue : "Value1","Value2",..."ValueN" | Foreach-Object {Set-CaseHoldPolicy -Identity "Regulation 123 Compliance" -RemoveExchangeLocation $_}.
Exemples
Exemple 1
Set-CaseHoldPolicy -Identity "Regulation 123 Compliance" -AddExchangeLocation "Kitty Petersen" -AddSharePointLocation "https://contoso.sharepoint.com/sites/teams/finance" -RemovePublicFolderLocation All -Comment "Added new counsel, 9/9/14"
Cet exemple apporte les modifications suivantes à la stratégie de conservation nommée « Regulation 123 Compliance » :
- Ajoute la boîte aux lettres de l’utilisatrice nommée Kitty Petersen.
- Ajoute le site
https://contoso.sharepoint.com/sites/teams/financeSharePoint . - Supprime les dossiers publics.
- Met à jour le commentaire.
Paramètres
-AddExchangeLocation
Applicable : Sécurité & Conformité
Le paramètre AddExchangeLocation spécifie les boîtes aux lettres à ajouter à la liste des boîtes aux lettres incluses. 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".
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
Identity
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-AddPublicFolderLocation
Applicable : Sécurité & Conformité
Le paramètre AddPublicFolderLocation indique que vous souhaitez ajouter tous les dossiers publics à 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
Identity
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-AddSharePointLocation
Applicable : Sécurité & Conformité
Le paramètre AddSharePointLocation spécifie les sites SharePoint à ajouter à la liste des sites inclus lorsque vous n’utilisez pas 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".
Les sites SharePoint ne peuvent pas être ajoutés à la stratégie tant qu’ils n’ont pas été indexés.
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
Identity
| 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
Identity
| 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. 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
Identity
| 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
Identity
| 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 permet de définir la stratégie de conservation à modifier. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la stratégie. Par exemple :
- Nom
- Nom unique (DN)
- GUID
Propriétés du paramètre
| 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: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-RemoveExchangeLocation
Applicable : Sécurité & Conformité
Le paramètre RemoveExchangeLocation spécifie les boîtes aux lettres existantes à supprimer de la stratégie. 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
- 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".
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
Identity
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RemovePublicFolderLocation
Applicable : Sécurité & Conformité
Le paramètre RemovePublicFolderLocation indique que vous souhaitez supprimer tous les dossiers publics de 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
Identity
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RemoveSharePointLocation
Applicable : Sécurité & Conformité
Le paramètre RemoveSharePointLocation spécifie les sites SharePoint à supprimer de la liste des sites inclus lorsque vous n’utilisez pas 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".
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
Identity
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RetryDistribution
Applicable : Sécurité & Conformité
Le commutateur RetryDistribution spécifie s’il faut redistribuer la stratégie à tous les emplacements Exchange Online et SharePoint. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Les emplacements dont la distribution initiale a réussi ne sont pas inclus dans la nouvelle tentative. Les erreurs de distribution de stratégie sont signalées lorsque vous utilisez ce commutateur.
Remarque : Étant donné que le processus de nouvelle tentative de distribution est une opération importante, exécutez-la uniquement si nécessaire et pour une stratégie à la fois. Il n’est pas destiné à être exécuté chaque fois que vous mettez à jour une stratégie. Si vous exécutez un script pour mettre à jour plusieurs stratégies, attendez que la distribution de stratégie réussisse avant d’exécuter à nouveau la commande pour la stratégie suivante.
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
RetryDistribution
| Position: | Named |
| Obligatoire: | True |
| 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.