Skip to content

Commit 98fa8e6

Browse files
authored
Merge pull request #11741 from cabailey/cabailey-m365powershell-advancedsettingspage2
add advanced settings page to TOC, add OfficeContentExtractionTimeout, update links
2 parents 8848a45 + 24cebfa commit 98fa8e6

File tree

6 files changed

+30
-5
lines changed

6 files changed

+30
-5
lines changed

exchange/docs-conceptual/client-advanced-settings.md

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: PowerShell advanced settings for Microsoft Purview Information Protection
33
ms.author: yangczhang
44
author: zhang-yangchen
55
manager: aashishr
6-
ms.date: 04/15/2024
6+
ms.date: 04/17/2024
77
ms.audience: Admin
88
audience: Admin
99
ms.topic: article
@@ -42,6 +42,7 @@ The advanced settings that are supported by sensitivity labels built into Micros
4242
|[EnableGlobalization](#enableglobalization) |Turn on classification globalization features|
4343
|[JustificationTextForUserText](#justificationtextforusertext) |Customize justification prompt texts for modified labels|
4444
|[LogMatchedContent](#logmatchedcontent)|Send information type matches to Microsoft Purview|
45+
|[OfficeContentExtractionTimeout](#officecontentextractiontimeout)|Configure the auto-labeling timeout for Office files|
4546
|[PFileSupportedExtensions](#pfilesupportedextensions)|Change which file types to protect|
4647
|[ReportAnIssueLink](#reportanissuelink) |Add "Report an Issue" for users|
4748
|[ScannerMaxCPU](#scannermaxcpu) |Limit CPU consumption|
@@ -237,6 +238,27 @@ Example PowerShell command, where your label policy is named "Global":
237238
Set-LabelPolicy -Identity Global -AdvancedSettings @{LogMatchedContent="True"}
238239
```
239240

241+
## OfficeContentExtractionTimeout
242+
243+
By default, the scanner's auto-labeling timeout on Office files is 3 seconds.
244+
245+
If you have a complex Excel file with many sheets or rows, 3 seconds might not be enough to automatically apply labels. To increase this timeout for the selected label policy, specify the following strings:
246+
247+
- Key: **OfficeContentExtractionTimeout**
248+
249+
- Value: Seconds, in the following format: `hh:mm:ss`.
250+
251+
> [!IMPORTANT]
252+
> We recommend that you don't raise this timeout to higher than 15 seconds.
253+
254+
Example PowerShell command, where your label policy is named "Global":
255+
256+
```PowerShell
257+
Set-LabelPolicy -Identity Global -AdvancedSettings @{OfficeContentExtractionTimeout="00:00:15"}
258+
```
259+
260+
The updated timeout applies to auto-labeling on all Office files.
261+
240262
## PFileSupportedExtensions
241263

242264
With this setting, you can change which file types are encrypted but you cannot change the default encryption level from native to generic. For example, for users running the file labeler, you can change the default setting so that only Office files and PDF files are encrypted instead of all file types. But you cannot change these file types to be generically encrypted with a .pfile file name extension.
@@ -284,6 +306,7 @@ Example PowerShell command, where your label policy is named "Global":
284306
Set-LabelPolicy -Identity Global -AdvancedSettings @{ReportAnIssueLink="mailto:[email protected]"}
285307
```
286308

309+
287310
## ScannerMaxCPU
288311

289312
> [!IMPORTANT]

exchange/docs-conceptual/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,8 @@
6868
href: app-only-auth-powershell-v2.md
6969
- name: Exchange cmdlet syntax
7070
href: exchange-cmdlet-syntax.md
71+
- name: Information protection client advanced settings
72+
href: client-advanced-settings.md
7173
- name: What's new in the Exchange Online PowerShell module
7274
href: whats-new-in-the-exo-module.md
7375
- name: Exchange Online Protection PowerShell

exchange/exchange-ps/exchange/New-Label.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -167,7 +167,7 @@ The AdvancedSettings parameter enables specific features and capabilities for a
167167
168168
Specify this parameter with the identity (name or GUID) of the sensitivity label, with key/value pairs in a [hash table](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_hash_tables). To remove an advanced setting, use the same AdvancedSettings parameter syntax, but specify a null string value.
169169
170-
Some of the settings that you configure with this parameter are supported only by the Azure Information Protection unified labeling client and not by Office apps and services that support built-in labeling. For a list of these and instructions, see [Custom configurations for the Azure Information Protection unified labeling client](https://learn.microsoft.com/azure/information-protection/rms-client/clientv2-admin-guide-customizations).
170+
Some of the settings that you configure with this parameter are supported only by the Microsoft Purview Information Protection client and not by Office apps and services that support built-in labeling. For a list of these, see [Advanced settings for Microsoft Purview Information Protection client](https://learn.microsoft.com/powershell/exchange/client-advanced-settings).
171171
172172
Supported settings for built-in labeling:
173173

exchange/exchange-ps/exchange/New-LabelPolicy.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,7 @@ The AdvancedSettings parameter enables client-specific features and capabilities
102102

103103
Specify this parameter with the identity (name or GUID) of the policy, with key/value pairs in a [hash table](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_hash_tables). To remove an advanced setting, use the same AdvancedSettings parameter syntax, but specify a null string value.
104104

105-
Some of the settings that you configure with this parameter are supported only by the Azure Information Protection unified labeling client and not by Office apps that support built-in labeling. For instructions, see [Custom configurations for the Azure Information Protection unified labeling client](https://learn.microsoft.com/azure/information-protection/rms-client/clientv2-admin-guide-customizations).
105+
Some of the settings that you configure with this parameter are supported only by the Microsoft Purview Information Protection client and not by Office apps and services that support built-in labeling. For a list of these, see [Advanced settings for Microsoft Purview Information Protection client](https://learn.microsoft.com/powershell/exchange/client-advanced-settings).
106106

107107
Supported settings for built-in labeling:
108108

exchange/exchange-ps/exchange/Set-Label.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -147,7 +147,7 @@ The AdvancedSettings parameter enables specific features and capabilities for a
147147
148148
Specify this parameter with the identity (name or GUID) of the sensitivity label, with key/value pairs in a [hash table](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_hash_tables). To remove an advanced setting, use the same AdvancedSettings parameter syntax, but specify a null string value.
149149
150-
Some of the settings that you configure with this parameter are supported only by the Azure Information Protection unified labeling client and not by Office apps and services that support built-in labeling. For a list of these and instructions, see [Custom configurations for the Azure Information Protection unified labeling client](https://learn.microsoft.com/azure/information-protection/rms-client/clientv2-admin-guide-customizations).
150+
Some of the settings that you configure with this parameter are supported only by the Microsoft Purview Information Protection client and not by Office apps and services that support built-in labeling. For a list of these, see [Advanced settings for Microsoft Purview Information Protection client](https://learn.microsoft.com/powershell/exchange/client-advanced-settings).
151151
152152
Supported settings for built-in labeling:
153153

exchange/exchange-ps/exchange/Set-LabelPolicy.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -366,7 +366,7 @@ The AdvancedSettings parameter enables client-specific features and capabilities
366366

367367
Specify this parameter with the identity (name or GUID) of the policy, with key/value pairs in a [hash table](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_hash_tables). To remove an advanced setting, use the same AdvancedSettings parameter syntax, but specify a null string value.
368368

369-
Most of the settings that you configure with this parameter are supported only by the Azure Information Protection unified labeling client and not by Office apps that support built-in labeling. For instructions, see [Custom configurations for the Azure Information Protection unified labeling client](https://learn.microsoft.com/azure/information-protection/rms-client/clientv2-admin-guide-customizations).
369+
Some of the settings that you configure with this parameter are supported only by the Microsoft Purview Information Protection client and not by Office apps and services that support built-in labeling. For a list of these, see [Advanced settings for Microsoft Purview Information Protection client](https://learn.microsoft.com/powershell/exchange/client-advanced-settings).
370370

371371
Supported settings for built-in labeling:
372372

0 commit comments

Comments
 (0)