Skip to content

Commit 6a07a75

Browse files
committed
Safe Links updates
1 parent 047ae51 commit 6a07a75

File tree

3 files changed

+46
-24
lines changed

3 files changed

+46
-24
lines changed

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

Lines changed: 19 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -155,7 +155,7 @@ Accept wildcard characters: False
155155
```
156156
157157
### -DoNotAllowClickThrough
158-
The DoNotAllowClickThrough parameter specifies whether to allow users to click through to the original URL. Valid values are:
158+
The DoNotAllowClickThrough parameter specifies whether to allow users to click through to the original URL on warning pages. Valid values are:
159159
160160
- $true: The user isn't allowed to click through to the original URL.
161161
@@ -175,7 +175,13 @@ Accept wildcard characters: False
175175
```
176176
177177
### -DoNotRewriteUrls
178-
The DoNotRewriteUrls parameter specifies the URLs that skip Safe Links scanning and are always allowed. You can specify multiple values separated by commas. Wildcards are supported (up to three).
178+
The DoNotRewriteUrls parameter specifies the URLs that are not rewritten by Safe Links scanning. The list of entries allows users who are included in the policy to access the specified URLs that would otherwise be blocked by Safe Links.
179+
180+
To enter multiple values and overwrite any existing entries, use the following syntax: \<value1\>,\<value2\>,...\<valueN\>. If the values contain spaces or otherwise require quotation marks, you need to use the following syntax: "\<value1\>","\<value2\>",..."\<valueN\>".
181+
182+
To add or remove one or more values without affecting any existing entries, use the following syntax: @{Add="\<value1\>","\<value2\>"...; Remove="\<value1\>","\<value2\>"...}.
183+
184+
For details about the entry syntax, see [Entry syntax for the "Do not rewrite the following URLs" list](https://docs.microsoft.com/en-us/microsoft-365/security/office-365-security/atp-safe-links#entry-syntax-for-the-do-not-rewrite-the-following-urls-list).
179185
180186
```yaml
181187
Type: MultiValuedProperty
@@ -191,11 +197,11 @@ Accept wildcard characters: False
191197
```
192198
193199
### -DoNotTrackUserClicks
194-
The DoNotTrackUserClicks parameter specifies whether to track user clicks related to links in email messages and Microsoft Teams. Valid values are:
200+
The DoNotTrackUserClicks parameter specifies whether to track user clicks related to Safe Links protection of links in email messages. Valid values are:
195201
196-
- $true: User clicks aren't tracked.
202+
- $true: User clicks in email messages aren't tracked.
197203
198-
- $false: User clicks are tracked. This is the default value.
204+
- $false: User clicks in email messages are tracked. This is the default value.
199205
200206
```yaml
201207
Type: Boolean
@@ -231,6 +237,8 @@ Accept wildcard characters: False
231237
```
232238
233239
### -EnableSafeLinksForTeams
240+
**Note**: As of March 2020, this parameter is in Preview and is available only for members of the Microsoft Teams Technology Adoption Program (TAP).
241+
234242
The EnableSafeLinksForTeams parameter specifies whether Safe Links is enabled for Microsoft Teams. Valid values are:
235243
236244
- $true: Safe Links is enabled for Teams. If a protected user clicks a malicious link in a Teams conversation, group chat, or from channels, a warning page will appear in the default web browser.
@@ -267,11 +275,11 @@ Accept wildcard characters: False
267275
```
268276
269277
### -IsEnabled
270-
The IsEnabled parameter specifies whether to rewrite URLs and check against a list of known malicious links whenever a user clicks on a link in email messages. Valid values are:
278+
The IsEnabled parameter specifies whether to enable Safe Links protection for email messages. Valid values are:
271279
272-
- $true: Rewrite URLs and check against a list of known malicious links whenever a user clicks on a link.
280+
- $true: Enable Safe Links protection for email messages. Rewrite URLs and check against a list of known malicious links whenever a user clicks a link in an email message.
273281
274-
- $false: Don't rewrite URLs. This is the default value.
282+
- $false: Disable Safe Links protection for email messages. Don't rewrite URLs and do not check clicked links in email messages. This is the default value.
275283
276284
```yaml
277285
Type: Boolean
@@ -287,11 +295,11 @@ Accept wildcard characters: False
287295
```
288296
289297
### -ScanUrls
290-
The ScanUrls parameter specifies whether to enable or disable real-time scanning of links in email messages. Valid values are:
298+
The ScanUrls parameter specifies whether to enable or disable real-time scanning of clicked links in email messages. Valid values are:
291299
292-
- $true: Real-time scanning of links in email messages is enabled.
300+
- $true: Real-time scanning of clicked links in email messages, including links that point to files, is enabled.
293301
294-
- $false: Real-time scanning of links in email messages is disabled. This is the default value.
302+
- $false: Real-time scanning of clicked links in email messages, including links that point to files, is disabled. This is the default value.
295303
296304
```yaml
297305
Type: Boolean

exchange/exchange-ps/exchange/Set-AtpPolicyForO365.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -118,7 +118,13 @@ Accept wildcard characters: False
118118
```
119119
120120
### -BlockUrls
121-
The BlockUrls parameter specifies the URLs that are always blocked by Safe Links scanning in email messages, and supported Office 365 desktop and mobile apps. You can specify multiple values separated by commas.
121+
The BlockUrls parameter specifies the URLs that are always blocked by Safe Links scanning in email messages, and supported Office 365 desktop and mobile apps.
122+
123+
To enter multiple values and overwrite any existing entries, use the following syntax: \<value1\>,\<value2\>,...\<valueN\>. If the values contain spaces or otherwise require quotation marks, you need to use the following syntax: "\<value1\>","\<value2\>",..."\<valueN\>".
124+
125+
To add or remove one or more values without affecting any existing entries, use the following syntax: @{Add="\<value1\>","\<value2\>"...; Remove="\<value1\>","\<value2\>"...}.
126+
127+
For details about the entry syntax, see [Entry syntax for the "Block the following URLs" list](https://docs.microsoft.com/en-us/microsoft-365/security/office-365-security/atp-safe-links#entry-syntax-for-the-block-the-following-urls-list).
122128
123129
```yaml
124130
Type: MultiValuedProperty
@@ -200,6 +206,8 @@ The EnableSafeLinksForO365Clients parameter specifies whether Safe Links scannin
200206
201207
- $false: Safe Links scanning is disabled in supported Office 365 apps.
202208
209+
Note that this protection applies to links in Office documents, not links in email messages. Safe Links protection for links in email messages is controlled by Safe Links policies (the [New-SafeLinksPolicy](https://docs.microsoft.com/powershell/module/exchange/new-safelinkspolicy) or [Set-SafeLinksPolicy](https://docs.microsoft.com/powershell/module/exchange/set-safelinkspolicy) cmdlets).
210+
203211
```yaml
204212
Type: Boolean
205213
Parameter Sets: (All)
@@ -214,7 +222,7 @@ Accept wildcard characters: False
214222
```
215223
216224
### -TrackClicks
217-
The TrackClicks parameter specifies whether to track user clicks related to blocked URLs in supported Office 365 desktop, mobile, and web apps. Valid values are:
225+
The TrackClicks parameter specifies whether to track user clicks related to blocked URLs in supported Office 365 apps. Valid values are:
218226
219227
- $true: User clicks in supported Office 365 apps are tracked.
220228

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

Lines changed: 17 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -155,7 +155,7 @@ Accept wildcard characters: False
155155
```
156156
157157
### -DoNotAllowClickThrough
158-
The DoNotAllowClickThrough parameter specifies whether to allow users to click through to the original URL. Valid values are:
158+
The DoNotAllowClickThrough parameter specifies whether to allow users to click through to the original URL on warning pages. Valid values are:
159159
160160
- $true: The user isn't allowed to click through to the original URL.
161161
@@ -175,7 +175,11 @@ Accept wildcard characters: False
175175
```
176176
177177
### -DoNotRewriteUrls
178-
The DoNotRewriteUrls parameter specifies the URLs that skip Safe Links scanning and are always allowed. You can specify multiple values separated by commas. Wildcards are supported (up to three).
178+
The DoNotRewriteUrls parameter specifies the URLs that are not rewritten by Safe Links scanning. The list of entries allows users who are included in the policy to access the specified URLs that would otherwise be blocked by Safe Links.
179+
180+
To enter multiple values, use the following syntax: \<value1\>,\<value2\>,...\<valueN\>. If the values contain spaces or otherwise require quotation marks, you need to use the following syntax: "\<value1\>","\<value2\>",..."\<valueN\>".
181+
182+
For details about the entry syntax, see [Entry syntax for the "Do not rewrite the following URLs" list](https://docs.microsoft.com/en-us/microsoft-365/security/office-365-security/atp-safe-links#entry-syntax-for-the-do-not-rewrite-the-following-urls-list).
179183
180184
```yaml
181185
Type: MultiValuedProperty
@@ -191,11 +195,11 @@ Accept wildcard characters: False
191195
```
192196
193197
### -DoNotTrackUserClicks
194-
The DoNotTrackUserClicks parameter specifies whether to track user clicks related to links in email messages and Microsoft Teams. Valid values are:
198+
The DoNotTrackUserClicks parameter specifies whether to track user clicks related to Safe Links protection of links in email messages. Valid values are:
195199
196-
- $true: User clicks aren't tracked.
200+
- $true: User clicks in email messages aren't tracked.
197201
198-
- $false: User clicks are tracked. This is the default value.
202+
- $false: User clicks in email messages are tracked. This is the default value.
199203
200204
```yaml
201205
Type: Boolean
@@ -231,6 +235,8 @@ Accept wildcard characters: False
231235
```
232236
233237
### -EnableSafeLinksForTeams
238+
**Note**: As of March 2020, this parameter is in Preview is available only for members of the Microsoft Teams Technology Adoption Program (TAP).
239+
234240
The EnableSafeLinksForTeams parameter specifies whether Safe Links is enabled for Microsoft Teams. Valid values are:
235241
236242
- $true: Safe Links is enabled for Teams. When a user clicks a link in a Teams conversation, group chat, or from channels, the link is checked by Safe Links. If the link is found to be malicious, a warning page appears in the default web browser.
@@ -267,11 +273,11 @@ Accept wildcard characters: False
267273
```
268274
269275
### -IsEnabled
270-
The IsEnabled parameter specifies whether to rewrite URLs and check against a list of known malicious links whenever a user clicks on a link in email messages. Valid values are:
276+
The IsEnabled parameter specifies whether to enable Safe Links protection for email messages. Valid values are:
271277
272-
- $true: Rewrite URLs and check against a list of known malicious links whenever a user clicks on a link.
278+
- $true: Enable Safe Links protection for email messages. Rewrite URLs and check against a list of known malicious links whenever a user clicks a link in an email message.
273279
274-
- $false: Don't rewrite URLs and do not check links. This is the default value.
280+
- $false: Disable Safe Links protection for email messages. Don't rewrite URLs and do not check clicked links in email messages. This is the default value.
275281
276282
```yaml
277283
Type: Boolean
@@ -287,11 +293,11 @@ Accept wildcard characters: False
287293
```
288294
289295
### -ScanUrls
290-
The ScanUrls parameter specifies whether to enable or disable real-time scanning of links in email messages. Valid values are:
296+
The ScanUrls parameter specifies whether to enable or disable real-time scanning of clicked links in email messages. Valid values are:
291297
292-
- $true: Real-time scanning links in email messages is enabled.
298+
- $true: Real-time scanning of clicked links in email messages, including links that point to files, is enabled.
293299
294-
- $false: Real-time scanning links in email messages is disabled. This is the default value.
300+
- $false: Real-time scanning of clicked links in email messages, including links that point to files, is disabled. This is the default value.
295301
296302
```yaml
297303
Type: Boolean

0 commit comments

Comments
 (0)