Skip to content

Commit a938ca1

Browse files
authored
Merge pull request #12711 from MicrosoftDocs/ARCP-chrisda
ARCP-chrisda to Main
2 parents a2a804c + 3944d37 commit a938ca1

File tree

1 file changed

+26
-6
lines changed

1 file changed

+26
-6
lines changed

exchange/exchange-ps/exchange/New-AppRetentionCompliancePolicy.md

Lines changed: 26 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,9 @@ New-AppRetentionCompliancePolicy [-Name] <String> -Applications <String[]>
5050
```
5151

5252
## DESCRIPTION
53-
\*-AppRetentionCompliance\* cmdlets are used for policies with adaptive policy scopes and all static policies that cover Teams private channels, Viva Engage chats, and Viva Engage community messages. Eventually, you'll use these cmdlets for most retention locations and policy types. The \*-RetentionCompliance\* cmdlets will continue to support Exchange and SharePoint locations primarily. For policies created with the \*-AppRetentionCompliance\* cmdlets, you can only set the list of included or excluded scopes for all included workloads, which means you'll likely need to create one policy per workload.
53+
\*-AppRetentionCompliance\* cmdlets are used for policies with adaptive policy scopes and all static policies in the locations described in [Retention cmdlets for newer locations](https://learn.microsoft.com/purview/retention-cmdlets#retention-cmdlets-for-newer-locations). You can only set the list of included or excluded scopes for all included workloads, which means you likely need to create one policy per workload.
54+
55+
\*-RetentionCompliance\* cmdlets continue to primarily support the locations described in [Retention cmdlets for older locations](https://learn.microsoft.com/purview/retention-cmdlets#retention-cmdlets-for-older-locations).
5456

5557
To use this cmdlet in Security & Compliance PowerShell, you need to be assigned permissions. For more information, see [Permissions in the Microsoft Purview compliance portal](https://learn.microsoft.com/purview/microsoft-365-compliance-center-permissions).
5658

@@ -104,13 +106,31 @@ Accept wildcard characters: False
104106
```
105107
106108
### -Applications
107-
The Applications parameter specifies the applications to include in the policy and is relevant only for the following location parameters:
109+
The Applications parameter specifies the applications to include in the policy. and is relevant only for the following location parameters:
110+
111+
This parameter uses the following syntax: `"LocationType:App1,LocationType:App2,...LocationType:AppN`:
112+
113+
`LocationType` is User or Group.
114+
115+
`App` is a supported value as shown in the following examples.
116+
117+
- **Microsoft 365 apps**: For example:
118+
119+
`"User:Exchange,User:OneDriveForBusiness,Group:Exchange,Group:SharePoint"` or `"User:MicrosoftTeams","User:VivaEngage"`
120+
121+
- **Microsoft Copilot experiences**: Currently in Preview. You must use *all* of the following values at the same time:
122+
123+
`"User:M365Copilot,CopilotForSecurity,CopilotinFabricPowerBI,CopilotStudio,CopilotinBusinessApplicationplatformsSales,SQLCopilot"`
124+
125+
**Note**: Even though you must use `CopilotinBusinessApplicationplatformsSales` and `SQLCopilot`, those values are currently irrelevant.
126+
127+
- **Enterprise AI apps**: Currently in Preview. You must use *all* of the following values at the same time:
128+
129+
`"User:Entrabased3PAIApps,ChatGPTEnterprise,AzureAIServices"`
108130

109-
- ExchangeLocation
110-
- ModernGroupLocation
111-
- AdaptiveScopeLocation
131+
- **Other AI apps**: Currently in Preview. You must use *all* of the following values at the same time:
112132

113-
This parameter uses the following syntax: `"LocationtType:App1,LocationType:App2,...LocationType:AppN` where LocationType is User or Group. For example, `"User:Exchange,User:OneDriveForBusiness,Group:Exchange,Group:SharePoint"` or `"User:MicrosoftTeams","User:VivaEngage"`.
133+
`"User:CloudAIAppChatGPTConsumer,CloudAIAppGoogleGemini,BingConsumer,DeepSeek"`
114134

115135
```yaml
116136
Type: String[]

0 commit comments

Comments
 (0)