Connection filter policy topic improvements

Author: chrisda

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

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