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 |