New-AppRetentionCompliancePolicy

Syntaxe

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>]

Description

Exemples

Exemple 1

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

Paramètres

-AdaptiveScopeLocation

Applicable : sécurité & conformité

Le paramètre AdaptiveScopeLocation spécifie l’emplacement de l’étendue adaptative à inclure dans la stratégie. Vous pouvez créer des étendues adaptatives à l’aide de l’applet de commande New-AdaptiveScope. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique l’étendue adaptative. Par exemple :

• Nom
• Nom unique (DN)
• GUID

Propriétés du paramètre

Jeux de paramètres

-Applications

Applicable : sécurité & conformité

Le paramètre Applications spécifie les applications à inclure dans la stratégie.

Ce paramètre utilise la syntaxe suivante : "LocationType:App1,LocationType:App2,...LocationType:AppN

LocationType est Utilisateur ou Groupe.

App est une valeur prise en charge, comme illustré dans les exemples suivants.

• Applications Microsoft 365 : Par exemple :

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

• Expériences Microsoft Copilot : actuellement en préversion. Vous devez utiliser toutes les valeurs suivantes en même temps :

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

  Remarque : Même si vous devez utiliser CopilotinBusinessApplicationplatformsSales et SQLCopilot, ces valeurs ne sont actuellement pas pertinentes.

• Applications IA d’entreprise : actuellement en préversion. Vous devez utiliser toutes les valeurs suivantes en même temps :

  "User:Entrabased3PAIApps,ChatGPTEnterprise,AzureAIServices"

• Autres applications IA : actuellement en préversion. Vous devez utiliser toutes les valeurs suivantes en même temps :

  "User:CloudAIAppChatGPTConsumer,CloudAIAppGoogleGemini,BingConsumer,DeepSeek"

Propriétés du paramètre

Jeux de paramètres

-Comment

Applicable : sécurité & conformité

Le paramètre Comment permet d’insérer un commentaire facultatif. Si la valeur que vous saisissez contient des espaces, placez-la entre guillemets ("). Par exemple : "Ceci est une note d’administration".

Propriétés du paramètre

Jeux de paramètres

-Confirm

Applicable : sécurité & conformité

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’impact de ce commutateur sur l’applet de commande varie selon que l’applet de commande nécessite une confirmation avant de continuer.

• Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
• La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n'ont pas de pause intégrée. Pour ces applets de commande, la spécification du commutateur Confirmer sans valeur introduit une pause qui vous oblige à accuser réception de la commande avant de continuer.

Propriétés du paramètre

Jeux de paramètres

-Enabled

Applicable : sécurité & conformité

Le paramètre Enabled active ou désactive la stratégie. Les valeurs valides sont les suivantes :

• $true : la stratégie est activée. Cette valeur est la valeur par défaut.
• $true : la stratégie est activée. Il s’agit de la valeur par défaut.

Propriétés du paramètre

Jeux de paramètres

-ExchangeLocation

Applicable : sécurité & conformité

Le paramètre ExchangeLocation spécifie les boîtes aux lettres à inclure dans la stratégie. Les valeurs valides sont les suivantes :

• Le paramètre ExchangeLocation permet de définir les boîtes aux lettres à inclure dans la stratégie. Les valeurs valides sont les suivantes :
• Boîte aux lettres
• Valeur : Tout pour toutes les boîtes aux lettres. Cette valeur ne peut être utilisée que seule.

La valeur All pour toutes les boîtes aux lettres. Vous pouvez uniquement utiliser cette valeur seule.

• Nom
• Nom
• Nom unique
• GUID

Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".

Propriétés du paramètre

Jeux de paramètres

-ExchangeLocationException

Applicable : sécurité & conformité

Le paramètre ExchangeLocationException spécifie les boîtes aux lettres exclues de la stratégie lorsque vous utilisez la valeur All pour le paramètre ExchangeLocation. Les valeurs valides sont les suivantes :

• Ce paramètre spécifie les boîtes aux lettres à supprimer de la liste des boîtes aux lettres exclues lorsque vous utilisez la valeur All pour le paramètre ExchangeLocation. Les valeurs valides sont les suivantes :
• Boîte aux lettres

La valeur All pour toutes les boîtes aux lettres. Vous pouvez uniquement utiliser cette valeur seule.

• Nom
• Nom
• Nom unique
• GUID

Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".

Propriétés du paramètre

Jeux de paramètres

-Force

Applicable : sécurité & conformité

Le commutateur Force masque les messages d’avertissement ou de confirmation. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Vous pouvez utiliser ce commutateur pour exécuter des tâches par programme, lorsqu’une intervention administrative est inappropriée.

Propriétés du paramètre

Jeux de paramètres

-ModernGroupLocation

Applicable : sécurité & conformité

Le paramètre ModernGroupLocation spécifie les Groupes Microsoft 365 à inclure dans la stratégie. Les valeurs valides sont les suivantes :

• Un groupe Microsoft 365
• Valeur Tous pour tous les Groupes Microsoft 365. Cette valeur ne peut être utilisée que seule.

Pour identifier le groupe Microsoft 365, vous pouvez utiliser n’importe quelle valeur qui l’identifie de manière unique. Par exemple :

• Nom
• Nom
• Nom unique
• GUID

Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".

Propriétés du paramètre

Jeux de paramètres

-ModernGroupLocationException

Applicable : sécurité & conformité

Le paramètre ModernGroupLocationException spécifie les groupes Microsoft 365 à exclure de la stratégie lorsque vous utilisez la valeur All pour le paramètre ModernGroupLocation.

Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique le groupe Microsoft 365. Par exemple :

• Nom
• Nom
• Nom unique
• GUID

Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".

Propriétés du paramètre

Jeux de paramètres

-Name

Applicable : sécurité & conformité

Le paramètre Name spécifie un nom unique pour la stratégie de conformité de la rétention des applications. La longueur maximale est de 64 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").

Propriétés du paramètre

Jeux de paramètres

-PolicyRBACScopes

Applicable : sécurité & conformité

Remarque : les unités d’Administration ne sont actuellement pas prises en charge, donc ce paramètre n’est pas fonctionnel. Les informations présentées ici sont à titre d’information lorsque la prise en charge des unités administratives est publiée.

Le paramètre PolicyRBACScopes spécifie les unités administratives à attribuer à la stratégie. Une valeur valide est le Microsoft Entra ObjectID (valeur GUID) de l’unité administrative. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Les unités administratives sont disponibles uniquement dans Microsoft Entra ID P1 ou P2. Vous créez et gérez des unités administratives dans Microsoft Graph PowerShell.

Propriétés du paramètre

Jeux de paramètres

-RestrictiveRetention

Applicable : sécurité & conformité

Le paramètre RestrictiveRetention spécifie si le verrouillage de la préservation est activé pour la stratégie. Les valeurs valides sont les suivantes :

• $true : le verrou de préservation est activé pour la stratégie. Personne - y compris un administrateur - ne peut désactiver la politique ou la rendre moins restrictive.
• $false : le verrouillage de la préservation n’est pas activé pour la stratégie. Cette valeur est la valeur par défaut.

Une fois qu’une stratégie est verrouillée, personne ne peut la désactiver ou supprimer des applications de la stratégie. Vous ne pouvez modifier la stratégie qu’en y ajoutant des applications ou en prolongeant sa durée. Une stratégie verrouillée peut être accrue ou étendue, mais elle ne peut pas être réduite ou désactivée.

Par conséquent, avant de verrouiller une stratégie, il est essentiel que vous compreniez les exigences de conformité de votre organisation et que vous ne verrouillez pas une stratégie tant que vous n’êtes pas certain qu’elle correspond à vos besoins.

Propriétés du paramètre

Jeux de paramètres

-WhatIf

Applicable : sécurité & conformité

Le commutateur WhatIf ne fonctionne pas dans le Centre de sécurité et de conformité PowerShell.

Propriétés du paramètre

Jeux de paramètres

CommonParameters