New-AppRetentionCompliancePolicy

Syntax

AdaptiveScopeLocation

New-AppRetentionCompliancePolicy
    [-Name] <String>
    -AdaptiveScopeLocation <MultiValuedProperty>
    -Applications <String[]>
    [-Confirm]
    [-Comment <String>]
    [-Enabled <Boolean>]
    [-Force]
    [-RestrictiveRetention <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

Default

New-AppRetentionCompliancePolicy
    [-Name] <String>
    -Applications <String[]>
    [-Comment <String>]
    [-Confirm]
    [-Enabled <Boolean>]
    [-ExchangeLocation <MultiValuedProperty>]
    [-ExchangeLocationException <MultiValuedProperty>]
    [-Force]
    [-ModernGroupLocation <MultiValuedProperty>]
    [-ModernGroupLocationException <MultiValuedProperty>]
    [-PolicyRBACScopes <MultiValuedProperty>]
    [-RestrictiveRetention <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

Beschreibung

Beispiele

Beispiel 1

New-AppRetentionCompliancePolicy -Name "Regulation 567 Compliance" -Applications "User:MicrosoftTeams","Group:MicrosoftTeams" -ExchangeLocation "Jennifer Petersen","Kitty Nakamura"

Parameter

-AdaptiveScopeLocation

Anwendbar: Sicherheit & Compliance

Der Parameter AdaptiveScopeLocation gibt den Speicherort für den adaptiven Bereich an, der in die Richtlinie aufgenommen werden soll. Sie erstellen adaptive Bereiche mithilfe des New-AdaptiveScope Cmdlets. Sie können einen beliebigen Wert verwenden, der den adaptiven Bereich eindeutig identifiziert. Zum Beispiel:

• Name
• Distinguished Name (DN)
• GUID

Parametereigenschaften

Parametersätze

-Applications

Anwendbar: Sicherheit & Compliance

Der Parameter "Applications" gibt die Anwendungen an, die in die Richtlinie aufgenommen werden sollen.

Dieser Parameter verwendet die folgende Syntax: "LocationType:App1,LocationType:App2,...LocationType:AppN:

LocationType ist Benutzer oder Gruppe.

App ist ein unterstützter Wert, wie in den folgenden Beispielen gezeigt.

• Microsoft 365 Apps: Zum Beispiel:

  "User:Exchange,User:OneDriveForBusiness,Group:Exchange,Group:SharePoint" oder "User:MicrosoftTeams" or "User:Yammer"oder "User:MicrosoftTeamsCallLog"

• Microsoft Copilot-Erfahrungen: Derzeit in der Vorschauphase. Sie müssen alle folgenden Werte gleichzeitig verwenden:

  "User:M365Copilot,CopilotForSecurity,CopilotinFabricPowerBI,CopilotStudio,CopilotinBusinessApplicationplatformsSales,SQLCopilot"

  Hinweis: Auch wenn Sie AND SQLCopilotverwenden CopilotinBusinessApplicationplatformsSales müssen, sind diese Werte derzeit irrelevant.

• Enterprise KI-Apps: Derzeit in der Vorschauphase. Sie müssen alle folgenden Werte gleichzeitig verwenden:

  "User:Entrabased3PAIApps,ChatGPTEnterprise,AzureAIServices"

• Andere KI-Apps: Derzeit in der Vorschauphase. Sie müssen alle folgenden Werte gleichzeitig verwenden:

  "User:CloudAIAppChatGPTConsumer,CloudAIAppGoogleGemini,BingConsumer,DeepSeek"

Parametereigenschaften

Parametersätze

-Comment

Anwendbar: Sicherheit & Compliance

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

Parametereigenschaften

Parametersätze

-Confirm

Anwendbar: Sicherheit & Compliance

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie sich diese Option auf das Cmdlet auswirkt, hängt davon ab, ob für das Cmdlet eine Bestätigung erforderlich ist, bevor Sie fortfahren.

• 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 die Angabe des Bestätigungsschalters ohne Wert zu einer Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren.

Parametereigenschaften

Parametersätze

-Enabled

Anwendbar: Sicherheit & Compliance

Der Parameter Enabled aktiviert oder deaktiviert die Richtlinie. Gültige Werte sind:

• $true: Die Richtlinie ist aktiviert. Dieser Wert ist der Standardwert.
• $true: Die Richtlinie ist aktiviert. Dies ist der Standardwert.

Parametereigenschaften

Parametersätze

-ExchangeLocation

Anwendbar: Sicherheit & Compliance

Der ExchangeLocation-Parameter 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
• Der Wert All für alle Postfächer. Dieser Wert kann nur alleine verwendet werden.

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

Parametereigenschaften

Parametersätze

-ExchangeLocationException

Anwendbar: Sicherheit & Compliance

Der Parameter ExchangeLocationException gibt die Postfächer an, die von der Richtlinie ausgeschlossen werden, 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".

Parametereigenschaften

Parametersätze

-Force

Anwendbar: Sicherheit & Compliance

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.

Parametereigenschaften

Parametersätze

-ModernGroupLocation

Anwendbar: Sicherheit & Compliance

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

Parametereigenschaften

Parametersätze

-ModernGroupLocationException

Anwendbar: Sicherheit & Compliance

Der Parameter ModernGroupLocationException gibt die Microsoft 365-Gruppen an, die von der Richtlinie ausgeschlossen 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".

Parametereigenschaften

Parametersätze

-Name

Anwendbar: Sicherheit & Compliance

Der Name-Parameter gibt einen eindeutigen Namen für die Compliance-Richtlinie zur App-Aufbewahrung an. Die Höchstlänge beträgt 64 Zeichen. Wenn der Wert Leerzeichen enthält, müssen Sie ihn in Anführungszeichen (") setzen.

Parametereigenschaften

Parametersätze

-PolicyRBACScopes

Anwendbar: Sicherheit & Compliance

Hinweis: Admin-Einheiten werden derzeit nicht unterstützt, daher ist dieser Parameter nicht funktionsfähig. Die hier vorgestellten Informationen dienen zu Informationszwecken im Hinblick auf die Freigabe der Unterstützung für Admin-Einheiten.

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.

Parametereigenschaften

Parametersätze

-RestrictiveRetention

Anwendbar: Sicherheit & Compliance

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 – auch kein Administrator – kann die Richtlinie deaktivieren oder weniger restriktiv machen.
• $false: Die Erhaltungssperre ist für die Richtlinie nicht aktiviert. Dieser Wert ist der Standardwert.

Nachdem eine Richtlinie gesperrt wurde, kann niemand sie deaktivieren oder Apps aus der Richtlinie entfernen. Die einzigen Möglichkeiten, die Richtlinie zu ändern, sind das Hinzufügen von Apps oder das Verlängern der Gültigkeitsdauer. Eine gesperrte Richtlinie kann erhöht oder erweitert, jedoch nicht reduziert, deaktiviert oder deaktiviert werden.

Bevor Sie eine Richtlinie sperren, ist es daher wichtig, dass Sie die Complianceanforderungen Ihrer Organization kennen und eine Richtlinie erst sperren, wenn Sie sicher sind, dass sie das ist, was Sie benötigen.

Parametereigenschaften

Parametersätze

-WhatIf

Anwendbar: Sicherheit & Compliance

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

Parametereigenschaften

Parametersätze

CommonParameters