Set-CaseHoldPolicy
Dieses Cmdlet ist nur in PowerShell zur Sicherheitskonformität & verfügbar. Weitere Informationen finden Sie unter Security & Compliance PowerShell.
Verwenden Sie das Cmdlet Set-CaseHoldPolicy, um vorhandene Aufbewahrungsrichtlinien für Groß-/Kleinschreibungen im Microsoft Purview-Complianceportal zu ändern.
Hinweis: Die Ausführung dieses Cmdlets führt zu einer vollständigen Synchronisierung in Ihrem organization, was ein wichtiger Vorgang ist. Wenn Sie mehrere Richtlinien aktualisieren müssen, warten Sie, bis die Richtlinienverteilung erfolgreich ist, bevor Sie das Cmdlet für die nächste Richtlinie erneut ausführen. Wenn Sie eine Richtlinie mehrmals aktualisieren müssen, nehmen Sie alle Änderungen in einem einzigen Aufruf des Cmdlets vor. Weitere Informationen zur verteilungsbasierten status finden Sie unter Get-CaseHoldPolicy.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Set-CaseHoldPolicy
[-Identity] <PolicyIdParameter>
[-RetryDistribution]
[-Confirm]
[-WhatIf]
[<CommonParameters>] Set-CaseHoldPolicy
[-Identity] <PolicyIdParameter>
[-AddExchangeLocation <MultiValuedProperty>]
[-AddPublicFolderLocation <MultiValuedProperty>]
[-AddSharePointLocation <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-Force]
[-RemoveExchangeLocation <MultiValuedProperty>]
[-RemovePublicFolderLocation <MultiValuedProperty>]
[-RemoveSharePointLocation <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.
Hinweis: Verwenden Sie beim Hinzufügen oder Entfernen von Bereichsspeicherorten keinen Foreach-Object-Befehl mit Pipe: "Value1","Value2",..."ValueN" | Foreach-Object {Set-CaseHoldPolicy -Identity "Regulation 123 Compliance" -RemoveExchangeLocation $_}.
Beispiele
Beispiel 1
Set-CaseHoldPolicy -Identity "Regulation 123 Compliance" -AddExchangeLocation "Kitty Petersen" -AddSharePointLocation "https://contoso.sharepoint.com/sites/teams/finance" -RemovePublicFolderLocation All -Comment "Added new counsel, 9/9/14"In diesem Beispiel werden die folgenden Änderungen an der bereits vorhandenen Fallspeicherrichtlinie „Regulation 123 Compliance“ vorgenommen:
- Das Postfach für den Benutzer namens Kitty Petersen wird hinzugefügt.
- Fügt die SharePoint Online-Website
https://contoso.sharepoint.com/sites/teams/financehinzu. - Entfernt öffentliche Ordner.
- Der Kommentar wird aktualisiert.
Parameter
-AddExchangeLocation
Der AddExchangeLocation-Parameter gibt die Postfächer an, die der Liste der enthaltenen Postfächer hinzugefügt 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".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddPublicFolderLocation
Der Parameter AddPublicFolderLocation gibt an, dass Sie alle öffentlichen Ordner zur Fallspeicherrichtlinie hinzufügen möchten. 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 |
-AddSharePointLocation
Der AddSharePointLocation-Parameter gibt die SharePoint Online-Websites an, die der Liste der enthaltenen Websites hinzugefügt werden sollen, wenn Sie nicht den Wert All für den SharePointLocation-Parameter verwenden. Sie können die Website anhand ihres URL-Werts bestimmen.
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".
SharePoint Online-Websites können der Richtlinie erst hinzugefügt werden, wenn sie indiziert wurden.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 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 |
-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 |
-Identity
Der Parameter Identity gibt die zu ändernde Fallspeicherrichtlinie an. Sie können einen beliebigen Wert verwenden, der die Richtlinie eindeutig identifiziert. Beispiel:
- Name
- Distinguished Name (DN)
- GUID
| Type: | PolicyIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveExchangeLocation
Der Parameter RemoveExchangeLocation gibt die vorhandenen Postfächer an, die aus der Richtlinie entfernt werden sollen. Gültige Werte sind:
- Dieser Parameter gibt die Postfächer an, die aus der Liste der ausgeschlossenen Postfächer entfernt werden, wenn der Wert All für den ExchangeLocation-Parameter verwendet wird. Gültige Werte sind:
- Ein Postfach
Der All-Wert für alle Postfächer. Sie können diesen Wert nur allein 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".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemovePublicFolderLocation
Der Parameter RemovePublicFolderLocation gibt an, dass Sie alle öffentlichen Ordner aus der Fallspeicherrichtlinie entfernen möchten. 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 |
-RemoveSharePointLocation
Der RemoveSharePointLocation-Parameter gibt die SharePoint Online-Websites an, die aus der Liste der eingeschlossenen Websites entfernt werden sollen, wenn Sie nicht den Wert All für den SharePointLocation-Parameter verwenden. Sie können die Website anhand ihres URL-Werts bestimmen.
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".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RetryDistribution
Der Schalter RetryDistribution gibt an, ob die Richtlinie an alle Exchange Online- und SharePoint Online-Speicherorte verteilt werden soll. Sie müssen bei dieser Option keinen Wert angeben.
Speicherorte, deren erste Verteilungen erfolgreich waren, sind nicht in die Wiederholung eingeschlossen. Fehler bei der Richtlinienverteilung werden gemeldet, wenn Sie diesen Switch verwenden.
Hinweis: Da der Prozess der Erneutverteilung ein wichtiger Vorgang ist, führen Sie ihn nur bei Bedarf und für jeweils eine Richtlinie aus. Sie soll nicht jedes Mal ausgeführt werden, wenn Sie eine Richtlinie aktualisieren. Wenn Sie ein Skript ausführen, um mehrere Richtlinien zu aktualisieren, warten Sie, bis die Richtlinienverteilung erfolgreich ist, bevor Sie den Befehl für die nächste Richtlinie erneut ausführen.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |