New-RetentionCompliancePolicy

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

Verwenden Sie das Cmdlet New-RetentionCompliancePolicy, um neue Aufbewahrungsrichtlinien im Microsoft 365 Compliance Center zu erstellen.

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

Syntax

New-RetentionCompliancePolicy
   [-Name] <String>
   [-Applications <MultiValuedProperty>]
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExchangeLocation <MultiValuedProperty>]
   [-ExchangeLocationException <MultiValuedProperty>]
   [-Force]
   [-ModernGroupLocation <MultiValuedProperty>]
   [-ModernGroupLocationException <MultiValuedProperty>]
   [-OneDriveLocation <MultiValuedProperty>]
   [-OneDriveLocationException <MultiValuedProperty>]
   [-PublicFolderLocation <MultiValuedProperty>]
   [-RestrictiveRetention <Boolean>]
   [-SharePointLocation <MultiValuedProperty>]
   [-SharePointLocationException <MultiValuedProperty>]
   [-SkypeLocation <MultiValuedProperty>]
   [-SkypeLocationException <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]
New-RetentionCompliancePolicy
   [-Name] <String>
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-Force]
   [-RestrictiveRetention <Boolean>]
   [-TeamsChannelLocation <MultiValuedProperty>]
   [-TeamsChannelLocationException <MultiValuedProperty>]
   [-TeamsChatLocation <MultiValuedProperty>]
   [-TeamsChatLocationException <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Beschreibung

Die neuen Richtlinien sind erst gültig und werden erst angewendet, wenn eine Aufbewahrungsregel zu der Richtlinie hinzugefügt wird. Weitere Informationen finden Sie unter New-RetentionComplianceRule. Darüber hinaus muss mindestens ein Speicherortparameter definiert werden, um eine Aufbewahrungsrichtlinie zu erstellen.

Um dieses Cmdlet in Security & Compliance Center PowerShell zu verwenden, müssen Ihnen Berechtigungen zugewiesen werden. Weitere Informationen finden Sie unter Berechtigungen im Microsoft 365 Compliance Center.

Beispiele

Beispiel 1

New-RetentionCompliancePolicy -Name "Regulation 123 Compliance" -ExchangeLocation "Kitty Petersen", "Scott Nakamura" -SharePointLocation "https://contoso.sharepoint.com/sites/teams/finance"
New-RetentionComplianceRule -Name RetUnlimited -Policy "Regulation 123 Compliance" -RetentionDuration Unlimited

Der erste Befehl in diesem Beispiel erstellt eine Aufbewahrungsrichtlinie mit dem Namen "Regulation 123 Compliance" für die Postfächer von Kitty Petersen und Prior Prior Priormura sowie die Finanz- SharePoint Onlinewebsite. Der zweite Befehl erstellt eine neue Aufbewahrungsregel namens "RetUnlimited" und fügt sie der Aufbewahrungsrichtlinie hinzu, die mit dem Ersten Befehl erstellt wurde.

Parameter

-Applications

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

  • Group:Exchangefür das Postfach, das mit der Microsoft 365-Gruppe verbunden ist.
  • Group:SharePointfür die SharePoint Website, die mit der Microsoft 365-Gruppe verbunden ist.
  • "Group:Exchange","Group:SharePoint"für das Postfach und die SharePoint Website, die mit der Microsoft 365-Gruppe verbunden sind.
  • leer ( $null ): Dies ist der Standardwert und entspricht funktional dem "Group:Exchange","Group:SharePoint" Wert.
Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-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.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-ExchangeLocation

GUID

  • Der ExchangeLocation-Parameter gibt Postfächer an, die in die Richtlinie einbezogen werden sollen. Gültige Werte sind:
  • Ein Postfach
  • Eine Verteilergruppe oder eine E-Mail-aktivierte Sicherheitsgruppe (alle Postfächer, die derzeit Mitglieder der Gruppe sind).

Eine Verteilergruppe oder E-Mail-aktivierte Sicherheitsgruppe

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

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

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

Dieser Parameter 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. 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

Eine Verteilergruppe oder E-Mail-aktivierte Sicherheitsgruppe

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

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

Der Switch Force gibt an, ob Warn- oder Bestätigungsmeldungen unterdrückt werden. Sie können diesen Switch verwenden, um Aufgaben in Fällen programmgesteuert auszuführen, in denen die administrative Eingabe unangemessen ist. Sie müssen keinen Wert für diese Option angeben.

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

Der Parameter ModernGroupLocation gibt die Microsoft 365 Gruppen an, die in die Richtlinie eingeschlossen werden sollen. Gültige Werte sind:

  • Eine Microsoft 365-Gruppe
  • Der Wert "Alle" für alle Microsoft 365 -Gruppen. Dieser Wert kann nur alleine verwendet werden.

Um die Microsoft 365 Gruppe zu identifizieren, können Sie einen beliebigen Wert verwenden, der sie eindeutig identifiziert. 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".

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

The ModernGroupLocationException parameter specifies the Microsoft 365 Groups to exclude when you're using the value All for the ModernGroupLocation parameter.

Sie können einen beliebigen Wert verwenden, der die Microsoft 365-Gruppe eindeutig identifiziert. 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".

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

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

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-OneDriveLocation

Der Parameter OneDriveLocation gibt die OneDrive for Business Websites an, die eingeschlossen werden sollen. Sie identifizieren die Website anhand ihres URL-Werts, oder Sie können den Wert "Alle" verwenden, um alle Websites einzuschließen.

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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-OneDriveLocationException

Dieser Parameter gibt die OneDrive for Business Websites an, die ausgeschlossen werden sollen, wenn Sie den Wert "All" für den Parameter "OneDriveLocation" 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-PublicFolderLocation

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

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

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

  • $true: Die Erhaltungssperre ist für die Richtlinie aktiviert. Niemand - einschließlich eines Administrators - kann die Richtlinie deaktivieren oder weniger restriktiv machen.
  • $false: Die Erhaltungssperre ist für die Richtlinie nicht aktiviert. Dies ist der Standardwert.

Wurde eine Richtlinie gesperrt, kann sie von niemandem abgeschaltet oder deaktiviert werden. Außerdem können keine Inhalte aus der Richtlinie entfernt werden. Darüber hinaus ist es nicht möglich, Inhalte zu ändern oder zu löschen, die während des Aufbewahrungszeitraums der Richtlinie unterliegen. Sie können die Aufbewahrungsrichtlinie nur ändern, indem Sie Inhalte hinzufügen oder ihre Gültigkeitsdauer verlängern. Eine gesperrte Richtlinie kann ausgeweitet oder verlängert werden; sie kann jedoch nicht eingeschränkt, deaktiviert oder abgeschaltet werden.

Aus diesem Grund müssen Sie sich vor der Sperrung einer Aufbewahrungsrichtlinie einen genauen Überblick über die Complianceanforderungen Ihrer Organisation verschaffen. Sie dürfen eine Richtlinie auf keinen Fall sperren, bevor Sie sich absolut sicher sind, dass dies notwendig ist.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-SharePointLocation

Der SharePointLocation-Parameter gibt die SharePoint Onlinewebsites an, die eingeschlossen werden sollen. Sie identifizieren die Website anhand ihres URL-Werts, oder Sie können den Wert "Alle" verwenden, um alle Websites einzuschließen.

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 Onlinewebsites 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-SharePointLocationException

Dieser Parameter gibt die SharePoint auszuschließenden Onlinewebsites an, wenn Sie den Wert "All" für den Parameter "SharePointLocation" 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-SkypeLocation

Der SkypeLocation-Parameter gibt die Skype for Business Onlinebenutzer an, die in die Richtlinie einbezogen werden sollen.

Sie können jeden beliebigen Wert verwenden, der den Benutzer eindeutig identifiziert. 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".

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

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

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

Der Parameter TeamsChannelLocation gibt die Teams an, die in die Richtlinie eingeschlossen werden sollen.

Sie können einen beliebigen Wert verwenden, der das Team eindeutig identifiziert. 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".

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

Der Parameter TeamsChannelLocationException gibt die auszuschließende Teams an, wenn Sie den Wert "All" für den Parameter "TeamsChannelLocation" verwenden. Sie können einen beliebigen Wert verwenden, der das Team eindeutig identifiziert. 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".

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

Der Parameter TeamsChatLocation gibt die Teams Benutzer an, die in die Richtlinie einbezogen werden sollen.

Sie können jeden beliebigen Wert verwenden, der den Benutzer eindeutig identifiziert. 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".

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

Der Parameter TeamsChatLocationException gibt die Teams Benutzer an, die ausgeschlossen werden sollen, wenn Sie den Wert "All" für den Parameter "TeamsChatLocation" verwenden. 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".

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

Der Schalter „-WhatIf“ funktioniert im Security & Compliance Center-PowerShell nicht.

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

Eingaben

Ausgaben