From 45aecc1257048967be3fe8142e0cf34a0a9c61a1 Mon Sep 17 00:00:00 2001 From: Victor Legat Date: Wed, 26 Feb 2025 10:01:31 +0200 Subject: [PATCH 01/18] Update Set-RetentionCompliancePolicy.md adding examples for excluding deleted mailbox from Teams policy --- .../exchange/Set-RetentionCompliancePolicy.md | 30 +++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md b/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md index b97520fc0b..1aaa0c913d 100644 --- a/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md +++ b/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md @@ -180,6 +180,36 @@ Set-RetentionCompliancePolicy -Identity "Sales Policy" -RemoveModernGroupLocatio This example is similar to Example 2, except multiple deleted resources are specified. +### Example 5 +```powershell +$stringJson = @" +[{ + 'EmailAddress': 'SalesUser@contoso.onmicrosoft.com' +}] +"@ + +Set-RetentionCompliancePolicy -Identity "Teams Chat Retention Policy" -AddTeamsChatLocationException "SalesUser@contoso.onmicrosoft.com" -DeletedResources $stringJson +``` + +The example excludes the specified deleted soft-deleted mailbox/mailuser from the mentioned Teams Retention Policy. You identify the deleted resources using the mailbox/mailuser email address. +Policy exclusions must ensure that locations remain within the established limits: [Limits for Microsoft 365 retention policies and retention label policies | Microsoft Learn](https://learn.microsoft.com/purview/retention-limits#maximum-number-of-items-per-policy) + +### Example 6 +```powershell +$stringJson = @" +[{ + 'EmailAddress': 'SalesUser1@contoso.onmicrosoft.com' +}, +{ + 'EmailAddress': 'SalesUser2@contoso.onmicrosoft.com' +}] +"@ + +Set-RetentionCompliancePolicy -Identity "Teams Chat Retention Policy" -AddTeamsChatLocationException "SalesUser1@contoso.onmicrosoft.com", "SalesUser2@contoso.onmicrosoft.com" -DeletedResources $stringJson +``` + +This example is similar to Example 5, except multiple deleted resources are specified. + ## PARAMETERS ### -Identity From c16a2285555406564d38e9b474e1ff98fb1346e3 Mon Sep 17 00:00:00 2001 From: Victor Legat Date: Wed, 26 Feb 2025 11:19:24 +0200 Subject: [PATCH 02/18] Update DeletedResources parameter details and examples --- .../exchange-ps/exchange/Set-RetentionCompliancePolicy.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md b/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md index 1aaa0c913d..914c76bed1 100644 --- a/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md +++ b/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md @@ -659,11 +659,12 @@ Accept wildcard characters: False ``` ### -DeletedResources -The DeletedResources parameter specifies the Sharepoint sites to be removed from the list of included sites or excluded from a tenant level policy when the associated group has been deleted. You use this parameter with the AddModernGroupLocationException and RemoveModernGroupLocation parameters. +The DeletedResources parameter specifies the deleted Microsoft 365 group, mailbox, or mail user to be removed or added as an exclusion to the respective location list. Use this parameter with the AddModernGroupLocationException and RemoveModernGroupLocation parameters for deleted Microsoft 365 groups, or with the AddTeamsChatLocationException parameter for deleted mailboxes or mail users. -A valid value is a JSON String. See the Examples section for syntax and examples using this parameter. +A valid value is a JSON string. Refer to the Examples section for syntax and usage examples of this parameter. -For more information about this scenario, see [Learn more about modern group deletion under retention hold](https://learn.microsoft.com/purview/retention-settings#what-happens-if-a-microsoft-365-group-is-deleted-after-a-policy-is-applied). +For more details on the deleted Microsoft 365 group scenario, please refer to the following section [Learn more about modern group deletion under retention hold](https://learn.microsoft.com/purview/retention-settings#what-happens-if-a-microsoft-365-group-is-deleted-after-a-policy-is-applied). +For more details on the inactive mailbox scenario, please refer to the following article [Learn about inactive mailboxes](https://learn.microsoft.com/en-us/purview/inactive-mailboxes-in-office-365). ```yaml Type: String From a2830c82e515c499ad8c5038584149000a20f57a Mon Sep 17 00:00:00 2001 From: Victor Legat Date: Wed, 26 Feb 2025 11:20:39 +0200 Subject: [PATCH 03/18] Fix broken link in documentation --- exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md b/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md index 914c76bed1..7975ea1f7f 100644 --- a/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md +++ b/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md @@ -664,7 +664,7 @@ The DeletedResources parameter specifies the deleted Microsoft 365 group, mailbo A valid value is a JSON string. Refer to the Examples section for syntax and usage examples of this parameter. For more details on the deleted Microsoft 365 group scenario, please refer to the following section [Learn more about modern group deletion under retention hold](https://learn.microsoft.com/purview/retention-settings#what-happens-if-a-microsoft-365-group-is-deleted-after-a-policy-is-applied). -For more details on the inactive mailbox scenario, please refer to the following article [Learn about inactive mailboxes](https://learn.microsoft.com/en-us/purview/inactive-mailboxes-in-office-365). +For more details on the inactive mailbox scenario, please refer to the following article [Learn about inactive mailboxes](https://learn.microsoft.com/purview/inactive-mailboxes-in-office-365). ```yaml Type: String From 0475f3ba79a8f00d0945ff7c0e299324a470fb73 Mon Sep 17 00:00:00 2001 From: Victor Legat Date: Wed, 26 Feb 2025 11:30:16 +0200 Subject: [PATCH 04/18] Clarify policy exclusion example description --- exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md b/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md index 7975ea1f7f..cf7bcc7b51 100644 --- a/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md +++ b/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md @@ -191,7 +191,7 @@ $stringJson = @" Set-RetentionCompliancePolicy -Identity "Teams Chat Retention Policy" -AddTeamsChatLocationException "SalesUser@contoso.onmicrosoft.com" -DeletedResources $stringJson ``` -The example excludes the specified deleted soft-deleted mailbox/mailuser from the mentioned Teams Retention Policy. You identify the deleted resources using the mailbox/mailuser email address. +This example excludes the specified deleted or soft-deleted mailbox or mail user from the mentioned Teams Retention Policy. You can identify the deleted resources using the mailbox or mail user's email address. Policy exclusions must ensure that locations remain within the established limits: [Limits for Microsoft 365 retention policies and retention label policies | Microsoft Learn](https://learn.microsoft.com/purview/retention-limits#maximum-number-of-items-per-policy) ### Example 6 From 90db49edb9962df465955e911c964f9910f31588 Mon Sep 17 00:00:00 2001 From: Victor Legat Date: Wed, 26 Feb 2025 11:31:04 +0200 Subject: [PATCH 05/18] Clarify exclusion of soft-deleted mailboxes --- exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md b/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md index cf7bcc7b51..d063b9fb2e 100644 --- a/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md +++ b/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md @@ -191,7 +191,7 @@ $stringJson = @" Set-RetentionCompliancePolicy -Identity "Teams Chat Retention Policy" -AddTeamsChatLocationException "SalesUser@contoso.onmicrosoft.com" -DeletedResources $stringJson ``` -This example excludes the specified deleted or soft-deleted mailbox or mail user from the mentioned Teams Retention Policy. You can identify the deleted resources using the mailbox or mail user's email address. +This example excludes the specified soft-deleted mailbox or mail user from the mentioned Teams Retention Policy. You can identify the deleted resources using the mailbox or mail user's email address. Policy exclusions must ensure that locations remain within the established limits: [Limits for Microsoft 365 retention policies and retention label policies | Microsoft Learn](https://learn.microsoft.com/purview/retention-limits#maximum-number-of-items-per-policy) ### Example 6 From 9ed1bcc77f708ff3324b0864844f395b15360096 Mon Sep 17 00:00:00 2001 From: Victor Legat Date: Wed, 26 Feb 2025 16:21:03 +0200 Subject: [PATCH 06/18] Update Set-AppRetentionCompliancePolicy.md to include deletedresources parameter --- .../Set-AppRetentionCompliancePolicy.md | 33 ++++++++++++++++++- 1 file changed, 32 insertions(+), 1 deletion(-) diff --git a/exchange/exchange-ps/exchange/Set-AppRetentionCompliancePolicy.md b/exchange/exchange-ps/exchange/Set-AppRetentionCompliancePolicy.md index f3e8af0e26..12215b22cc 100644 --- a/exchange/exchange-ps/exchange/Set-AppRetentionCompliancePolicy.md +++ b/exchange/exchange-ps/exchange/Set-AppRetentionCompliancePolicy.md @@ -119,6 +119,34 @@ Set-AppRetentionCompliancePolicy -Identity "Regulation 563 Marketing" -Applicati This example adds a new user to the existing static scope retention policy named Regulation 563 Marketing that's set up for Teams private channels messages. +### Example 2 +```powershell +$stringJson = @" +[{ + 'EmailAddress': 'SalesUser@contoso.onmicrosoft.com' +}] +"@ +Set-AppRetentionCompliancePolicy -Identity "Teams Private Chat Retention Policy" -AddExchangeLocationException "SalesUser@contoso.onmicrosoft.com" -DeletedResources $stringJson +``` + +This example excludes the specified soft-deleted mailbox or mail user from the mentioned Teams Private Chat Retention Policy. You can identify the deleted resources using the mailbox or mail user's email address. +Policy exclusions must ensure that locations remain within the established limits: [Limits for Microsoft 365 retention policies and retention label policies](https://learn.microsoft.com/purview/retention-limits#maximum-number-of-items-per-policy). + +### Example 3 +```powershell +$stringJson = @" +[{ + 'EmailAddress': 'SalesUser1@contoso.onmicrosoft.com' +}, +{ + 'EmailAddress': 'SalesUser2@contoso.onmicrosoft.com' +}] +"@ +Set-AppRetentionCompliancePolicy -Identity "Teams Private Chat Retention Policy" -AddExchangeLocationException "SalesUser1@contoso.onmicrosoft.com", "SalesUser2@contoso.onmicrosoft.com" -DeletedResources $stringJson +``` + +This example is similar to Example 2, except multiple deleted resources are specified. + ## PARAMETERS ### -Identity @@ -347,7 +375,10 @@ Accept wildcard characters: False ``` ### -DeletedResources -{{ Fill DeletedResources Description }} +The DeletedResources parameter specifies the deleted mailbox, or mail user to be removed or added as an exclusion to the respective location list. Use this parameter with the AddTeamsChatLocationException parameter for deleted mailboxes or mail users that needs to be excluded from Teams only retention policy. + +A valid value is a JSON string. Refer to the Examples section for syntax and usage examples of this parameter. +For more details on the inactive mailbox scenario, please refer to the following article [Learn about inactive mailboxes](https://learn.microsoft.com/purview/inactive-mailboxes-in-office-365). ```yaml Type: String From ca61d3b5f375cba7efd3693b134012d5444aa778 Mon Sep 17 00:00:00 2001 From: Victor Legat Date: Wed, 26 Feb 2025 16:22:49 +0200 Subject: [PATCH 07/18] Update link format in documentation --- exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md b/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md index d063b9fb2e..e37a523b09 100644 --- a/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md +++ b/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md @@ -192,7 +192,7 @@ Set-RetentionCompliancePolicy -Identity "Teams Chat Retention Policy" -AddTeamsC ``` This example excludes the specified soft-deleted mailbox or mail user from the mentioned Teams Retention Policy. You can identify the deleted resources using the mailbox or mail user's email address. -Policy exclusions must ensure that locations remain within the established limits: [Limits for Microsoft 365 retention policies and retention label policies | Microsoft Learn](https://learn.microsoft.com/purview/retention-limits#maximum-number-of-items-per-policy) +Policy exclusions must ensure that locations remain within the established limits: [Limits for Microsoft 365 retention policies and retention label policies](https://learn.microsoft.com/purview/retention-limits#maximum-number-of-items-per-policy) ### Example 6 ```powershell From 9a130bda7957badc184af0d3a03b3d4761bcf8a8 Mon Sep 17 00:00:00 2001 From: Victor Legat Date: Wed, 26 Feb 2025 16:26:57 +0200 Subject: [PATCH 08/18] Clarify DeletedResources parameter description --- .../exchange-ps/exchange/Set-AppRetentionCompliancePolicy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/exchange/exchange-ps/exchange/Set-AppRetentionCompliancePolicy.md b/exchange/exchange-ps/exchange/Set-AppRetentionCompliancePolicy.md index 12215b22cc..fce94ece09 100644 --- a/exchange/exchange-ps/exchange/Set-AppRetentionCompliancePolicy.md +++ b/exchange/exchange-ps/exchange/Set-AppRetentionCompliancePolicy.md @@ -375,7 +375,7 @@ Accept wildcard characters: False ``` ### -DeletedResources -The DeletedResources parameter specifies the deleted mailbox, or mail user to be removed or added as an exclusion to the respective location list. Use this parameter with the AddTeamsChatLocationException parameter for deleted mailboxes or mail users that needs to be excluded from Teams only retention policy. +The DeletedResources parameter specifies the deleted mailbox, or mail user to be added as an exclusion to the respective location list. Use this parameter with the AddTeamsChatLocationException parameter for deleted mailboxes or mail users that needs to be excluded from Teams only retention policy. A valid value is a JSON string. Refer to the Examples section for syntax and usage examples of this parameter. For more details on the inactive mailbox scenario, please refer to the following article [Learn about inactive mailboxes](https://learn.microsoft.com/purview/inactive-mailboxes-in-office-365). From 8c3c35fb0484a9e1592302f633647c082ac4b853 Mon Sep 17 00:00:00 2001 From: Chris Davis Date: Wed, 26 Feb 2025 07:44:33 -0800 Subject: [PATCH 09/18] Fix capitalization and formatting in documentation --- .../exchange-ps/exchange/Set-RetentionCompliancePolicy.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md b/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md index e37a523b09..55b36d07a8 100644 --- a/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md +++ b/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md @@ -659,12 +659,13 @@ Accept wildcard characters: False ``` ### -DeletedResources -The DeletedResources parameter specifies the deleted Microsoft 365 group, mailbox, or mail user to be removed or added as an exclusion to the respective location list. Use this parameter with the AddModernGroupLocationException and RemoveModernGroupLocation parameters for deleted Microsoft 365 groups, or with the AddTeamsChatLocationException parameter for deleted mailboxes or mail users. +The DeletedResources parameter specifies the deleted Microsoft 365 Group, mailbox, or mail user to be removed or added as an exclusion to the respective location list. Use this parameter with the AddModernGroupLocationException and RemoveModernGroupLocation parameters for deleted Microsoft 365 Groups, or with the AddTeamsChatLocationException parameter for deleted mailboxes or mail users. A valid value is a JSON string. Refer to the Examples section for syntax and usage examples of this parameter. -For more details on the deleted Microsoft 365 group scenario, please refer to the following section [Learn more about modern group deletion under retention hold](https://learn.microsoft.com/purview/retention-settings#what-happens-if-a-microsoft-365-group-is-deleted-after-a-policy-is-applied). -For more details on the inactive mailbox scenario, please refer to the following article [Learn about inactive mailboxes](https://learn.microsoft.com/purview/inactive-mailboxes-in-office-365). +For more details on the deleted Microsoft 365 Group scenario, see [Learn more about modern group deletion under retention hold](https://learn.microsoft.com/purview/retention-settings#what-happens-if-a-microsoft-365-group-is-deleted-after-a-policy-is-applied). + +For more details on the inactive mailbox scenario, see article [Learn about inactive mailboxes](https://learn.microsoft.com/purview/inactive-mailboxes-in-office-365). ```yaml Type: String From 2829863cf561dbb701198c7e7272636a91754c34 Mon Sep 17 00:00:00 2001 From: Chris Davis Date: Wed, 26 Feb 2025 07:45:57 -0800 Subject: [PATCH 10/18] Update wording for clarity in documentation --- .../exchange-ps/exchange/Set-RetentionCompliancePolicy.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md b/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md index 55b36d07a8..a104341311 100644 --- a/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md +++ b/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md @@ -663,9 +663,9 @@ The DeletedResources parameter specifies the deleted Microsoft 365 Group, mailbo A valid value is a JSON string. Refer to the Examples section for syntax and usage examples of this parameter. -For more details on the deleted Microsoft 365 Group scenario, see [Learn more about modern group deletion under retention hold](https://learn.microsoft.com/purview/retention-settings#what-happens-if-a-microsoft-365-group-is-deleted-after-a-policy-is-applied). +For more information on the deleted Microsoft 365 Group scenario, see [Learn more about modern group deletion under retention hold](https://learn.microsoft.com/purview/retention-settings#what-happens-if-a-microsoft-365-group-is-deleted-after-a-policy-is-applied). -For more details on the inactive mailbox scenario, see article [Learn about inactive mailboxes](https://learn.microsoft.com/purview/inactive-mailboxes-in-office-365). +For more information on the inactive mailbox scenario, see [Learn about inactive mailboxes](https://learn.microsoft.com/purview/inactive-mailboxes-in-office-365). ```yaml Type: String From ed068f9d242c95684a99ea2a6926c65e6613fd07 Mon Sep 17 00:00:00 2001 From: Chris Davis Date: Wed, 26 Feb 2025 07:51:58 -0800 Subject: [PATCH 11/18] Update documentation for policy exclusions and parameters --- .../exchange/Set-AppRetentionCompliancePolicy.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/exchange/exchange-ps/exchange/Set-AppRetentionCompliancePolicy.md b/exchange/exchange-ps/exchange/Set-AppRetentionCompliancePolicy.md index fce94ece09..e44d605edd 100644 --- a/exchange/exchange-ps/exchange/Set-AppRetentionCompliancePolicy.md +++ b/exchange/exchange-ps/exchange/Set-AppRetentionCompliancePolicy.md @@ -130,7 +130,8 @@ Set-AppRetentionCompliancePolicy -Identity "Teams Private Chat Retention Policy" ``` This example excludes the specified soft-deleted mailbox or mail user from the mentioned Teams Private Chat Retention Policy. You can identify the deleted resources using the mailbox or mail user's email address. -Policy exclusions must ensure that locations remain within the established limits: [Limits for Microsoft 365 retention policies and retention label policies](https://learn.microsoft.com/purview/retention-limits#maximum-number-of-items-per-policy). + +Policy exclusions must ensure that locations remain within the established limits. For more information, see [Limits for Microsoft 365 retention policies and retention label policies](https://learn.microsoft.com/purview/retention-limits#maximum-number-of-items-per-policy). ### Example 3 ```powershell @@ -375,10 +376,11 @@ Accept wildcard characters: False ``` ### -DeletedResources -The DeletedResources parameter specifies the deleted mailbox, or mail user to be added as an exclusion to the respective location list. Use this parameter with the AddTeamsChatLocationException parameter for deleted mailboxes or mail users that needs to be excluded from Teams only retention policy. +The DeletedResources parameter specifies the deleted mailbox or mail user to add as an exclusion to the respective location list. Use this parameter with the AddTeamsChatLocationException parameter for deleted mailboxes or mail users that needs to be excluded from a Teams only retention policy. A valid value is a JSON string. Refer to the Examples section for syntax and usage examples of this parameter. -For more details on the inactive mailbox scenario, please refer to the following article [Learn about inactive mailboxes](https://learn.microsoft.com/purview/inactive-mailboxes-in-office-365). + +For information on the inactive mailbox scenario, see [Learn about inactive mailboxes](https://learn.microsoft.com/purview/inactive-mailboxes-in-office-365). ```yaml Type: String From 0cd991e72c53084d2896640824fe77edfaef41f6 Mon Sep 17 00:00:00 2001 From: SarinaMS Date: Wed, 26 Feb 2025 09:42:35 -0800 Subject: [PATCH 12/18] Update New-CsTeamsEventsPolicy.md --- .../teams-ps/teams/New-CsTeamsEventsPolicy.md | 22 +++++++++++++++++-- 1 file changed, 20 insertions(+), 2 deletions(-) diff --git a/teams/teams-ps/teams/New-CsTeamsEventsPolicy.md b/teams/teams-ps/teams/New-CsTeamsEventsPolicy.md index 66417ee5e3..cf780da337 100644 --- a/teams/teams-ps/teams/New-CsTeamsEventsPolicy.md +++ b/teams/teams-ps/teams/New-CsTeamsEventsPolicy.md @@ -4,7 +4,7 @@ Module Name: MicrosoftTeams online version: https://learn.microsoft.com/powershell/module/teams/new-csteamseventspolicy title: New-CsTeamsEventsPolicy schema: 2.0.0 -ms.date: 11/12/2024 +ms.date: 02/26/2025 --- # New-CsTeamsEventsPolicy @@ -16,7 +16,7 @@ This cmdlet allows you to create a new TeamsEventsPolicy instance and set its pr ```powershell New-CsTeamsEventsPolicy [-Identity] [-AllowWebinars ] [-AllowTownhalls ] [-AllowEmailEditing ] [-Description ] -[-RecordingForTownhall ] [-RecordingForWebinar ] +[-TownhallEventAttendeeAccess ] [-RecordingForTownhall ] [-RecordingForWebinar ] [-TranscriptionForTownhall ] [-TranscriptionForWebinar ] [-AllowEventIntegrations ] [-TownhallChatExperience ] [-UseMicrosoftECDN ] [-EventAccessType ] [-WhatIf] [-Confirm] [] [-ImmersiveEvents ] @@ -94,6 +94,24 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -TownhallEventAttendeeAccess +This setting governs what identity types may attend a Town hall that is scheduled by a particular person or group that is assigned this policy. +Possible values are: + - **Everyone**: Anyone with the join link may enter the event. + - **EveryoneInOrganizationAndGuests**: Only those who are Guests to the tenant, MTO users, and internal AAD users may enter the event. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: Enabled +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -AllowEmailEditing This setting governs if a user is allowed to edit the communication emails in Teams Town Hall or Teams Webinar events. Possible values are: From a72177c6901bab449b1d7177745901351f5a1fbd Mon Sep 17 00:00:00 2001 From: SarinaMS Date: Wed, 26 Feb 2025 09:47:38 -0800 Subject: [PATCH 13/18] Update Set-CsTeamsEventsPolicy.md --- .../teams-ps/teams/Set-CsTeamsEventsPolicy.md | 20 ++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/teams/teams-ps/teams/Set-CsTeamsEventsPolicy.md b/teams/teams-ps/teams/Set-CsTeamsEventsPolicy.md index d6e5e66d0d..d37ccc3ab1 100644 --- a/teams/teams-ps/teams/Set-CsTeamsEventsPolicy.md +++ b/teams/teams-ps/teams/Set-CsTeamsEventsPolicy.md @@ -16,7 +16,7 @@ This cmdlet allows you to configure options for customizing Teams events experie ``` Set-CsTeamsEventsPolicy [-AllowWebinars ] [-EventAccessType ] [-AllowTownhalls ] - [-AllowEmailEditing ] [-AllowedQuestionTypesInRegistrationForm ] + [-TownhallEventAttendeeAccess ] [-AllowEmailEditing ] [-AllowedQuestionTypesInRegistrationForm ] [-AllowEventIntegrations ] [-AllowedWebinarTypesForRecordingPublish ] [-AllowedTownhallTypesForRecordingPublish ] [-TownhallChatExperience ] [-Description ] [-RecordingForTownhall ] [-RecordingForWebinar ] @@ -106,6 +106,24 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -TownhallEventAttendeeAccess +This setting governs what identity types may attend a Town hall that is scheduled by a particular person or group that is assigned this policy. +Possible values are: + - **Everyone**: Anyone with the join link may enter the event. + - **EveryoneInOrganizationAndGuests**: Only those who are Guests to the tenant, MTO users, and internal AAD users may enter the event. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Description Enables administrators to provide explanatory text to accompany a Teams Events policy. From 27b42e71d5d15d144a735b79ba5a0b7fad32387c Mon Sep 17 00:00:00 2001 From: SarinaMS Date: Wed, 26 Feb 2025 09:50:48 -0800 Subject: [PATCH 14/18] Update Set-CsTeamsEventsPolicy.md --- teams/teams-ps/teams/Set-CsTeamsEventsPolicy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/teams/teams-ps/teams/Set-CsTeamsEventsPolicy.md b/teams/teams-ps/teams/Set-CsTeamsEventsPolicy.md index d37ccc3ab1..8729d35f29 100644 --- a/teams/teams-ps/teams/Set-CsTeamsEventsPolicy.md +++ b/teams/teams-ps/teams/Set-CsTeamsEventsPolicy.md @@ -4,7 +4,7 @@ Module Name: MicrosoftTeams online version: https://learn.microsoft.com/powershell/module/teams/set-csteamseventspolicy title: Set-CsTeamsEventsPolicy schema: 2.0.0 -ms.date: 11/12/2024 +ms.date: 02/26/2025 --- # Set-CsTeamsEventsPolicy From 8d450506b0a645868ae65d5962d40a37138a694c Mon Sep 17 00:00:00 2001 From: SarinaMS Date: Wed, 26 Feb 2025 09:59:04 -0800 Subject: [PATCH 15/18] Update New-CsTeamsEventsPolicy.md --- teams/teams-ps/teams/New-CsTeamsEventsPolicy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/teams/teams-ps/teams/New-CsTeamsEventsPolicy.md b/teams/teams-ps/teams/New-CsTeamsEventsPolicy.md index cf780da337..28e4dcb288 100644 --- a/teams/teams-ps/teams/New-CsTeamsEventsPolicy.md +++ b/teams/teams-ps/teams/New-CsTeamsEventsPolicy.md @@ -107,7 +107,7 @@ Aliases: Required: False Position: Named -Default value: Enabled +Default value: Everyone Accept pipeline input: False Accept wildcard characters: False ``` From f697dafb2dbb93a426ba7850c104759d96ea48ad Mon Sep 17 00:00:00 2001 From: SarinaMS Date: Wed, 26 Feb 2025 09:59:32 -0800 Subject: [PATCH 16/18] Update Set-CsTeamsEventsPolicy.md --- teams/teams-ps/teams/Set-CsTeamsEventsPolicy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/teams/teams-ps/teams/Set-CsTeamsEventsPolicy.md b/teams/teams-ps/teams/Set-CsTeamsEventsPolicy.md index 8729d35f29..310c9a75e8 100644 --- a/teams/teams-ps/teams/Set-CsTeamsEventsPolicy.md +++ b/teams/teams-ps/teams/Set-CsTeamsEventsPolicy.md @@ -119,7 +119,7 @@ Aliases: Required: False Position: Named -Default value: None +Default value: Everyone Accept pipeline input: False Accept wildcard characters: False ``` From 89958aa9311b20da6464a216a5b5c7a1fc6197a0 Mon Sep 17 00:00:00 2001 From: Victor Legat Date: Thu, 27 Feb 2025 00:19:02 +0200 Subject: [PATCH 17/18] Update retention policy example and documentation --- .../exchange/Set-AppRetentionCompliancePolicy.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/exchange/exchange-ps/exchange/Set-AppRetentionCompliancePolicy.md b/exchange/exchange-ps/exchange/Set-AppRetentionCompliancePolicy.md index e44d605edd..14c522329c 100644 --- a/exchange/exchange-ps/exchange/Set-AppRetentionCompliancePolicy.md +++ b/exchange/exchange-ps/exchange/Set-AppRetentionCompliancePolicy.md @@ -126,12 +126,11 @@ $stringJson = @" 'EmailAddress': 'SalesUser@contoso.onmicrosoft.com' }] "@ -Set-AppRetentionCompliancePolicy -Identity "Teams Private Chat Retention Policy" -AddExchangeLocationException "SalesUser@contoso.onmicrosoft.com" -DeletedResources $stringJson +Set-AppRetentionCompliancePolicy -Identity "Teams Private Channel Retention Policy" -AddExchangeLocationException "SalesUser@contoso.onmicrosoft.com" -DeletedResources $stringJson ``` +This example excludes the specified soft-deleted mailbox or mail user from the retention policy configured for Teams private channel messages. You can identify the deleted resources using the mailbox or mail user's email address. -This example excludes the specified soft-deleted mailbox or mail user from the mentioned Teams Private Chat Retention Policy. You can identify the deleted resources using the mailbox or mail user's email address. - -Policy exclusions must ensure that locations remain within the established limits. For more information, see [Limits for Microsoft 365 retention policies and retention label policies](https://learn.microsoft.com/purview/retention-limits#maximum-number-of-items-per-policy). +Policy exclusions must remain within the supported limits for retention policies. For more information, see [Limits for Microsoft 365 retention policies and retention label policies](https://learn.microsoft.com/purview/retention-limits#maximum-number-of-items-per-policy). ### Example 3 ```powershell From 79934f68cd618253d48e948183a165fcc93df0c4 Mon Sep 17 00:00:00 2001 From: Carol Bailey Date: Wed, 26 Feb 2025 14:53:15 -0800 Subject: [PATCH 18/18] Clarify wording for limits to match other cmdlet --- exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md b/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md index a104341311..ffd5884e75 100644 --- a/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md +++ b/exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md @@ -192,7 +192,7 @@ Set-RetentionCompliancePolicy -Identity "Teams Chat Retention Policy" -AddTeamsC ``` This example excludes the specified soft-deleted mailbox or mail user from the mentioned Teams Retention Policy. You can identify the deleted resources using the mailbox or mail user's email address. -Policy exclusions must ensure that locations remain within the established limits: [Limits for Microsoft 365 retention policies and retention label policies](https://learn.microsoft.com/purview/retention-limits#maximum-number-of-items-per-policy) +Policy exclusions must remain within the supported limits for retention policies: [Limits for Microsoft 365 retention policies and retention label policies](https://learn.microsoft.com/purview/retention-limits#maximum-number-of-items-per-policy) ### Example 6 ```powershell