Get-CaseHoldPolicy
Dieses Cmdlet ist nur im Security & Compliance Center-PowerShell verfügbar. Weitere Informationen finden Sie unter Security & Compliance Center-PowerShell.
Verwenden Sie die Get-CaseHoldPolicy, um vorhandene Fallaufbewahrungsrichtlinien im Microsoft Purview-Complianceportal anzuzeigen. Um relevante Informationen zur Anwendung der Sperre und zu den betroffenen Speicherorten zu erhalten, müssen Sie den Schalter DistributionDetail einfügen.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Default (Standard)
Get-CaseHoldPolicy
[[-Identity] <PolicyIdParameter>]
[-Case <String>]
[-DistributionDetail]
[-IncludeBindings]
[-IncludeBindingsOnly]
[<CommonParameters>]
Beschreibung
Um dieses Cmdlet in Security & Compliance PowerShell zu verwenden, müssen Ihnen Berechtigungen zugewiesen werden. Weitere Informationen finden Sie unter Berechtigungen im Microsoft Purview-Complianceportal.
Beispiele
Beispiel 1
Get-CaseHoldPolicy -Case "Contoso Legal"
In diesem Beispiel werden ausführliche Informationen für die Richtlinie angezeigt, die dem eDiscovery-Fall mit dem Namen "Contoso Legal" zugeordnet ist.
Beispiel 2
Get-CaseHoldPolicy -Identity "Regulation 123 Compliance"
In diesem Beispiel werden detaillierte Informationen für die Richtlinie mit dem Namen "Regulation 123 Compliance" angezeigt.
Parameter
-Case
Anwendbar: Sicherheit & Compliance
Der Case-Parameter gibt die Fallaufbewahrungsrichtlinie an, die Sie anzeigen möchten, indem Sie den eDiscovery-Fall verwenden, der der Richtlinie zugeordnet ist. Sie können die folgenden Werte verwenden, um den eDiscovery-Fall anzugeben:
- Name
- Identität (GUID-Wert)
Sie können diese Werte mithilfe des Befehls Get-ComplianceCase | Format-Table -Auto Name,Status,Identity abrufen.
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 |
-DistributionDetail
Anwendbar: Sicherheit & Compliance
Der Schalter DistributionDetail gibt detaillierte Informationen zur Richtlinienverteilung in der Fallaufbewahrungsrichtlinie zurück. Sie müssen keinen Wert für diese Option angeben.
Wenn Sie diesen Schalter nicht verwenden, gibt der Befehl keine Informationen zur aktuellen Bereitstellung status zurück, und die DistributionStatus-Eigenschaft wird als "Pending" angezeigt.
Die folgenden Eigenschaften sind von dieser Änderung betroffen:
- SharePointLocation
- ExchangeLocation
- PublicFolderLocation
- DistributionStatus
- DistributionResults
- LastStatusUpdateTime
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 |
-Identity
Anwendbar: Sicherheit & Compliance
Der Parameter "Identity" gibt die Fallaufbewahrungsrichtlinie an, die Sie anzeigen möchten. Sie können einen beliebigen Wert verwenden, der die Richtlinie eindeutig identifiziert. Beispiel:
- Name
- Distinguished Name (DN)
- GUID
Vorsicht: Der Wert $null oder ein nicht vorhandener Wert für den Identity-Parameter gibt alle Objekte so zurück, als ob Sie den Get-Befehl ohne den Identity-Parameter ausgeführt hätten. Überprüfen Sie, ob alle Wertelisten für den Parameter "Identity" korrekt sind und keine nicht vorhandenen $null-Werte enthalten.
Parametereigenschaften
| Typ: | PolicyIdParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-IncludeBindings
Anwendbar: Sicherheit & Compliance
PARAMVALUE: SwitchParameter
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 |
-IncludeBindingsOnly
Anwendbar: Sicherheit & Compliance
{{ Fill IncludeBindingsOnly Description }}
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 |
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.