Freigeben über


New-CaseHoldPolicy

Dieses Cmdlet ist nur in PowerShell zur Sicherheitskonformität & verfügbar. Weitere Informationen finden Sie unter Security & Compliance PowerShell.

Verwenden Sie das Cmdlet New-CaseHoldPolicy, um neue Aufbewahrungsrichtlinien für Groß-/Kleinschreibungen im Microsoft Purview-Complianceportal zu erstellen.

Sobald Sie mit dem Cmdlet New-CaseHoldPolicy eine Fallspeicherrichtlinie erstellt haben, müssen Sie mithilfe des Cmdlets New-CaseHoldRule eine Fallspeicherregel erstellen und diese Regel der Richtlinie zuweisen. Wenn Sie keine Regel für die Richtlinie erstellen, wird der Speicher nicht erstellt und greift für keinerlei Inhaltsspeicherorte.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

New-CaseHoldPolicy
   [-Name] <String>
   -Case <String>
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExchangeLocation <MultiValuedProperty>]
   [-Force]
   [-PublicFolderLocation <MultiValuedProperty>]
   [-SharePointLocation <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Beschreibung

Um dieses Cmdlet in PowerShell für Sicherheitskonformität & verwenden zu können, müssen Ihnen Berechtigungen zugewiesen werden. Weitere Informationen finden Sie unter Berechtigungen im Microsoft Purview-Complianceportal.

Beispiele

Beispiel 1

New-CaseHoldPolicy -Name "Regulation 123 Compliance" -Case "123 Compliance Case" -ExchangeLocation "Kitty Petersen", "Scott Nakamura" -SharePointLocation "https://contoso.sharepoint.com/sites/teams/finance"

In diesem Beispiel wird eine Fall-Aufbewahrungsrichtlinie namens "Regulation 123 Compliance" für die Postfächer von Kitty Petersen und Scott Nakamura und die Finanz-SharePoint Online-Website für den eDiscovery-Fall mit dem Namen "123 Compliance Case" erstellt.

Denken Sie daran, dass Sie nach der Erstellung der Richtlinie das Cmdlet New-CaseHoldRule verwenden müssen, um eine Regel für die Richtlinie zu erstellen.

Parameter

-Case

Der Parameter Case gibt den eDiscovery-Fall an, den Sie der Fallspeicherrichtlinie zuordnen möchten. 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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Comment

Der „Comment“-Parameter gibt einen optionalen Kommentar an. Wenn Sie einen Wert angeben, der Leerzeichen enthält, setzen Sie den Wert in Anführungszeichen ("), z. B. "This is an admin note".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Confirm

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 (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
  • Die meisten anderen Cmdlets (z. B. 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.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Enabled

Der Parameter Enabled gibt an, ob die Richtlinie aktiviert oder deaktiviert ist. Gültige Werte sind:

  • $true: Die Richtlinie ist aktiviert. Dies ist der Standardwert.
  • $true: Die Richtlinie ist aktiviert. Dies ist der Standardwert.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExchangeLocation

Der Parameter ExchangeLocation gibt die Postfächer an, die in die Richtlinie eingeschlossen werden sollen. Gültige Werte sind:

  • Der ExchangeLocation-Parameter gibt Postfächer an, die in die Richtlinie einbezogen werden sollen. Gültige Werte sind:
  • Ein Postfach

Um ein Postfach oder eine Verteilergruppe anzugeben, können Sie die folgenden Werte verwenden:

  • Name
  • SMTP-Adresse. Um ein inaktives Postfach anzugeben, stellen Sie der Adresse einen Punkt (.) voran.
  • Azure AD ObjectId. Verwenden Sie die Cmdlets Get-MgUser oder Get-MgGroup in Microsoft Graph PowerShell, um diesen Wert zu finden.

Mehrere Werte können durch Kommata getrennt eingegeben werden. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Werden keine Postfächer angegeben, dann werden keine Postfächer ins Archiv platziert.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Force

Der Schalter „Erzwingen“ blendet Warnungs- oder Bestätigungsmeldungen aus. Sie müssen keinen Wert für diese Option angeben.

Sie können diesen Switch verwenden, um Aufgaben in Fällen programmgesteuert auszuführen, in denen die administrative Eingabe unangemessen ist.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Name

Der Parameter Name gibt den eindeutigen Namen der Fallspeicherrichtlinie an. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-PublicFolderLocation

Der Parameter PublicFolderLocation gibt an, dass alle öffentlichen Ordner in die Fallspeicherrichtlinie einbezogen werden sollen. Verwenden Sie für diesen Parameter den Wert All.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SharePointLocation

Der Parameter SharePointLocation gibt die einzuschließenden SharePoint Online- und OneDrive for Business-Websites an. Sie identifizieren eine Website anhand ihres URL-Werts.

Mehrere Werte können durch Kommata getrennt eingegeben werden. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Websites können der Richtlinie erst hinzugefügt werden, wenn sie indiziert wurden. Werden keine Websites angegeben, dann werden keine Websites ins Archiv platziert.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-WhatIf

Der WhatIf-Schalter funktioniert in PowerShell für Sicherheitskonformität & nicht.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance