Set-CaseHoldPolicy
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 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.
Syntax
Set-CaseHoldPolicy
[-Identity] <PolicyIdParameter>
[-RetryDistribution]
[-Confirm]
[-WhatIf]
[<CommonParameters>] 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 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.
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 Online . - Supprime les dossiers publics.
- Met à jour le commentaire.
Paramètres
-AddExchangeLocation
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 (.).
- 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".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddPublicFolderLocation
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.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddSharePointLocation
Le paramètre AddSharePointLocation spécifie les sites SharePoint Online à 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 Online ne peuvent pas être ajoutés à la stratégie tant qu’ils n’ont pas été indexés.
| 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. 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 |
-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 |
-Identity
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
| Type: | PolicyIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveExchangeLocation
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 (.).
- 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".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemovePublicFolderLocation
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.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveSharePointLocation
Le paramètre RemoveSharePointLocation spécifie les sites SharePoint Online à 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".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RetryDistribution
Le commutateur RetryDistribution spécifie s’il faut redistribuer la stratégie à tous les emplacements Exchange Online et SharePoint Online. 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |