Freigeben über


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 Aufbewahrungsrichtlinien für Groß-/Kleinschreibungen im Microsoft Purview-Complianceportal anzuzeigen. Um relevante Informationen zur Anwendung des Halteraums und zu den betroffenen Speicherorten zu erhalten, müssen Sie den Schalter DistributionDetail einschließen.

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 detaillierte Informationen für die Richtlinie angezeigt, die dem eDiscovery-Fall namens 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: Security & Compliance

Der Case-Parameter gibt die Aufbewahrungsrichtlinie für Groß-/Kleinschreibungen an, die Sie mithilfe des eDiscovery-Falls anzeigen möchten, 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: Security & Compliance

Der Switch DistributionDetail gibt detaillierte Richtlinienverteilungsinformationen zur Aufbewahrungsrichtlinie für Groß-/Kleinschreibung zurück. Sie müssen keinen Wert für diese Option angeben.

Wenn Sie diesen Schalter nicht verwenden, gibt der Befehl keine Informationen zum aktuellen Bereitstellungs-status zurück, und die DistributionStatus-Eigenschaft wird als "Ausstehend" angezeigt.

Diese Option wirkt sich auf die folgenden Eigenschaften aus:

  • 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: Security & Compliance

Der Parameter Identity gibt die Aufbewahrungsrichtlinie für Groß-/Kleinschreibung an, die Sie anzeigen möchten. Sie können einen beliebigen Wert verwenden, der die Richtlinie eindeutig identifiziert. Beispiel:

  • Name
  • Distinguished Name (DN)
  • GUID

Achtung: Der Wert $null oder ein nicht vorhandener Wert für den Identity-Parameter gibt alle Objekte zurück, als ob Sie den Get-Befehl ohne den Identity-Parameter ausgeführt haben. Vergewissern Sie sich, dass listen von Werten für den Identity-Parameter 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: Security & 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: Security & 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.