Merge branch 'master' into get-teamChannel-int-note

kenwith · web-flow · commit 82c5a23fcf0f · 2020-02-12T08:14:40.000-08:00
diff --git a/exchange/exchange-ps/exchange/advanced-threat-protection/Set-AtpPolicyForO365.md b/exchange/exchange-ps/exchange/advanced-threat-protection/Set-AtpPolicyForO365.md
@@ -19,6 +19,8 @@ Use the Set-AtpPolicyForO365 cmdlet to modify the Advanced Threat Protection (AT
 
 - Safe Links for Office 365 ProPlus desktop clients and Office Mobile apps.
 
+- Safe Documents: Before a user is allowed to trust a file open in Office 365 ProPlus, the file will be verified by Microsoft Defender ATP.
+
 - ATP to protect files in SharePoint Online, OneDrive for Business and Microsoft Teams.
 
 For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://docs.microsoft.com/powershell/exchange/exchange-server/exchange-cmdlet-syntax).
@@ -28,9 +30,11 @@ For information about the parameter sets in the Syntax section below, see [Excha
 ```
 Set-AtpPolicyForO365 [[-Identity] <AtpPolicyForO365IdParameter>]
  [-AllowClickThrough <Boolean>]
+ [-AllowSafeDocsOpen <Boolean>]
  [-BlockUrls <MultiValuedProperty>]
  [-Confirm]
  [-EnableATPForSPOTeamsODB <Boolean>]
+ [-EnableSafeDocs <Boolean>]
  [-EnableSafeLinksForClients <Boolean>]
  [-TrackClicks <Boolean>]
  [-WhatIf] [<CommonParameters>]
@@ -90,6 +94,27 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -AllowSafeDocsOpen
+The AllowSafeDocsOpen parameter specifies whether users can click through and bypass the Protected View container even when Safe Documents in Microsoft Defender Advanced Threat Protection (MDATP) identifies a file as malicious. Valid values are:
+
+- $true: Users are allowed to exit the Protected View container even if the document has been identified as malicious.
+
+- $false: Users aren't allowed to exit Protected View in case of a malicious detection.
+
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+Applicable: Exchange Online
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -BlockUrls
 The BlockUrls parameter specifies the URLs that are always blocked by Safe Links scanning. You can specify multiple values separated by commas.
 
@@ -146,6 +171,26 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -EnableSafeDocs
+The EnableSafeDocs parameter specifies whether to enable the Safe Documents feature in the organization. Valid values are:
+
+- $true: Safe Documents is enabled and will upload user files to Microsoft Defender Advanced Threat Protection (MDATP) for scanning and verification.
+
+- $false: Safe Documents is disabled. This is the default value.
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+Applicable: Exchange Online
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -EnableSafeLinksForClients
 The EnableSafeLinksForClients parameter specifies whether Safe Links is enabled for Office 365 apps on desktop clients and on the web. Valid values are:
 
diff --git a/exchange/exchange-ps/exchange/antispam-antimalware/Get-HostedConnectionFilterPolicy.md b/exchange/exchange-ps/exchange/antispam-antimalware/Get-HostedConnectionFilterPolicy.md
@@ -32,22 +32,30 @@ You need to be assigned permissions before you can run this cmdlet. Although thi
 
 ### Example 1
 ```powershell
-Get-HostedConnectionFilterPolicy
+Get-HostedConnectionFilterPolicy | Format-List Name,IPBlockList,IPAllowList,EnableSafeList
 ```
 
-This example shows a summary list of all the connection filter policies in your cloud-based organization.
+This example returns a summary list of all connection filter policies in your organization.
 
 ### Example 2
 ```powershell
-Get-HostedConnectionFilterPolicy Default | Format-List
+Get-HostedConnectionFilterPolicy -Identity Default
 ```
 
-This example retrieves details about the connection filter policy named Default.
+This example returns detailed information about the connection filter policy named Default.
 
 ## PARAMETERS
 
 ### -Identity
-The Identity parameter specifies the connection filter policy that you want to view. You can use any value that uniquely identifies the policy. For example, you can specify the name, GUID or distinguished name (DN) of the connection filter policy.
+The Identity parameter specifies the connection filter policy that you want to view. You can use any value that uniquely identifies the policy. For example:
+
+- Name
+
+- Distinguished name (DN)
+
+- GUID
+
+Typically, you only have one connection filter policy: the default policy named Default.
 
 ```yaml
 Type: HostedConnectionFilterPolicyIdParameter
diff --git a/exchange/exchange-ps/exchange/antispam-antimalware/Set-HostedConnectionFilterPolicy.md b/exchange/exchange-ps/exchange/antispam-antimalware/Set-HostedConnectionFilterPolicy.md
@@ -23,9 +23,13 @@ For information about the parameter sets in the Syntax section below, see [Excha
 
 ```
 Set-HostedConnectionFilterPolicy [-Identity] <HostedConnectionFilterPolicyIdParameter>
- [-AdminDisplayName <String>] [-ConfigurationXmlRaw <String>] [-Confirm] [-EnableSafeList <Boolean>]
- [-IPAllowList <MultiValuedProperty>] [-IPBlockList <MultiValuedProperty>] [-MakeDefault] [-WhatIf]
- [<CommonParameters>]
+ [-AdminDisplayName <String>]
+ [-ConfigurationXmlRaw <String>]
+ [-Confirm] [-EnableSafeList <Boolean>]
+ [-IPAllowList <MultiValuedProperty>]
+ [-IPBlockList <MultiValuedProperty>]
+ [-MakeDefault]
+ [-WhatIf] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -35,21 +39,21 @@ You need to be assigned permissions before you can run this cmdlet. Although thi
 
 ### Example 1
 ```powershell
-Set-HostedConnectionFilterPolicy "Contoso Connection Filter Policy" -IPAllowList 192.168.1.10,192.168.1.23 -IPBlockList 10.10.10.0/25,172.17.17.0/24
+Set-HostedConnectionFilterPolicy "Default" -IPAllowList 192.168.1.10,192.168.1.23 -IPBlockList 10.10.10.0/25,172.17.17.0/24
 ```
 
-This example modifies the connection filter policy named Contoso Connection Filter Policy with the following settings:
+This example modifies the connection filter policy named Default with the following settings:
 
 - Messages from 192.168.1.10 and 192.168.1.23 are never identified as spam.
 
 - Messages from 10.10.10.0/25 and 172.17.17.0/24 are always identified as spam.
 
 ### Example 2
 ```powershell
-Set-HostedConnectionFilterPolicy "Contoso Connection Filter Policy" -IPAllowList @{Add="192.168.2.10","192.169.3.0/24","192.168.4.1-192.168.4.5";Remove="192.168.1.10"}
+Set-HostedConnectionFilterPolicy "Default" -IPAllowList @{Add="192.168.2.10","192.169.3.0/24","192.168.4.1-192.168.4.5";Remove="192.168.1.10"}
 ```
 
-This example modifies the connection filter policy named Contoso Connection Filter Policy with the following settings:
+This example modifies the connection filter policy named Default with the following settings:
 
 - The following IP addresses are added to the existing values in the IP allow list: 192.168.2.10, 192.169.3.0/24 and 192.168.4.1-192.168.4.5.
 
@@ -58,7 +62,15 @@ This example modifies the connection filter policy named Contoso Connection Filt
 ## PARAMETERS
 
 ### -Identity
-The Identity parameter specifies the connection filter policy you want to modify. You can use any value that uniquely identifies the policy. For example, you can use the name, GUID or distinguished name (DN) of the hosted connection filter policy.
+The Identity parameter specifies the connection filter policy that you want to modify. You can use any value that uniquely identifies the policy. For example:
+
+- Name
+
+- Distinguished name (DN)
+
+- GUID
+
+Typically, you only have one connection filter policy: the default policy named Default.
 
 ```yaml
 Type: HostedConnectionFilterPolicyIdParameter
@@ -74,7 +86,7 @@ Accept wildcard characters: False
 ```
 
 ### -AdminDisplayName
-The AdminDisplayName parameter specifies a description for the policy. If the value contains spaces, enclose the value in quotation marks (").
+The AdminDisplayName parameter specifies a description for the policy. If the value contains spaces, enclose the value in quotation marks ("). The maximum length is 255 characters.
 
 ```yaml
 Type: String
@@ -126,7 +138,11 @@ Accept wildcard characters: False
 ```
 
 ### -EnableSafeList
-The EnableSafeList parameter enables or disables use of the safe list. The safe list is a dynamic allow list in the Microsoft datacenter that requires no customer configuration. Valid input for this parameter is $true or $false. The default value is $false.
+The EnableSafeList parameter enables or disables use of the safe list. The safe list is a dynamic allow list in the Microsoft datacenter that requires no customer configuration. Valid values are:
+
+$true: Use the safe list to skip spam filtering on messages from trusted senders that are identified by various third-party sources that Microsoft subscribes to.
+
+$false: Don't use the safe list. This is the default value.
 
 ```yaml
 Type: Boolean
@@ -194,7 +210,7 @@ Accept wildcard characters: False
 ```
 
 ### -MakeDefault
-The MakeDefault switch makes the specified policy the default connection filter policy. You don't have to specify a value with this switch.
+This parameter is reserved for internal Microsoft use.
 
 ```yaml
 Type: SwitchParameter
