Updates to *-RemoteDomain cmdlets

Pers Issue #1728

Author: chrisda

exchange/exchange-ps/exchange/mail-flow/Get-RemoteDomain.md

@@ -32,21 +32,21 @@ You need to be assigned permissions before you can run this cmdlet. Although thi
 Get-RemoteDomain
 ```
 
-This example returns all remote domains configured in the Active Directory forest in which you run the command.
+This example returns a summary list of all remote domains in the organization.
 
 ### -------------------------- Example 2 --------------------------
 ```
-Get-RemoteDomain Contoso
+Get-RemoteDomain -Identity Contoso | Format-List
 ```
 
-This example returns the configuration for the remote domain Contoso.
+This example returns detailed information for the remote domain named Contoso.
 
 ### -------------------------- Example 3 --------------------------
 ```
 Get-RemoteDomain | Where {$_.TNEFEnabled -eq $false}
 ```
 
-This example queries Active Directory for all remote domains and displays only those remote domains for which Transport Neutral Encapsulation Format (TNEF) encoding isn't used.
+This example returns all domains where Transport Neutral Encapsulation Format (TNEF) encoding isn't used.
 
 ## PARAMETERS
 
@@ -70,7 +70,13 @@ Accept wildcard characters: False
 ```
 
 ### -Identity
-The Identity parameter specifies the remote domain you want to view. Enter either the GUID or name of the remote domain.
+The Identity parameter specifies the remote domain that you want to view. You can use any value that uniquely identifies the remote domain. For example:
+
+- Name
+
+- Distinguished name (DN)
+
+- GUID
 
 ```yaml
 Type: RemoteDomainIdParameter

exchange/exchange-ps/exchange/mail-flow/New-RemoteDomain.md

@@ -18,7 +18,9 @@ For information about the parameter sets in the Syntax section below, see Exchan
 ## SYNTAX
 
 ```
-New-RemoteDomain [-Name] <String> -DomainName <SmtpDomainWithSubdomains> [-Confirm] [-DomainController <Fqdn>]
+New-RemoteDomain [-Name] <String> -DomainName <SmtpDomainWithSubdomains>
+ [-Confirm]
+ [-DomainController <Fqdn>]
  [-WhatIf] [<CommonParameters>]
 ```
 
@@ -29,15 +31,17 @@ You need to be assigned permissions before you can run this cmdlet. Although thi
 
 ### -------------------------- Example 1 --------------------------
 ```
-New-RemoteDomain -DomainName Contoso.com -Name Contoso
+New-RemoteDomain -DomainName *.contoso.com -Name Contoso
 ```
 
-This example creates the remote domain Contoso.
+This example creates the remote domain named Contoso for the domain contoso.com and all subdomains.
 
 ## PARAMETERS
 
 ### -DomainName
-The DomainName parameter specifies the SMTP domain that you want to establish as a remote domain. Valid input for the DomainName parameter is an SMTP domain. You can use a wildcard character to specify all subdomains of a specified domain, as shown in the following example: \*.contoso.com. However, you can't embed a wildcard character, as shown in the following example: domain.\*.contoso.com. The domain name string may contain a maximum of 256 characters.
+The DomainName parameter specifies the SMTP domain that you want to establish as a remote domain. A valid value is an SMTP domain (for example, contoso.com). The maximum length is 256 characters.
+
+You can use the wildcard character (\*) to specify a domain and all subdomains (for example: \*.contoso.com), but you can't embed the wildcard character (for example, domain.\*.contoso.com).
 
 ```yaml
 Type: SmtpDomainWithSubdomains
@@ -52,7 +56,7 @@ Accept wildcard characters: False
 ```
 
 ### -Name
-The Name parameter specifies a unique name for the remote domain object.
+The Name parameter specifies a unique name for the remote domain object. The maximum length is 64 characters. If the value contains spaces, enclose the value in quoatation marks (").
 
 ```yaml
 Type: String

exchange/exchange-ps/exchange/mail-flow/Remove-RemoteDomain.md

@@ -37,7 +37,13 @@ This example removes the remote domain object named Contoso.
 ## PARAMETERS
 
 ### -Identity
-The Identity parameter specifies the remote domain you want to remove. Enter either the GUID or name of the remote domain.
+The Identity parameter specifies the remote domain that you want to remove. You can use any value that uniquely identifies the remote domain. For example:
+
+- Name
+
+- Distinguished name (DN)
+
+- GUID
 
 ```yaml
 Type: RemoteDomainIdParameter