Freigeben über

Set-RetentionCompliancePolicy

  • Referenz
Modul:
ExchangePowerShell
Gilt für::
Security & Compliance

Dieses Cmdlet ist nur im Security & Compliance Center-PowerShell verfügbar. Weitere Informationen finden Sie unter Security & Compliance Center-PowerShell.

Verwenden Sie das Cmdlet Set-RetentionCompliancePolicy, um vorhandene Aufbewahrungsrichtlinien 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. Informationen zur verteilungsbasierten status finden Sie unter Get-RetentionCompliancePolicy.

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

Syntax

Set-RetentionCompliancePolicy
   [-Identity] <PolicyIdParameter>
   [-AddExchangeLocation <MultiValuedProperty>]
   [-AddExchangeLocationException <MultiValuedProperty>]
   [-AddModernGroupLocation <MultiValuedProperty>]
   [-AddModernGroupLocationException <MultiValuedProperty>]
   [-AddOneDriveLocation <MultiValuedProperty>]
   [-AddOneDriveLocationException <MultiValuedProperty>]
   [-AddPublicFolderLocation <MultiValuedProperty>]
   [-AddSharePointLocation <MultiValuedProperty>]
   [-AddSharePointLocationException <MultiValuedProperty>]
   [-AddSkypeLocation <MultiValuedProperty>]
   [-AddSkypeLocationException <MultiValuedProperty>]
   [-Applications <MultiValuedProperty>]
   [-Comment <String>]
   [-Confirm]
   [-DeletedResources <String>]
   [-Enabled <Boolean>]
   [-EnforceSimulationPolicy <Boolean>]
   [-Force]
   [-PolicyTemplateInfo <PswsHashtable>]
   [-PolicyRBACScopes <MultiValuedProperty>]
   [-PriorityCleanup]
   [-RemoveExchangeLocation <MultiValuedProperty>]
   [-RemoveExchangeLocationException <MultiValuedProperty>]
   [-RemoveModernGroupLocation <MultiValuedProperty>]
   [-RemoveModernGroupLocationException <MultiValuedProperty>]
   [-RemoveOneDriveLocation <MultiValuedProperty>]
   [-RemoveOneDriveLocationException <MultiValuedProperty>]
   [-RemovePublicFolderLocation <MultiValuedProperty>]
   [-RemoveSharePointLocation <MultiValuedProperty>]
   [-RemoveSharePointLocationException <MultiValuedProperty>]
   [-RemoveSkypeLocation <MultiValuedProperty>]
   [-RemoveSkypeLocationException <MultiValuedProperty>]
   [-RestrictiveRetention <Boolean>]
   [-StartSimulation <Boolean>]
   [-WhatIf]
   [<CommonParameters>]
Set-RetentionCompliancePolicy
   [-Identity] <PolicyIdParameter>
   [-AddAdaptiveScopeLocation <MultiValuedProperty>]
   [-Applications <MultiValuedProperty>]
   [-Comment <String>]
   [-Confirm]
   [-DeletedResources <String>]
   [-Enabled <Boolean>]
   [-EnforceSimulationPolicy <Boolean>]
   [-Force]
   [-PriorityCleanup]
   [-RemoveAdaptiveScopeLocation <MultiValuedProperty>]
   [-StartSimulation <Boolean>]
   [-WhatIf]
   [<CommonParameters>]
Set-RetentionCompliancePolicy
   [-Identity] <PolicyIdParameter>
   [-RetryDistribution]
   [-Confirm]
   [-DeletedResources <String>]
   [-EnforceSimulationPolicy <Boolean>]
   [-PriorityCleanup]
   [-StartSimulation <Boolean>]
   [-WhatIf]
   [<CommonParameters>]
Set-RetentionCompliancePolicy
   [-Identity] <PolicyIdParameter>
   [-AddTeamsChannelLocation <MultiValuedProperty>]
   [-AddTeamsChannelLocationException <MultiValuedProperty>]
   [-AddTeamsChatLocation <MultiValuedProperty>]
   [-AddTeamsChatLocationException <MultiValuedProperty>]
   [-Comment <String>]
   [-Confirm]
   [-DeletedResources <String>]
   [-Enabled <Boolean>]
   [-EnforceSimulationPolicy <Boolean>]
   [-Force]
   [-PriorityCleanup]
   [-RemoveTeamsChannelLocation <MultiValuedProperty>]
   [-RemoveTeamsChannelLocationException <MultiValuedProperty>]
   [-RemoveTeamsChatLocation <MultiValuedProperty>]
   [-RemoveTeamsChatLocationException <MultiValuedProperty>]
   [-StartSimulation <Boolean>]
   [-WhatIf]
   [<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.

Hinweis: Verwenden Sie beim Hinzufügen oder Entfernen von Bereichsspeicherorten keinen Foreach-Object-Befehl mit Pipe: "Value1","Value2",..."ValueN" | Foreach-Object {Set-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -RemoveExchangeLocation $_}.

Beispiele

Beispiel 1

Set-RetentionCompliancePolicy -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 vorhandenen Aufbewahrungsrichtlinie namens „Regulation 123 Compliance“ durchgeführt:

  • 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.

Beispiel 2

$stringJson = @"
[{
     'EmailAddress': 'USSales@contoso.onmicrosoft.com',
     'SiteId': '9b2a8116-b9ec-4e2c-bf31-7eaa83697c4b'
}]
"@

Set-RetentionCompliancePolicy -Identity "Sales Policy" -RemoveModernGroupLocation "USSales@contoso.onmicrosoft.com" -DeletedResources $stringJson

Im Beispiel werden die angegebene gelöschte Microsoft 365-Gruppe und -Website aus der angegebenen Richtlinie entfernt. Sie identifizieren die gelöschten Ressourcen mithilfe der E-Mail-Adresse der Microsoft 365-Gruppe und der zugehörigen Website-ID.

Beispiel 3

$stringJson = @"
[{
     'EmailAddress': 'USSales@contoso.onmicrosoft.com',
     'SiteId': '8b2a8345-b9ec-3b6a-bf31-6eaa83697c4b'
}]
"@

Set-RetentionCompliancePolicy -Identity "Tenant Level Policy" -AddModernGroupLocationException "USSales@contoso.onmicrosoft.com" -DeletedResources $stringJson

Das Beispiel schließt die angegebene gelöschte Microsoft 365-Gruppe und -Website aus der angegebenen Richtlinie auf Mandantenebene aus. Sie identifizieren die gelöschten Ressourcen mithilfe der E-Mail-Adresse der Microsoft 365-Gruppe und der zugehörigen Website-ID.

Beispiel 4

$stringJson = @"
[{
     'EmailAddress': 'USSales2@contoso.onmicrosoft.com',
     'SiteId': '9b2a8116-b9ec-4e2c-bf31-7eaa83697c4b'
 },
[{
     'EmailAddress': 'USSales2@contoso.onmicrosoft.com',
     'SiteId': '4afb7116-b9ec-4b2c-bf31-4abb83697c4b'
}]
"@

Set-RetentionCompliancePolicy -Identity "Sales Policy" -RemoveModernGroupLocation "USSales2@contoso.onmicrosoft.com" -DeletedResources $stringJson

Dieses Beispiel ähnelt Beispiel 2, mit dem Unterschied, dass mehrere gelöschte Ressourcen angegeben werden.

Parameter

-AddAdaptiveScopeLocation

Der AddAdaptiveScopeLocation-Parameter gibt den Speicherort des adaptiven Bereichs an, der der Richtlinie hinzugefügt werden soll. Sie erstellen adaptive Bereiche mithilfe des Cmdlets New-AdaptiveScope. Sie können einen beliebigen Wert verwenden, der den adaptiven Bereich eindeutig identifiziert. Zum Beispiel:

  • Name
  • Distinguished Name (DN)
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-AddExchangeLocation

Der AddExchangeLocation-Parameter gibt die Postfächer an, die der Liste der enthaltenen Postfächer hinzugefügt werden sollen, wenn Sie nicht den Wert All für den ExchangeLocation-Parameter verwenden. Gültige Werte sind:

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

Der All-Wert für alle Postfächer. Sie können diesen Wert nur allein verwenden.

  • Name
  • Name
  • Distinguished Name (DN)
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-AddExchangeLocationException

Dieser Parameter gibt die Postfächer an, die der Liste der ausgeschlossenen Postfächer hinzugefügt werden sollen, wenn Sie den Wert All für den ExchangeLocation-Parameter verwenden. 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
  • Name
  • Distinguished Name (DN)
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-AddModernGroupLocation

Der AddModernGroupLocation-Parameter gibt die Microsoft 365-Gruppen an, die der Liste der eingeschlossenen Microsoft 365-Gruppen hinzugefügt werden sollen, wenn Sie nicht den Wert All für den ModernGroupLocation-Parameter verwenden.

Sie können einen beliebigen Wert verwenden, der die Microsoft 365-Gruppe eindeutig identifiziert. Zum Beispiel:

  • Name
  • Name
  • Distinguished Name (DN)
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-AddModernGroupLocationException

Der Parameter AddModernGroupLocationException gibt die Microsoft 365-Gruppen an, die der Liste der ausgeschlossenen Microsoft 365-Gruppen hinzugefügt werden sollen, wenn Sie den Wert All für den ModernGroupLocation-Parameter verwenden.

Sie können einen beliebigen Wert verwenden, der die Microsoft 365-Gruppe eindeutig identifiziert. Zum Beispiel:

  • Name
  • Name
  • Distinguished Name (DN)
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-AddOneDriveLocation

Der Parameter AddOneDriveLocation gibt die OneDrive for Business Websites an, die der Liste der eingeschlossenen Websites hinzugefügt werden sollen, wenn Sie nicht den Wert All für den OneDriveLocation-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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-AddOneDriveLocationException

Dieser Parameter gibt die OneDrive for Business Websites an, die der Liste der ausgeschlossenen Websites hinzugefügt werden sollen, wenn Sie den Wert All für den OneDriveLocation-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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-AddPublicFolderLocation

Der Parameter AddPublicFolderLocation gibt an, dass Sie alle öffentlichen Ordner zur Aufbewahrungsrichtlinie hinzufügen möchten. Verwenden Sie für diesen Parameter den Wert All.

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::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.

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-AddSharePointLocationException

Dieser Parameter gibt die SharePoint Online-Websites an, die der Liste der ausgeschlossenen Websites hinzugefügt werden sollen, wenn Sie 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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-AddSkypeLocation

Der AddSkypeLocation-Parameter gibt die Skype for Business Online-Benutzer an, die aus der Liste der enthaltenen Skype for Business Online-Benutzer hinzugefügt werden sollen.

Sie können einen beliebigen Wert angeben, mit dem der Benutzer eindeutig identifiziert werden kann. Beispiel:

  • Name
  • Name
  • Distinguished Name (DN)
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-AddSkypeLocationException

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-AddTeamsChannelLocation

Der Parameter AddTeamsChannelLocation gibt die Teams an, die der Richtlinie hinzugefügt werden sollen.

Sie können einen beliebigen Wert verwenden, der das Team eindeutig identifiziert. Zum Beispiel:

  • Name
  • E-Mail-Adresse
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-AddTeamsChannelLocationException

Der Parameter AddTeamsChannelLocationException gibt die Teams an, die der Ausschlussliste hinzugefügt werden sollen, wenn Sie den Wert All für den Microsoft TeamsChannelLocation-Parameter verwenden. Sie können einen beliebigen Wert verwenden, der das Team eindeutig identifiziert. Zum Beispiel:

  • Name
  • E-Mail-Adresse
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-AddTeamsChatLocation

Der Parameter AddTeamsChatLocation gibt die Teams-Benutzer an, die der Richtlinie hinzugefügt werden sollen.

Sie können einen beliebigen Wert angeben, mit dem der Benutzer eindeutig identifiziert werden kann. Beispiel:

  • Name
  • Name
  • Distinguished Name (DN)
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-AddTeamsChatLocationException

Der Parameter AddTeamsChatLocationException gibt die Teams-Benutzer an, die der Ausschlussliste hinzugefügt werden sollen, wenn Sie den Wert All für den TeamsChatLocation-Parameter verwenden. Sie können einen beliebigen Wert angeben, mit dem der Benutzer eindeutig identifiziert werden kann. Beispiel:

  • Name
  • E-Mail-Adresse
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-Applications

Der Parameter Applications gibt das Ziel an, wenn Microsoft 365-Gruppen in der Richtlinie enthalten sind (der ModernGroups-Parameter ist festgelegt). Gültige Werte sind:

  • Group:Exchange für das Postfach, das mit der Microsoft 365-Gruppe verbunden ist.
  • Group:SharePoint für die SharePoint-Website, die mit der Microsoft 365-Gruppe verbunden ist.
  • "Group:Exchange,SharePoint" für das Postfach und die SharePoint-Website, die mit der Microsoft 365-Gruppe verbunden sind.
  • blank ($null): Dies ist der Standardwert und entspricht funktional dem Wert "Group:Exchange,SharePoint". Um zum Standardwert für das Postfach und die SharePoint-Website für die ausgewählten Microsoft 365-Gruppen zurückzukehren, geben Sie "Group:Exchange,SharePoint" ein.
Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::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".

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::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 (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
  • Die meisten anderen Cmdlets (beispielsweise 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.
Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-DeletedResources

Der Parameter DeletedResources gibt die SharePoint-Websites an, die aus der Liste der eingeschlossenen Websites entfernt oder aus einer Richtlinie auf Mandantenebene ausgeschlossen werden sollen, wenn die zugeordnete Gruppe gelöscht wurde. Sie verwenden diesen Parameter mit den Parametern AddModernGroupLocationException und RemoveModernGroupLocation.

Ein gültiger Wert ist eine JSON-Zeichenfolge. Im Abschnitt Beispiele finden Sie Syntax und Beispiele für die Verwendung dieses Parameters.

Weitere Informationen zu diesem Szenario finden Sie unter Weitere Informationen zum löschen moderner Gruppen unter Aufbewahrungspflicht.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::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.
Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-EnforceSimulationPolicy

Der Parameter EnforceSimulationPolicy gibt an, ob eine Simulationsrichtlinie als aktive Richtlinie erzwungen werden soll. Gültige Werte sind:

  • $true: Erzwingen Sie die Simulationsrichtlinie als aktive Richtlinie.
  • $false: Erzwingen Sie die Simulationsrichtlinie nicht als aktive Richtlinie. Dies ist der Standardwert.

Weitere Informationen zum Simulationsmodus finden Sie unter Informationen zum Simulationsmodus.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-Identity

Der Parameter Identity gibt die Aufbewahrungsrichtlinie an, die Sie ändern möchten. Sie können einen beliebigen Wert verwenden, der die Richtlinie eindeutig identifiziert. Beispiel:

  • Name
  • Distinguished Name (DN)
  • GUID
Typ:PolicyIdParameter
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-PolicyRBACScopes

Der Parameter PolicyRBACScopes gibt die Verwaltungseinheiten an, die der Richtlinie zugewiesen werden sollen. Ein gültiger Wert ist die Microsoft Entra ObjectID (GUID-Wert) der Verwaltungseinheit. Es können mehrere Werte durch Kommata getrennt angegeben werden.

Verwaltungseinheiten sind nur in Microsoft Entra ID P1 oder P2 verfügbar. Sie erstellen und verwalten Verwaltungseinheiten in Microsoft Graph PowerShell.

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-PolicyTemplateInfo

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Typ:PswsHashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-PriorityCleanup

{{ Fill PriorityCleanup Description }}

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-RemoveAdaptiveScopeLocation

Der RemoveAdaptiveScopeLocation-Parameter gibt den Speicherort des adaptiven Bereichs an, der aus der Richtlinie entfernt werden soll. Sie erstellen adaptive Bereiche mithilfe des Cmdlets New-AdaptiveScope. Sie können einen beliebigen Wert verwenden, der den adaptiven Bereich eindeutig identifiziert. Zum Beispiel:

  • Name
  • Distinguished Name (DN)
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-RemoveExchangeLocation

Der Parameter RemoveExchangeLocation gibt die Postfächer an, die aus der Liste der enthaltenen Postfächer entfernt werden sollen, wenn Sie nicht den Wert All für den ExchangeLocation-Parameter verwenden.

Sie können jeden beliebigen Wert verwenden, sofern er das Postfach eindeutig kennzeichnet. Beispiel:

  • Name
  • Name
  • Distinguished Name (DN)
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-RemoveExchangeLocationException

Der Parameter RemoveExchangeLocationException gibt die Postfächer an, die aus der Liste der ausgeschlossenen Postfächer entfernt werden sollen, wenn Sie den Wert All für den ExchangeLocation-Parameter verwenden.

Sie können jeden beliebigen Wert verwenden, sofern er das Postfach eindeutig kennzeichnet. Beispiel:

  • Name
  • Name
  • Distinguished Name (DN)
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-RemoveModernGroupLocation

Der Parameter RemoveModernGroupLocation gibt die Microsoft 365-Gruppen an, die aus der Liste der eingeschlossenen Gruppen entfernt werden sollen, wenn Sie nicht den Wert All für den ModernGroupLocation-Parameter verwenden.

Sie können einen beliebigen Wert verwenden, der die Microsoft 365-Gruppe eindeutig identifiziert. Zum Beispiel:

  • Name
  • Name
  • Distinguished Name (DN)
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-RemoveModernGroupLocationException

Der Parameter RemoveModernGroupLocationException gibt die Microsoft 365-Gruppen an, die aus der Liste der ausgeschlossenen Gruppen entfernt werden sollen, wenn Sie den Wert All für den ModernGroupLocation-Parameter verwenden.

Sie können einen beliebigen Wert verwenden, der die Microsoft 365-Gruppe eindeutig identifiziert. Zum Beispiel:

  • Name
  • Name
  • Distinguished Name (DN)
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-RemoveOneDriveLocation

Der Parameter RemoveOneDriveLocation gibt die OneDrive for Business Websites an, die aus der Liste der eingeschlossenen Websites entfernt werden sollen, wenn Sie nicht den Wert All für den OneDriveLocation-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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-RemoveOneDriveLocationException

Dieser Parameter gibt die OneDrive for Business Websites an, die aus der Liste der ausgeschlossenen Websites entfernt werden sollen, wenn Sie den Wert All für den OneDriveLocation-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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-RemovePublicFolderLocation

Der Parameter RemovePublicFolderLocation gibt an, dass Sie alle öffentlichen Ordner aus der Aufbewahrungsrichtlinie entfernen möchten. Verwenden Sie für diesen Parameter den Wert All.

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-RemoveSharePointLocationException

Dieser Parameter gibt die SharePoint Online-Websites an, die aus der Liste der ausgeschlossenen Websites entfernt werden sollen, wenn Sie 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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-RemoveSkypeLocation

Der Parameter RemoveSkypeLocation gibt die Skype for Business Online-Benutzer an, die aus der Liste der enthaltenen Skype for Business Online-Benutzer entfernt werden sollen.

Sie können einen beliebigen Wert angeben, mit dem der Benutzer eindeutig identifiziert werden kann. Beispiel:

  • Name
  • Name
  • Distinguished Name (DN)
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-RemoveSkypeLocationException

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-RemoveTeamsChannelLocation

Der Parameter RemoveTeamsChannelLocation gibt die Teams an, die aus der Richtlinie entfernt werden sollen.

Sie können einen beliebigen Wert verwenden, der das Team eindeutig identifiziert. Zum Beispiel:

  • Name
  • E-Mail-Adresse
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-RemoveTeamsChannelLocationException

Der Parameter RemoveTeamsChannelLocationException gibt die Teams an, die aus der Ausschlussliste entfernt werden sollen, wenn Sie den Wert All für den TeamsChannelLocation-Parameter verwenden. Sie können einen beliebigen Wert verwenden, der das Team eindeutig identifiziert. Zum Beispiel:

  • Name
  • E-Mail-Adresse
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-RemoveTeamsChatLocation

Der Parameter RemoveTeamsChatLocation gibt die Teams-Benutzer an, die aus der Richtlinie entfernt werden sollen.

Sie können einen beliebigen Wert angeben, mit dem der Benutzer eindeutig identifiziert werden kann. Beispiel:

  • Name
  • Name
  • Distinguished Name (DN)
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-RemoveTeamsChatLocationException

Der Parameter RemoveTeamsChatLocationException gibt die Teams-Benutzer an, die aus der Ausschlussliste entfernt werden sollen, wenn Sie den Wert All für den TeamsChatLocation-Parameter verwenden. Sie können einen beliebigen Wert angeben, mit dem der Benutzer eindeutig identifiziert werden kann. Beispiel:

  • Name
  • E-Mail-Adresse
  • GUID

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".

Typ:MultiValuedProperty
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-RestrictiveRetention

Der Parameter RestrictiveRetention gibt an, ob die Erhaltungssperre für eine Aufbewahrungsrichtlinie oder eine Aufbewahrungsbezeichnungsrichtlinie aktiviert ist. Gültige Werte sind:

  • $true: Die Erhaltungssperre ist für die Richtlinie aktiviert. Niemand (auch kein Administrator) kann die Richtlinie deaktivieren oder ihre Restriktivität einschränken.
  • $false: Die Erhaltungssperre ist für die Richtlinie nicht aktiviert. Dies ist der Standardwert.

Nachdem eine Richtlinie gesperrt wurde, kann niemand sie deaktivieren oder deaktivieren oder Inhalte aus der Richtlinie entfernen. Außerdem ist es nicht möglich, Inhalte, die der Richtlinie unterliegen, während des Aufbewahrungszeitraums zu ändern oder zu löschen. Die einzige Möglichkeit, die Aufbewahrungsrichtlinie zu ändern, ist das Hinzufügen von Inhalten oder das Verlängern der Dauer. Eine gesperrte Richtlinie kann erhöht oder erweitert werden, aber sie kann nicht reduziert, deaktiviert oder deaktiviert werden.

Bevor Sie eine Richtlinie für die Aufbewahrung sperren, ist es daher wichtig, dass Sie die Konformitätsanforderungen Ihrer organization verstehen und dass Sie eine Richtlinie erst sperren, wenn Sie sicher sind, dass sie das ist, was Sie benötigen.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::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 keinen Wert für diese Option angeben.

Speicherorte, deren erste Verteilungen erfolgreich waren, sind nicht in die Wiederholung eingeschlossen. Fehler bei der Richtlinienverteilung werden gemeldet, wenn Sie diesen Switch verwenden.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-StartSimulation

Der Parameter StartSimulation gibt an, ob die Simulation für eine Richtlinie gestartet werden soll, die im Simulationsmodus erstellt wurde. Gültige Werte sind:

  • $true: Starten Sie die Simulation.
  • $false: Starten Sie die Simulation nicht. Dies ist der Standardwert.

Weitere Informationen zum Simulationsmodus finden Sie unter Informationen zum Simulationsmodus.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance

-WhatIf

Der WhatIf-Schalter funktioniert in Security & Compliance PowerShell nicht.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::Security & Compliance