Merge pull request #10271 from MicrosoftDocs/MashaMSFT-patch-1

added IP examples

Author: PRMerger13

docs/t-sql/statements/alter-availability-group-transact-sql.md

@@ -135,7 +135,7 @@ ALTER AVAILABILITY GROUP group_name
    }  
 
   <network_subnet_option> ::=  
-     'four_part_ipv4_address', 'four_part_ipv4_mask'    
+     'ipv4_address', 'ipv4_mask'    
 
   <ip_address_option> ::=  
      {   
@@ -555,10 +555,10 @@ Initiates a manual failover of the availability group without data loss to the s
 
  `WITH IP ( ('10.120.19.155','255.255.254.0') )`  
 
- *four_part_ipv4_address*  
+ *ipv4_address*  
  Specifies an IPv4 four-part address for an availability group listener. For example, `10.120.19.155`.  
 
- *four_part_ipv4_mask*  
+ *ipv4_mask*  
  Specifies an IPv4 four-part mask for an availability group listener. For example, `255.255.254.0`.  
 
  *ipv6_address*  

docs/t-sql/statements/create-availability-group-transact-sql.md

@@ -98,11 +98,11 @@ CREATE AVAILABILITY GROUP group_name
    }  
 
   <network_subnet_option> ::=  
-     'four_part_ipv4_address', 'four_part_ipv4_mask'    
+     'ip4_address', 'four_part_ipv4_mask'    
 
   <ip_address_option> ::=  
      {   
-        'four_part_ipv4_address', 'four_part_ipv4_mask'  
+        'ip4_address', 'pv4_mask'  
       | 'ipv6_address'  
      }  
 
@@ -454,10 +454,10 @@ CREATE AVAILABILITY GROUP group_name
 
  `WITH IP ( ('10.120.19.155','255.255.254.0') )`  
 
- *four_part_ipv4_address*  
+ *ip4_address*  
  Specifies an IPv4 four-part address for an availability group listener. For example, `10.120.19.155`.  
 
- *four_part_ipv4_mask*  
+ *ipv4_mask*  
  Specifies an IPv4 four-part mask for an availability group listener. For example, `255.255.254.0`.  
 
  *ipv6_address*  

docs/t-sql/statements/create-endpoint-transact-sql.md

@@ -67,7 +67,7 @@ FOR { TSQL | SERVICE_BROKER | DATABASE_MIRRORING } (
 <AS TCP_protocol_specific_arguments> ::=  
 AS TCP (  
   LISTENER_PORT = listenerPort  
-  [ [ , ] LISTENER_IP = ALL | ( 4-part-ip ) | ( "ip_address_v6" ) ]  
+  [ [ , ] LISTENER_IP = ALL | ( xx.xx.xx.xx IPv4 address ) | ( '__:__1' IPv6 address ) ]  
   
 )  
   
@@ -271,7 +271,7 @@ FOR DATABASE_MIRRORING (
 ### Creating a database mirroring endpoint  
  The following example creates a database mirroring endpoint. The endpoint uses port number `7022`, although any available port number would work. The endpoint is configured to use Windows Authentication using only Kerberos. The `ENCRYPTION` option is configured to the nondefault value of `SUPPORTED` to support encrypted or unencrypted data. The endpoint is being configured to support both the partner and witness roles.  
 
-```  
+```sql  
 CREATE ENDPOINT endpoint_mirroring  
     STATE = STARTED  
     AS TCP ( LISTENER_PORT = 7022 )  
@@ -281,6 +281,36 @@ CREATE ENDPOINT endpoint_mirroring
        ROLE=ALL);  
 GO  
 ```  
+
+### Create a new endpoint pointing to a specific IPv4 address and port
+
+```sql
+CREATE ENDPOINT ipv4_endpoint_special
+STATE = STARTED
+AS TCP (
+    LISTENER_PORT = 55555, LISTENER_IP = (10.0.75.1)
+)
+FOR TSQL ();
+
+GRANT CONNECT ON ENDPOINT::[TSQL Default TCP] TO public; -- Keep existing public permission on default endpoint for demo purpose
+GRANT CONNECT ON ENDPOINT::ipv4_endpoint_special
+TO login_name;
+```
+
+### Create a new endpoint pointing to a specific IPv6 address and port
+
+```sql
+CREATE ENDPOINT ipv6_endpoint_special
+STATE = STARTED
+AS TCP (
+    LISTENER_PORT = 55555, LISTENER_IP = ('::1')
+)
+FOR TSQL ();
+
+GRANT CONNECT ON ENDPOINT::[TSQL Default TCP] TO public;
+GRANT CONNECT ON ENDPOINT::ipv6_endpoint_special
+
+```
 
 ## See also  
  [ALTER ENDPOINT &#40;Transact-SQL&#41;](../../t-sql/statements/alter-endpoint-transact-sql.md)