Skip to content

Commit bfe3ff8

Browse files
Merge pull request #12561 from MicrosoftDocs/main
Publish main to live, 03/03, 11:00 AM IST
2 parents 64c02df + df03058 commit bfe3ff8

6 files changed

+41
-9
lines changed

exchange/exchange-ps/exchange/Get-AuthenticationPolicy.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -81,10 +81,13 @@ The AllowLegacyExchangeTokens switch specifies whether legacy Exchange tokens ar
8181
8282
Legacy Exchange tokens include Exchange user identity and callback tokens.
8383
84+
This switch also specifies a date and time sometime within the past seven days when an add-in was either allowed or blocked from acquiring a token.
85+
8486
**Important**:
8587
86-
- Currently, the AllowLegacyExchangeTokens switch only specifies whether legacy Exchange tokens are allowed in your organization. For now, disregard the empty Allowed and Blocked arrays returned by the switch.
87-
- Legacy Exchange tokens will eventually be blocked by default in all cloud-based organizations. For more information, see [Nested app authentication and Outlook legacy tokens deprecation FAQ](https://learn.microsoft.com/office/dev/add-ins/outlook/faq-nested-app-auth-outlook-legacy-tokens#what-is-the-timeline-for-shutting-down-legacy-exchange-online-tokens).
88+
- An update is being deployed to enable the AllowLegacyExchangeTokens switch to specify any add-in that requested an Exchange token from the last seven days. For more information, see [Get the status of legacy Exchange Online tokens and add-ins that use them](https://learn.microsoft.com/office/dev/add-ins/outlook/turn-exchange-tokens-on-off#get-the-status-of-legacy-exchange-online-tokens-and-add-ins-that-use-them).
89+
- The AllowLegacyExchangeTokens switch returns `Not Set` if tokens haven't been explicitly allowed or blocked in your organization using the _AllowLegacyExchangeTokens_ or _BlockLegacyExchangeTokens_ parameters on the **Set-AuthenticationPolicy** cmdlet. For more information, see [Get the status of legacy Exchange Online tokens and add-ins that use them](https://learn.microsoft.com/office/dev/add-ins/outlook/turn-exchange-tokens-on-off#get-the-status-of-legacy-exchange-online-tokens-and-add-ins-that-use-them).
90+
- As of February 17 2025, legacy Exchange tokens are blocked by default in all cloud-based organizations. Although tokens are blocked by default, the AllowLegacyExchangeTokens switch still returns `Not Set` if you haven't used the _AllowLegacyExchangeTokens_ or _BlockLegacyExchangeTokens_ parameters on the **Set-AuthenticationPolicy** cmdlet. For more information, see [Nested app authentication and Outlook legacy tokens deprecation FAQ](https://learn.microsoft.com/office/dev/add-ins/outlook/faq-nested-app-auth-outlook-legacy-tokens#what-is-the-timeline-for-shutting-down-legacy-exchange-online-tokens).
8891

8992
```yaml
9093
Type: SwitchParameter

exchange/exchange-ps/exchange/Remove-AuthenticationPolicy.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ This switch applies to the entire organization. The Identity parameter is requir
8484
- Apart from the Identity parameter, this switch disregards other authentication policy parameters used in the same command. We recommend running separate commands for other authentication policy changes.
8585
- It might take up to 24 hours for the change to take effect across your entire organization.
8686
- Legacy Exchange tokens issued to Outlook add-ins before token blocking was implemented in your organization will remain valid until they expire.
87-
- Legacy Exchange tokens will eventually be blocked by default in all cloud-based organizations. For more information, see [Nested app authentication and Outlook legacy tokens deprecation FAQ](https://learn.microsoft.com/office/dev/add-ins/outlook/faq-nested-app-auth-outlook-legacy-tokens#what-is-the-timeline-for-shutting-down-legacy-exchange-online-tokens).
87+
- As of February 17 2025, legacy Exchange tokens are blocked by default in all cloud-based organizations. For more information, see [Nested app authentication and Outlook legacy tokens deprecation FAQ](https://learn.microsoft.com/office/dev/add-ins/outlook/faq-nested-app-auth-outlook-legacy-tokens#what-is-the-timeline-for-shutting-down-legacy-exchange-online-tokens).
8888
8989
```yaml
9090
Type: SwitchParameter

exchange/exchange-ps/exchange/Set-ArcConfig.md

Lines changed: 25 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -73,6 +73,27 @@ The first four commands return the existing list of ARC sealers. The first ARC s
7373

7474
The last two commands remove the seventh ARC sealer that's displayed in the list.
7575

76+
### Example 4
77+
```powershell
78+
$arcSealer = 'fabrikam.com'
79+
$x = @(Get-ArcConfig | Select-Object -Expand ArcTrustedSealers)
80+
81+
$y = @($x.Split(","))
82+
$DomainsRemove = [System.Collections.ArrayList]($y)
83+
$DomainsRemove.Remove($arcSealer)
84+
85+
if ($DomainsToRemove.Count -eq 0) {
86+
Set-ArcConfig -Identity Default -ArcTrustedSealers " "
87+
}
88+
else {
89+
Set-ArcConfig -Identity Default -ArcTrustedSealers $DomainsRemove
90+
}
91+
```
92+
93+
This example removes the specified ARC sealer from the list (`$arcSealer`).
94+
95+
If no other ARC sealers exist after removing this entry from the list, using the value `" "` for the ArcTrustedSealers parameter avoids a bind argument error if the `$DomainsToRemove` value is empty.
96+
7697
## PARAMETERS
7798

7899
### -Identity
@@ -99,9 +120,11 @@ The ArcTrustedSealers parameter specifies the domain name of the ARC sealers tha
99120
100121
The domain name must match the domain that's shown in the `d` tag in the **ARC-Seal** and **ARC-Message-Signature** headers in affected email messages (for example, fabrikam.com). You can use Outlook to see these headers.
101122

102-
To replace the existing list of ARC sealers with the values you specify, use the syntax `Domain1,Domain2,...DomainN`. To preserve existing values, be sure to include the file types that you want to keep along with the new values that you want to add.
123+
To replace the existing list of ARC sealers with the values you specify, use the syntax `Domain1,Domain2,...DomainN`. To preserve existing values, be sure to include the entries that you want to keep along with the new values that you want to add.
124+
125+
To add or remove values without affecting the other entries, see the Examples section in this article.
103126

104-
To add or remove file types without affecting the other file type entries, see the Examples section in this topic.
127+
To empty the list, use the value `" "` (a space enclosed in double quotation marks).
105128

106129
```yaml
107130
Type: String[]

exchange/exchange-ps/exchange/Set-AuthenticationPolicy.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -371,7 +371,7 @@ The switch applies to the entire organization. The Identity parameter is require
371371

372372
- Apart from the Identity parameter, this switch disregards other authentication policy parameters used in the same command. We recommend running separate commands for other authentication policy changes.
373373
- It might take up to 24 hours for the change to take effect across your entire organization.
374-
- Legacy Exchange tokens will eventually be blocked by default in all cloud-based organizations. For more information, see [Nested app authentication and Outlook legacy tokens deprecation FAQ](https://learn.microsoft.com/office/dev/add-ins/outlook/faq-nested-app-auth-outlook-legacy-tokens#what-is-the-timeline-for-shutting-down-legacy-exchange-online-tokens).
374+
- As of February 17 2025, legacy Exchange tokens are blocked by default in all cloud-based organizations. For more information, see [Nested app authentication and Outlook legacy tokens deprecation FAQ](https://learn.microsoft.com/office/dev/add-ins/outlook/faq-nested-app-auth-outlook-legacy-tokens#what-is-the-timeline-for-shutting-down-legacy-exchange-online-tokens).
375375

376376
```yaml
377377
Type: SwitchParameter
@@ -569,7 +569,7 @@ The switch applies to the entire organization. The Identity parameter is require
569569
- It might take up to 24 hours for the change to take effect across your entire organization.
570570
- Legacy Exchange tokens issued to Outlook add-ins before token blocking was implemented in your organization will remain valid until they expire.
571571
- Blocking legacy Exchange tokens might cause some Microsoft add-ins to stop working. These add-ins are being updated to no longer use legacy tokens.
572-
- Legacy Exchange tokens will eventually be blocked by default in all cloud-based organizations. For more information, see [Nested app authentication and Outlook legacy tokens deprecation FAQ](https://learn.microsoft.com/office/dev/add-ins/outlook/faq-nested-app-auth-outlook-legacy-tokens#what-is-the-timeline-for-shutting-down-legacy-exchange-online-tokens).
572+
- As of February 17 2025, legacy Exchange tokens are blocked by default in all cloud-based organizations. For more information, see [Nested app authentication and Outlook legacy tokens deprecation FAQ](https://learn.microsoft.com/office/dev/add-ins/outlook/faq-nested-app-auth-outlook-legacy-tokens#what-is-the-timeline-for-shutting-down-legacy-exchange-online-tokens).
573573

574574
```yaml
575575
Type: SwitchParameter

exchange/exchange-ps/exchange/Set-ExternalInOutlook.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,11 @@ This example adds and removes the specified email addresses from the exception l
5858
## PARAMETERS
5959

6060
### -Identity
61-
The Identity parameter specifies the GUID of the external sender identification object that you want to modify. Although this parameter is available, you don't need to use it.
61+
The Identity parameter specifies the GUID of the external sender identification object that you want to modify.
62+
63+
This parameter is optional and typically isn't needed, because the organization's GUID resolves automatically when you use this cmdlet.
64+
65+
If you specify an invalid Identity value, the cmdlet still runs and changes the settings for the entire organization. Always verify the Identity value before you run this cmdlet.
6266

6367
```yaml
6468
Type: OrganizationIdParameter

exchange/exchange-ps/exchange/Start-ManagedFolderAssistant.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -184,7 +184,9 @@ Accept wildcard characters: False
184184
```
185185
186186
### -AggMailboxCleanup
187-
The AggMailboxCleanup switch specifies a more aggressive processing cycle if items aren't moving as quickly as they should. You don't need to specify a value with this switch.
187+
The AggMailboxCleanup switch specifies aggregate mailbox cleanup. You don't need to specify a value with this switch.
188+
189+
This switch cleans up aggregate mailboxes, audits, and calendar logging.
188190
189191
```yaml
190192
Type: SwitchParameter

0 commit comments

Comments
 (0)