Invoke-HoldRemovalAction
Dieses Cmdlet ist nur im Security & Compliance Center-PowerShell verfügbar. Weitere Informationen finden Sie unter Security & Compliance Center-PowerShell.
Verwenden Sie das Cmdlet Invoke-HoldRemovalAction, um Haltebereiche für Postfächer und SharePoint-Websites anzuzeigen und zu entfernen. Sie können auch Haltebereiche sehen, die zuvor mit diesem Cmdlet entfernt wurden.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Default (Standardwert)
Invoke-HoldRemovalAction
-Action <HoldRemovalActionType>
[-Confirm]
[-ExchangeLocation <String>]
[-Force]
[-HoldId <String>]
[-SharePointLocation <String>]
[-WhatIf]
[<CommonParameters>]
Beschreibung
Um dieses Cmdlet in Security & Compliance PowerShell zu verwenden, müssen Ihnen Berechtigungen zugewiesen werden. Nur der Complianceadministrator kann den Haltepunkt für Exchange- oder SharePoint-Speicherorte entfernen. Weitere Informationen finden Sie unter Berechtigungen im Microsoft Purview-Complianceportal.
Beispiele
Beispiel 1
Invoke-HoldRemovalAction -Action RemoveHold -ExchangeLocation "KittyPetersen@contoso.onmicrosoft.com" -HoldId "UniHecbf89df-74fc-444a-a2dc-c0756c7d3503"
In diesem Beispiel wird der angegebene Halteraum für das Postfach von Kitty Petersen entfernt, wenn die Richtlinie UniHecbf89df-74fc-444a-a2dc-c0756c7d3503 keine aktive Richtlinie für die Aufbewahrung von Groß-/Kleinschreibungen ist.
Beispiel 2
Invoke-HoldRemovalAction -Action GetHolds -SharePointLocation "https://contoso.sharepoint.com/sites/finance"
In diesem Beispiel werden alle Halteinformationen auf der angegebenen SharePoint-Website angezeigt.
Beispiel 3
Invoke-HoldRemovalAction -Action GetHoldRemovals
In diesem Beispiel werden alle Haltehaltestellen angezeigt, die mit diesem Cmdlet durchgeführt wurden.
Parameter
-Action
Anwendbar: Security & Compliance
Der Action-Parameter gibt den Modus an, in dem das Cmdlet ausgeführt wird. Gültige Werte sind:
- GetHoldRemovals: Zeigt alle Haltehalteentfernungen an, die mit diesem Cmdlet durchgeführt wurden.
- GetHolds: Zeigt Haltebereiche für das angegebene Postfach (den ExchangeLocation-Parameter) oder die SharePoint-Website (den SharePointLocation-Parameter) an.
- RemoveHold: Entfernt den angegebenen Halteraum (der HoldId-Parameter) aus dem angegebenen Postfach (der ExchangeLocation-Parameter) oder der SharePoint-Website (sharePointLocation-Parameter).
Parametereigenschaften
| Typ: | HoldRemovalActionType |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Anwendbar: Security & Compliance
Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.
- Destruktive Cmdlets (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen:
-Confirm:$false. - Die meisten anderen Cmdlets (beispielsweise New-*- und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ExchangeLocation
Anwendbar: Security & Compliance
Der ExchangeLocation-Parameter gibt die E-Mail-Adresse des Postfachs an, das die anzuzeigenden oder zu entfernenden Haltebereiche enthält.
Dieser Parameter ist erforderlich, wenn Sie den Wert GetHolds oder RemoveHold für den Action-Parameter verwenden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Force
Anwendbar: Security & Compliance
Der Schalter „Erzwingen“ blendet Warnungs- oder Bestätigungsmeldungen aus. Sie müssen keinen Wert für diese Option angeben.
Sie können diesen Schalter verwenden, um das Entfernen des Halteraums auch dann zu erzwingen, wenn die Richtlinie aktiv ist. Stattdessen sollten Sie den Halteraum aus der Fall-Aufbewahrungsrichtlinie entfernen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-HoldId
Anwendbar: Security & Compliance
Der HoldId-Parameter gibt den Halteraum an, den Sie anzeigen oder entfernen möchten.
Um gültige Werte für diesen Parameter zu finden, verwenden Sie dieses Cmdlet mit dem Action-Parameterwert GetHolds, und suchen Sie in der Ausgabe nach der HoldId-Eigenschaft.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SharePointLocation
Anwendbar: Security & Compliance
Der Parameter SharePointLocation gibt die URL der SharePoint-Website an, die die anzuzeigenden oder zu entfernenden Haltebereiche enthält.
Dieser Parameter ist erforderlich, wenn Sie den Wert GetHolds oder RemoveHold für den Action-Parameter verwenden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Anwendbar: Security & Compliance
Der WhatIf-Schalter funktioniert in Security & Compliance PowerShell nicht.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.