Merge pull request MicrosoftDocs#6426 from MicrosoftDocs/chrisda

Chrisda to Master

Author: chrisda

exchange/docs-conceptual/connect-to-exchange-online-powershell.md

@@ -114,7 +114,7 @@ If your account doesn't use multi-factor authentication, use the steps in this s
 3. The command that you need to run uses the following syntax:
 
    ```powershell
-   Connect-ExchangeOnline -Credential $UserCredential = Get-Credential -ShowProgress $true [-ConnectionUri <URL>] [-DelegatedOrganization <String>]
+   Connect-ExchangeOnline -Credential $UserCredential -ShowProgress $true [-ConnectionUri <URL>] [-DelegatedOrganization <String>]
    ```
 
    - The required _ConnectionUri_ value depends on the nature of your Microsoft 365 organization. For more information, see the parameter description in [Connect-ExchangeOnline](https://docs.microsoft.com/powershell/module/exchange/connect-exchangeonline).

exchange/exchange-ps/exchange/Disable-SafeAttachmentRule.md

@@ -15,7 +15,7 @@ monikerRange: "exchonline-ps || eop-ps"
 ## SYNOPSIS
 This cmdlet is available only in the cloud-based service.
 
-Use the Disable-SafeAttachmentRule cmdlet to disable enabled Safe Attachments rules in your cloud-based organization.
+Use the Disable-SafeAttachmentRule cmdlet to disable safe attachment rules in your cloud-based organization.
 
 **Note**: We recommend that you use the Exchange Online PowerShell V2 module to connect to Exchange Online PowerShell. For instructions, see [Connect to Exchange Online PowerShell](https://docs.microsoft.com/powershell/exchange/connect-to-exchange-online-powershell).
 
@@ -28,7 +28,7 @@ Disable-SafeAttachmentRule [-Identity] <RuleIdParameter> [-Confirm] [-WhatIf] [<
 ```
 
 ## DESCRIPTION
-Safe Attachments is a feature in Advanced Threat Protection that opens email attachments in a special hypervisor environment to detect malicious activity.
+Safe Attachments is a feature in Advanced Threat Protection that opens email attachments in a special hypervisor environment to detect malicious activity. For more information, see [Safe Attachments in Office 365 ATP](https://docs.microsoft.com/microsoft-365/security/office-365-security/atp-safe-attachments).
 
 You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://docs.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
 
@@ -39,12 +39,12 @@ You need to be assigned permissions before you can run this cmdlet. Although thi
 Disable-SafeAttachmentRule -Identity "Engineering Department Attachment Rule"
 ```
 
-This example disables the Safe Attachments rule named Engineering Department Attachment Rule.
+This example disables the safe attachment rule named Engineering Department Attachment Rule.
 
 ## PARAMETERS
 
 ### -Identity
-The Identity parameter specifies the enabled Safe Attachments rule that you want to disable.
+The Identity parameter specifies the enabled safe attachment rule that you want to disable.
 
 You can use any value that uniquely identifies the rule. For example:
 

exchange/exchange-ps/exchange/Enable-SafeAttachmentRule.md

@@ -15,7 +15,7 @@ monikerRange: "exchonline-ps || eop-ps"
 ## SYNOPSIS
 This cmdlet is available only in the cloud-based service.
 
-Use the Enable-SafeAttachmentRule cmdlet to enable disabled Safe Attachments rules in your cloud-based organization.
+Use the Enable-SafeAttachmentRule cmdlet to enable safe attachment rules in your cloud-based organization.
 
 **Note**: We recommend that you use the Exchange Online PowerShell V2 module to connect to Exchange Online PowerShell. For instructions, see [Connect to Exchange Online PowerShell](https://docs.microsoft.com/powershell/exchange/connect-to-exchange-online-powershell).
 
@@ -28,7 +28,7 @@ Enable-SafeAttachmentRule [-Identity] <RuleIdParameter> [-Confirm] [-WhatIf] [<C
 ```
 
 ## DESCRIPTION
-Safe Attachments is a feature in Advanced Threat Protection that opens email attachments in a special hypervisor environment to detect malicious activity.
+Safe Attachments is a feature in Advanced Threat Protection that opens email attachments in a special hypervisor environment to detect malicious activity. For more information, see [Safe Attachments in Office 365 ATP](https://docs.microsoft.com/microsoft-365/security/office-365-security/atp-safe-attachments).
 
 You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://docs.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
 
@@ -39,12 +39,12 @@ You need to be assigned permissions before you can run this cmdlet. Although thi
 Enable-SafeAttachmentRule -Identity "Marketing Department Attachment Rule"
 ```
 
-This example enables the disabled Safe Attachments rule named Marketing Department Attachment Rule.
+This example enables the disabled safe attachment rule named Marketing Department Attachment Rule.
 
 ## PARAMETERS
 
 ### -Identity
-The Identity parameter specifies the disabled Safe Attachments rule that you want to enable.
+The Identity parameter specifies the disabled safe attachment rule that you want to enable.
 
 You can use any value that uniquely identifies the rule. For example:
 

exchange/exchange-ps/exchange/Get-SafeAttachmentPolicy.md

@@ -15,7 +15,7 @@ monikerRange: "exchonline-ps || eop-ps"
 ## SYNOPSIS
 This cmdlet is available only in the cloud-based service.
 
-Use the Get-SafeAttachmentPolicy cmdlet to view Safe Attachments policies in your cloud-based organization.
+Use the Get-SafeAttachmentPolicy cmdlet to view safe attachment policies in your cloud-based organization.
 
 **Note**: We recommend that you use the Exchange Online PowerShell V2 module to connect to Exchange Online PowerShell. For instructions, see [Connect to Exchange Online PowerShell](https://docs.microsoft.com/powershell/exchange/connect-to-exchange-online-powershell).
 
@@ -28,7 +28,7 @@ Get-SafeAttachmentPolicy [[-Identity] <SafeAttachmentPolicyIdParameter>] [<Commo
 ```
 
 ## DESCRIPTION
-Safe Attachments is a feature in Advanced Threat Protection that opens email attachments in a special hypervisor environment to detect malicious activity.
+Safe Attachments is a feature in Advanced Threat Protection that opens email attachments in a special hypervisor environment to detect malicious activity. For more information, see [Safe Attachments in Office 365 ATP](https://docs.microsoft.com/microsoft-365/security/office-365-security/atp-safe-attachments).
 
 You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://docs.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
 
@@ -39,19 +39,19 @@ You need to be assigned permissions before you can run this cmdlet. Although thi
 Get-SafeAttachmentPolicy
 ```
 
-This example shows a summary list of all Safe Attachments policies.
+This example shows a summary list of all safe attachment policies.
 
 ### Example 2
 ```powershell
 Get-SafeAttachmentPolicy -Identity Default | Format-List
 ```
 
-This example shows detailed information about the Safe Attachments policy named Default.
+This example shows detailed information about the safe attachment policy named Default.
 
 ## PARAMETERS
 
 ### -Identity
-The Identity parameter specifies the Safe Attachments policy that you want to view.
+The Identity parameter specifies the safe attachment policy that you want to view.
 
 You can use any value that uniquely identifies the policy. For example:
 

exchange/exchange-ps/exchange/Get-SafeAttachmentRule.md

@@ -15,7 +15,7 @@ monikerRange: "exchonline-ps || eop-ps"
 ## SYNOPSIS
 This cmdlet is available only in the cloud-based service.
 
-Use the Get-SafeAttachmentRule cmdlet to view Safe Attachments rules in your cloud-based organization.
+Use the Get-SafeAttachmentRule cmdlet to view safe attachment rules in your cloud-based organization.
 
 **Note**: We recommend that you use the Exchange Online PowerShell V2 module to connect to Exchange Online PowerShell. For instructions, see [Connect to Exchange Online PowerShell](https://docs.microsoft.com/powershell/exchange/connect-to-exchange-online-powershell).
 
@@ -28,7 +28,7 @@ Get-SafeAttachmentRule [[-Identity] <RuleIdParameter>] [-State <RuleState>] [<Co
 ```
 
 ## DESCRIPTION
-Safe Attachments is a feature in Advanced Threat Protection that opens email attachments in a special hypervisor environment to detect malicious activity.
+Safe Attachments is a feature in Advanced Threat Protection that opens email attachments in a special hypervisor environment to detect malicious activity. For more information, see [Safe Attachments in Office 365 ATP](https://docs.microsoft.com/microsoft-365/security/office-365-security/atp-safe-attachments).
 
 You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://docs.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
 
@@ -39,19 +39,19 @@ You need to be assigned permissions before you can run this cmdlet. Although thi
 Get-SafeAttachmentRule
 ```
 
-This example returns a summary list of all Safe Attachments rules in your organization.
+This example returns a summary list of all safe attachment rules in your organization.
 
 ### Example 2
 ```powershell
 Get-SafeAttachmentRule -Identity "Research Department Attachment Rule" | Format-List
 ```
 
-This example returns detailed information about the Safe Attachments rule named Research Department Attachment Rule.
+This example returns detailed information about the safe attachment rule named Research Department Attachment Rule.
 
 ## PARAMETERS
 
 ### -Identity
-The Identity parameter specifies the Safe Attachments rule that you want to view.
+The Identity parameter specifies the safe attachment rule that you want to view.
 
 You can use any value that uniquely identifies the rule. For example:
 

exchange/exchange-ps/exchange/New-AntiPhishPolicy.md

@@ -60,7 +60,7 @@ New-AntiPhishPolicy [-Name] <String>
 ## DESCRIPTION
 Phishing messages contain fraudulent links or spoofed domains in an effort to get personal information from the recipients.
 
-New antiphish policies aren't valid and aren't applied until you add an antiphish rule to the policy by using the New-AntiPhishRule cmdlet.
+New policies that you create using this cmdlet aren't applied to users and aren't visible in admin centers. You need to use the AntiPhishPolicy parameter on the New-AntiPhishRule or Set-AntiPhishRule cmdlets to associate the policy with a rule.
 
 You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://docs.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
 

exchange/exchange-ps/exchange/New-HostedOutboundSpamFilterPolicy.md

@@ -39,6 +39,8 @@ New-HostedOutboundSpamFilterPolicy [-Name] <String>
 ```
 
 ## DESCRIPTION
+New policies that you create using this cmdlet aren't applied to users and aren't visible in admin centers. You need to use the HostedOutboundSpamFilterPolicy parameter on the New-HostedOutboundSpamFilterRule or Set-HostedOutboundSpamFilterRule cmdlets to associate the policy with a rule.
+
 You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://docs.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
 
 ## EXAMPLES

exchange/exchange-ps/exchange/New-MalwareFilterPolicy.md

@@ -51,6 +51,8 @@ New-MalwareFilterPolicy [-Name] <String>
 ```
 
 ## DESCRIPTION
+New policies that you create using this cmdlet aren't applied to users and aren't visible in admin centers. You need to use the MalwareFilterPolicy parameter on the New-MalwareFilterRule or Set-MalwareFilterRule cmdlets to associate the policy with a rule.
+
 You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://docs.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
 
 ## EXAMPLES

exchange/exchange-ps/exchange/New-SafeAttachmentPolicy.md

@@ -15,7 +15,7 @@ monikerRange: "exchonline-ps || eop-ps"
 ## SYNOPSIS
 This cmdlet is available only in the cloud-based service.
 
-Use the New-SafeAttachmentPolicy cmdlet to create Safe Attachments policies in your cloud-based organization.
+Use the New-SafeAttachmentPolicy cmdlet to create safe attachment policies in your cloud-based organization.
 
 **Note**: We recommend that you use the Exchange Online PowerShell V2 module to connect to Exchange Online PowerShell. For instructions, see [Connect to Exchange Online PowerShell](https://docs.microsoft.com/powershell/exchange/connect-to-exchange-online-powershell).
 
@@ -37,28 +37,26 @@ New-SafeAttachmentPolicy [-Name] <String>
 ```
 
 ## DESCRIPTION
-New Safe Attachments policies aren't valid and aren't applied until you add a Safe Attachments rule to the policy by using the New-SafeAttachmentRule cmdlet.
+Safe Attachments is a feature in Office 365 Advanced Threat Protection that opens email attachments in a special hypervisor environment to detect malicious activity. For more information, see [Safe Attachments in Office 365 ATP](https://docs.microsoft.com/microsoft-365/security/office-365-security/atp-safe-attachments).
 
-Safe Attachments is a feature in Advanced Threat Protection that opens email attachments in a special hypervisor environment to detect malicious activity.
+New policies that you create using this cmdlet aren't applied to users and aren't visible in admin centers. You need to use the SafeAttachmentPolicy parameter on the New-SafeAttachmentRule or Set-SafeAttachmentRule cmdlets to associate the policy with a rule.
 
 You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://docs.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
 
 ## EXAMPLES
 
 ### Example 1
 ```powershell
-New-SafeAttachmentPolicy -Name "Marketing Block Attachments" -Enable $true -Redirect $true -RedirectAddress [email protected]
+New-SafeAttachmentPolicy -Name "Marketing Block Attachments" -Redirect $true -RedirectAddress [email protected]
 ```
 
 This example creates a new Safe Attachments policy named Marketing Block Attachments with the following options:
 
-- The policy is enabled.
-
 - The action is Block. This is the default value of the Action parameter, so you don't need to specify it.
 
-- If Safe Attachments scanning isn't available or encounters errors, deliver the message as normal. The default value of the ActionOnError parameter is $false, so you don't need to specify it.
+- Enable redirection for detected malware attachments and send the messages to [email protected].
 
-- Redirect detected malware messages to [email protected].
+- If Safe Attachments scanning isn't available or encounters errors, don't deliver the message as normal. The default value of the ActionOnError parameter is $true, so you don't need to specify it.
 
 ## PARAMETERS
 
@@ -81,7 +79,7 @@ Accept wildcard characters: False
 ### -Action
 The Action parameter specifies the action for the Safe Attachments policy. Valid values are:
 
-- Allow: Deliver the email message, including the malware attachment.
+- Allow: Attachments aren't scanned by Safe Attachments policies.
 
 - Block: Block the email message that contains the malware attachment. This is the default value.
 
@@ -107,9 +105,9 @@ Accept wildcard characters: False
 ### -ActionOnError
 The ActionOnError parameter specifies the error handling option for Safe Attachments scanning (what to do if scanning times out or an error occurs). Valid values are:
 
-- $true: The action specified by the Action parameter is applied to messages even when the attachments aren't successfully scanned.
+- $true: The action specified by the Action parameter is applied to messages even when the attachments aren't successfully scanned. This is the default value.
 
-- $false: The action specified by the Action parameter isn't applied to messages when the attachments aren't successfully scanned. This is the default value.
+- $false: The action specified by the Action parameter isn't applied to messages when the attachments aren't successfully scanned.
 
 ```yaml
 Type: Boolean
@@ -161,11 +159,7 @@ Accept wildcard characters: False
 ```
 
 ### -Enable
-The Enable parameter specifies whether policy is enabled. Valid values are:
-
-- $true: The rule or policy is enabled.
-
-- $false: The rule or policy is disabled. This is the default value.
+This parameter isn't used. To enable or disable a safe attachment policy, use the Enabled parameter on the New-SafeAttachmentRule or Set-SafeAttachmentRule cmdlets.
 
 ```yaml
 Type: Boolean