Invoke-HoldRemovalAction
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 Invoke-HoldRemovalAction pour afficher et supprimer les conservations sur les boîtes aux lettres et les sites SharePoint. Vous pouvez également voir les conservations précédemment supprimées à l’aide de cette applet de commande.
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)
Invoke-HoldRemovalAction
-Action <HoldRemovalActionType>
[-Confirm]
[-ExchangeLocation <String>]
[-Force]
[-HoldId <String>]
[-SharePointLocation <String>]
[-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. Seul l’administrateur de conformité peut supprimer la conservation pour les emplacements Exchange ou Sharepoint. Pour plus d’informations, consultez la rubrique Autorisations dans le portail de conformité Microsoft Purview.
Exemples
Exemple 1
Invoke-HoldRemovalAction -Action RemoveHold -ExchangeLocation "KittyPetersen@contoso.onmicrosoft.com" -HoldId "UniHecbf89df-74fc-444a-a2dc-c0756c7d3503"
Cet exemple supprime la conservation spécifiée sur la boîte aux lettres de Kitty Petersen si la stratégie UniHecbf89df-74fc-444a-a2dc-c0756c7d3503 n’est pas une stratégie de conservation de cas active.
Exemple 2
Invoke-HoldRemovalAction -Action GetHolds -SharePointLocation "https://contoso.sharepoint.com/sites/finance"
Cet exemple montre comment afficher toutes les informations de conservation sur le site SharePoint spécifié.
Exemple 3
Invoke-HoldRemovalAction -Action GetHoldRemovals
Cet exemple montre comment afficher toutes les suppressions de conservation effectuées à l’aide de cette applet de commande.
Paramètres
-Action
Applicable : Sécurité & Conformité
Le paramètre Action spécifie le mode dans lequel l’applet de commande opère. Les valeurs valides sont les suivantes :
- GetHoldRemovals : affiche toutes les suppressions de conservation effectuées à l’aide de cette applet de commande.
- GetHolds : affiche les conservations sur la boîte aux lettres spécifiée (le paramètre ExchangeLocation) ou le site SharePoint (paramètre SharePointLocation).
- RemoveHold : supprime la conservation spécifiée (le paramètre HoldId) de la boîte aux lettres spécifiée (paramètre ExchangeLocation) ou du site SharePoint (paramètre SharePointLocation).
Propriétés du paramètre
| Type: | HoldRemovalActionType |
| 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: | True |
| Valeur du pipeline par nom de propriété: | True |
| 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 |
-ExchangeLocation
Applicable : Sécurité & Conformité
Le paramètre ExchangeLocation spécifie l’adresse e-mail de la boîte aux lettres qui contient les conservations à afficher ou à supprimer.
Ce paramètre est requis lorsque vous utilisez la valeur GetHolds ou RemoveHold pour le paramètre Action.
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 |
-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 forcer la suppression de la conservation même lorsque la stratégie est active. Au lieu de cela, vous devez supprimer la conservation de la stratégie de conservation de cas.
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 |
-HoldId
Applicable : Sécurité & Conformité
Le paramètre HoldId spécifie la conservation que vous souhaitez afficher ou supprimer.
Pour rechercher des valeurs valides pour ce paramètre, utilisez cette applet de commande avec la valeur du paramètre Action GetHolds et recherchez la propriété HoldId dans la sortie.
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 |
-SharePointLocation
Applicable : Sécurité & Conformité
Le paramètre SharePointLocation spécifie l’URL du site SharePoint qui contient les conservations à afficher ou à supprimer.
Ce paramètre est requis lorsque vous utilisez la valeur GetHolds ou RemoveHold pour le paramètre Action.
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 |
| 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 |
-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.