Freigeben über


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