Skip to content

Commit a69d706

Browse files
authored
Merge branch 'MicrosoftDocs:master' into UnassignedNumbers
2 parents 196fe15 + 8cd22b7 commit a69d706

File tree

1,734 files changed

+983
-257628
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

1,734 files changed

+983
-257628
lines changed

exchange/docs-conceptual/exchange-online-powershell-v2.md

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,12 +124,28 @@ For instructions on installing PowerShell 7 on macOS, see [Installing PowerShell
124124

125125
The EXO V2 module is officially supported in the following distributions of Linux:
126126

127-
- Ubuntu 18.04/20.04
127+
- Ubuntu 18.04 LTS
128+
- Ubuntu 20.04 LTS
128129

129130
If you have trouble using the EXO V2 module on other distributions of Linux, send email to the following address: `exocmdletpreview[at]service[dot]microsoft[dot]com`. The email address is purposefully obfuscated to avoid spam.
130131

131132
For instructions on installing PowerShell 7 on Linux, see [Installing PowerShell on Linux](/powershell/scripting/install/installing-powershell-core-on-linux?view=powershell-7.1&preserve-view=true).
132133

134+
After you install PowerShell 7, do the following steps:
135+
136+
1. Run PowerShell as superuser: `sudo pwsh`
137+
2. In the PowerShell superuser session, run the following commands:
138+
139+
```powershell
140+
Install-Module -Name PSWSMan
141+
142+
Install-WSMan
143+
```
144+
145+
If prompted, accept PSGallery as the source for the cmdlets.
146+
147+
Now you can do the [regular PowerShell prerequisites](#prerequisites-for-the-exo-v2-module) and [install the EXO V2 module](#install-the-exo-v2-module).
148+
133149
#### Windows
134150

135151
All versions of the EXO V2 module are supported in Windows PowerShell 5.1. PowerShell 7 on Windows requires version 2.0.4 or later of the EXO V2 module.

exchange/exchange-ps/exchange/New-ComplianceSearchAction.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -128,12 +128,11 @@ New-ComplianceSearchAction -SearchName "Remove Phishing Message" -Purge -PurgeTy
128128
This example deletes the search results returned by a content search named Remove Phishing Message. Note that unindexed items aren't deleted when you use the Purge parameter.
129129

130130
### Example 4
131-
132-
```
133-
New-ComplianceSearchAction -SearchName "Case 321 All Sites" -Export -SharePointArchiveFormat SingleZip
131+
```powershell
132+
New-ComplianceSearchAction -SearchName "Case 321 All Sites" -Export -SharePointArchiveFormat SingleZip -ExchangeArchiveFormat PerUserPst
134133
```
135134

136-
This example exports the results returned by the content search named "Case 321 All Sites". The search results are compressed and exported to a single ZIP file. If the search included any Exchange locations, the search results are exported as one PST file per mailbox (the default value of the ExchangeArchiveFormat parameter).
135+
This example exports the results returned by the content search named "Case 321 All Sites". The search results are compressed and exported to a single ZIP file. If the search included any Exchange locations, the search results are exported as one PST file per mailbox.
137136

138137
## PARAMETERS
139138

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

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -144,7 +144,17 @@ Accept wildcard characters: False
144144
```
145145
146146
### -AdvancedSettings
147-
The AdvancedSettings parameter enables client-specific features and capabilities for a sensitivity label. 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 more information how to configure these advanced settings, see [Custom configurations for the Azure Information Protection unified labeling client](https://docs.microsoft.com/azure/information-protection/rms-client/clientv2-admin-guide-customizations).
147+
The AdvancedSettings parameter enables specific features and capabilities for a sensitivity label.
148+
149+
Specify this parameter with the identity (name or GUID) of the sensitivity label, with key/value pairs in a [hash table](https://docs.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.
150+
151+
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 and services that support built-in labeling. For instructions, see [Custom configurations for the Azure Information Protection unified labeling client](https://docs.microsoft.com/azure/information-protection/rms-client/clientv2-admin-guide-customizations).
152+
153+
Supported settings for built-in labeling:
154+
155+
- **DefaultSharingScope**: For a container label, specifies the default sharing link type for a site. Available values are SpecificPeople, Organization, and Anyone. Example: `Set-Label -Identity General -AdvancedSettings @{DefaultSharingScope="SpecificPeople"}`. For more information about this configuration choice, see [Configure settings for the default sharing link for a site by using PowerShell advanced settings](https://docs.microsoft.com/microsoft-365/compliance/sensitivity-labels-teams-groups-sites#configure-settings-for-the-default-sharing-link-for-a-site-by-using-powershell-advanced-settings).
156+
157+
- **DefaultShareLinkPermission**: For a container label, specifies the permissions for the sharing link for a site. Available values are View and Edit. Example: `Set-Label -Identity General -AdvancedSettings @{DefaultShareLinkPermission="Edit"}`. For more information about this configuration choice, see [Outlook-specific options for default label and mandatory labeling](https://docs.microsoft.com/microsoft-365/compliance/sensitivity-labels-office-apps#outlook-specific-options-for-default-label-and-mandatory-labeling).
148158

149159
```yaml
150160
Type: PswsHashtable

exchange/exchange-ps/exchange/New-OutboundConnector.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,8 @@ New-OutboundConnector [-Name] <String>
3535
[-LinkForModifiedConnector <Guid>]
3636
[-RecipientDomains <MultiValuedProperty>]
3737
[-RouteAllMessagesViaOnPremises <Boolean>]
38-
[-SmartHosts <MultiValuedProperty>]
38+
[-SenderRewritingEnabled <Boolean>]
39+
[-SmartHosts <MultiValuedProperty>]
3940
[-TestMode <Boolean>]
4041
[-TlsDomain <SmtpDomainWithSubdomains>]
4142
[-TlsSettings <TlsAuthLevel>]
@@ -288,6 +289,25 @@ Accept pipeline input: False
288289
Accept wildcard characters: False
289290
```
290291

292+
### -SenderRewritingEnabled
293+
The SenderRewritingEnabled parameter specifies that all messages that normally qualify for SRS rewritting are rewritten for traffic to on-premises. This parameter is only effective for OnPremises connectors as Partner connectors already have SRS rewritting enabled. Valid values are:
294+
295+
- $true: Messages are rewritten by SRS if they need to be before being routed through the on-premises messaging system. This setting requires you to set the ConnectorType parameter to the value OnPremises in the same command.
296+
- $false: Messages aren't rewritten by SRS before being routed through the on-premises messaging system. This is the default value.
297+
298+
```yaml
299+
Type: Boolean
300+
Parameter Sets: (All)
301+
Aliases:
302+
Applicable: Exchange Online, Exchange Online Protection
303+
304+
Required: False
305+
Position: Named
306+
Default value: None
307+
Accept pipeline input: False
308+
Accept wildcard characters: False
309+
```
310+
291311
### -SmartHosts
292312
The SmartHosts parameter specifies the smart host that the Outbound connector uses to route mail. Valid values are:
293313

exchange/exchange-ps/exchange/New-SafeLinksPolicy.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,7 @@ New-SafeLinksPolicy [-Name] <String>
4242
[-TrackClicks <Boolean>]
4343
[-UseTranslatedNotificationText <Boolean>]
4444
[-WhatIf]
45+
[-DisableUrlRewrite <Boolean>]
4546
[-WhiteListedUrls <String>]
4647
[<CommonParameters>]
4748
```
@@ -170,6 +171,24 @@ Accept pipeline input: False
170171
Accept wildcard characters: False
171172
```
172173

174+
### -DisableUrlRewrite
175+
The DisableUrlRewrite parameter specifies whether to rewrite (wrap) URLs in email messages. Valid values are:
176+
177+
- $true: URLs in messages are not rewritten, but messages are still scanned by Safe Links prior to delivery. Time of click checks on links are done using the Safe Links API in supported Outlook clients (currently, Outlook for Windows and Outlook for Mac). Typically, we don't recommend using this value.
178+
- $false: URLs in messages are rewritten. API checks still occur on unwrapped URLs in supported clients if the user is in a valid Safe Links policy. This is the default value.
179+
180+
```yaml
181+
Type: Boolean
182+
Parameter Sets: (All)
183+
Aliases:
184+
185+
Required: False
186+
Position: Named
187+
Default value: None
188+
Accept pipeline input: False
189+
Accept wildcard characters: False
190+
```
191+
173192
### -DoNotAllowClickThrough
174193
The DoNotAllowClickThrough parameter specifies whether to allow users to click through to the original URL on warning pages. Valid values are:
175194

exchange/exchange-ps/exchange/Set-EventsFromEmailConfiguration.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -128,6 +128,8 @@ The FlightReservationProcessingLevel parameter specifies whether flight reservat
128128
- Email: Discover flight reservations from messages, but don't automatically add them to the user's calendar.
129129
- Calendar: Discover flight reservations from messages and automatically add them to the user's calendar. This is the default value.
130130
131+
Note that these values are case sensitive.
132+
131133
```yaml
132134
Type: String
133135
Parameter Sets: Identity

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

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,7 +124,17 @@ Accept wildcard characters: False
124124
```
125125
126126
### -AdvancedSettings
127-
The AdvancedSettings parameter enables client-specific features and capabilities for a sensitivity label. 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 more information how to configure these advanced settings, see [Custom configurations for the Azure Information Protection unified labeling client](https://docs.microsoft.com/azure/information-protection/rms-client/clientv2-admin-guide-customizations).
127+
The AdvancedSettings parameter enables specific features and capabilities for a sensitivity label.
128+
129+
Specify this parameter with the identity (name or GUID) of the sensitivity label, with key/value pairs in a [hash table](https://docs.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.
130+
131+
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 and services that support built-in labeling. For instructions, see [Custom configurations for the Azure Information Protection unified labeling client](https://docs.microsoft.com/azure/information-protection/rms-client/clientv2-admin-guide-customizations).
132+
133+
Supported settings for built-in labeling:
134+
135+
- **DefaultSharingScope**: For a container label, specifies the default sharing link type for a site. Available values are SpecificPeople, Organization, and Anyone. Example: `Set-Label -Identity General -AdvancedSettings @{DefaultSharingScope="SpecificPeople"}`. For more information about this configuration choice, see [Configure settings for the default sharing link for a site by using PowerShell advanced settings](https://docs.microsoft.com/microsoft-365/compliance/sensitivity-labels-teams-groups-sites#configure-settings-for-the-default-sharing-link-for-a-site-by-using-powershell-advanced-settings).
136+
137+
- **DefaultShareLinkPermission**: For a container label, specifies the permissions for the sharing link for a site. Available values are View and Edit. Example: `Set-Label -Identity General -AdvancedSettings @{DefaultShareLinkPermission="Edit"}`. For more information about this configuration choice, see [Outlook-specific options for default label and mandatory labeling](https://docs.microsoft.com/microsoft-365/compliance/sensitivity-labels-office-apps#outlook-specific-options-for-default-label-and-mandatory-labeling).
128138

129139
```yaml
130140
Type: PswsHashtable

exchange/exchange-ps/exchange/Set-OutboundConnector.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,7 @@ Set-OutboundConnector [-Identity] <OutboundConnectorIdParameter>
3737
[-Name <String>]
3838
[-RecipientDomains <MultiValuedProperty>]
3939
[-RouteAllMessagesViaOnPremises <Boolean>]
40+
[-SenderRewritingEnabled <Boolean>]
4041
[-SmartHosts <MultiValuedProperty>]
4142
[-TestMode <Boolean>]
4243
[-TlsDomain <SmtpDomainWithSubdomains>]
@@ -332,6 +333,25 @@ Accept pipeline input: False
332333
Accept wildcard characters: False
333334
```
334335

336+
### -SenderRewritingEnabled
337+
The SenderRewritingEnabled parameter specifies that all messages that normally qualify for SRS rewritting are rewritten for traffic to on-premises. This parameter is only effective for OnPremises connectors as Partner connectors already have SRS rewritting enabled. Valid values are:
338+
339+
- $true: Messages are rewritten by SRS if they need to be before being routed through the on-premises messaging system. This setting requires you to set the ConnectorType parameter to the value OnPremises in the same command.
340+
- $false: Messages aren't rewritten by SRS before being routed through the on-premises messaging system. This is the default value.
341+
342+
```yaml
343+
Type: Boolean
344+
Parameter Sets: (All)
345+
Aliases:
346+
Applicable: Exchange Online, Exchange Online Protection
347+
348+
Required: False
349+
Position: Named
350+
Default value: None
351+
Accept pipeline input: False
352+
Accept wildcard characters: False
353+
```
354+
335355
### -SmartHosts
336356
The SmartHosts parameter specifies the smart host that the Outbound connector uses to route mail. Valid values are:
337357

exchange/exchange-ps/exchange/Set-SafeLinksPolicy.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,7 @@ Set-SafeLinksPolicy [-Identity] <SafeLinksPolicyIdParameter>
4141
[-TrackClicks <Boolean>]
4242
[-UseTranslatedNotificationText <Boolean>]
4343
[-WhatIf]
44+
[-DisableUrlRewrite <Boolean>]
4445
[-WhiteListedUrls <String>]
4546
[<CommonParameters>]
4647
```
@@ -389,6 +390,24 @@ Accept pipeline input: False
389390
Accept wildcard characters: False
390391
```
391392

393+
### -DisableUrlRewrite
394+
The DisableUrlRewrite parameter specifies whether to rewrite (wrap) URLs in email messages. Valid values are:
395+
396+
- $true: URLs in messages are not rewritten, but messages are still scanned by Safe Links prior to delivery. Time of click checks on links are done using the Safe Links API in supported Outlook clients (currently, Outlook for Windows and Outlook for Mac). Typically, we don't recommend using this value.
397+
- $false: URLs in messages are rewritten. API checks still occur on unwrapped URLs in supported clients if the user is in a valid Safe Links policy. This is the default value.
398+
399+
```yaml
400+
Type: Boolean
401+
Parameter Sets: (All)
402+
Aliases:
403+
404+
Required: False
405+
Position: Named
406+
Default value: None
407+
Accept pipeline input: False
408+
Accept wildcard characters: False
409+
```
410+
392411
### -WhiteListedUrls
393412
This parameter has been deprecated. Use the DoNotRewriteUrls parameter instead.
394413

exchange/exchange-ps/exchange/Set-UnifiedGroup.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1136,10 +1136,12 @@ Accept wildcard characters: False
11361136
```
11371137

11381138
### -SubscriptionEnabled
1139-
The SubscriptionEnabled switch specifies whether subscriptions to conversations and calendar events are enabled for the Microsoft 365 Group.
1139+
The SubscriptionEnabled switch specifies whether the group owners can enable subscription to conversations and calendar events on the groups they own. This option can be set only in Exchange Online PowerShell.
11401140

11411141
- To change the value to $true, use this switch without a value.
1142-
- To change the value to $false, use this exact syntax: -SubscriptionEnabled:$false.
1142+
- To change the value to $false, use this exact syntax: -SubscriptionEnabled:$false. The value of the AutoSubscribeNewMembers parameter must also be $false before you can use the value $false for this switch.
1143+
1144+
**Note**: You should use the value $false for this parameter only if you intend to disable group owner ability to change subscription options on the group. Group owners will not be able to enable subscription options on the group settings using Outlook on the web or Outlook desktop. Group owners might see the error, "The group update is in progress" error when they try to enable Subscription option. Admins trying to enable Subscription from Microsoft admin center might also see error, "Can't save 'Send copies of group conversations and events to group member's inboxes' Either your assigned product license doesn't include Exchange Online or you have recently created this group and it's still not ready for management".
11431145

11441146
```yaml
11451147
Type: SwitchParameter

0 commit comments

Comments
 (0)