From 6e782853a69507c44fee543cd63a4e9015b12a30 Mon Sep 17 00:00:00 2001
From: Yanjun Gao <v-yanjungao@microsoft.com>
Date: Thu, 4 Aug 2022 15:45:14 +0800
Subject: [PATCH] update help doc for set link connection cmdlets

---
 .../help/Set-AzSynapseLinkConnection.md       | 31 +++++++++++++++++++
 .../Set-AzSynapseLinkConnectionLinkTable.md   | 23 ++++++++++++++
 2 files changed, 54 insertions(+)

diff --git a/src/Synapse/Synapse/help/Set-AzSynapseLinkConnection.md b/src/Synapse/Synapse/help/Set-AzSynapseLinkConnection.md
index 4c1dde8c148a..a20ed2157fdd 100644
--- a/src/Synapse/Synapse/help/Set-AzSynapseLinkConnection.md
+++ b/src/Synapse/Synapse/help/Set-AzSynapseLinkConnection.md
@@ -31,6 +31,37 @@ The **Set-AzSynapseLinkConnection** cmdlet creates or updates a link connections
 
 ### Example 1
 ```powershell
+<#
+linkconnection.json
+{
+	"name":"sampleLinkConnection", // please change to your link connection name
+	"properties":{
+		"sourceDatabase":{
+			"typeProperties":{ // please change to your source database resourceId and principalId
+				"resourceId":"/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/sampleResourceGroup/providers/Microsoft.Sql/servers/sampleServer",
+				"principalId":"xxxxxxxxxx"
+				},
+			"linkedService":{
+				"referenceName":"sampleLinkServiceReference", // please change to your source database link service name
+				"type":"LinkedServiceReference"
+			}
+		},
+		"targetDatabase":{
+			"linkedService":{
+				"referenceName":"sampleLinkServiceReference", // please change to your target database link service name
+				"type":"LinkedServiceReference",
+				"parameters":{
+					"DBName":"v2"
+				}
+			}
+		},
+		"compute":{
+			"coreCount":16,
+			"computeType":"General"
+		}
+	}
+}
+#>
 Set-AzSynapseLinkConnection -WorkspaceName ContosoWorkspace -DefinitionFile "C:\\samples\\linkconnection.json"
 ```
 
diff --git a/src/Synapse/Synapse/help/Set-AzSynapseLinkConnectionLinkTable.md b/src/Synapse/Synapse/help/Set-AzSynapseLinkConnectionLinkTable.md
index 3f253360f64c..34ccface71b5 100644
--- a/src/Synapse/Synapse/help/Set-AzSynapseLinkConnectionLinkTable.md
+++ b/src/Synapse/Synapse/help/Set-AzSynapseLinkConnectionLinkTable.md
@@ -39,6 +39,29 @@ The **Set-AzSynapseLinkConnectionLinkTables** cmdlet edits link tables under a l
 
 ### Example 1
 ```powershell
+<#
+edittables.json
+{ 
+  "linkTables": [ 
+    { 
+      "id": "00000000000000000000000000000000", // please change to your link table Id: a uuid
+      "source": { 
+        "tableName": "sampleSourceTable", // please change to your source table name
+        "schemaName": "sampleSourceSchema" // please change to your source database schema name
+      }, 
+      "target": { 
+        "tableName": "sampleTargetTable", // please change to your target table name
+        "schemaName": "sampleTargetSchema", // please change to your target database schema name
+        "distributionOptions": { 
+          "type": "Round_RoBin", // please choose a type from Hash, Round_RoBin, Replicate
+          "distributionColumn": "sampleColumn" // please change to the column name
+        }
+      }, 
+      "operationType": "add" // please choose a value from add, update, remove
+    }
+  ]
+}
+#>
 Set-AzSynapseLinkConnectionLinkTable -WorkspaceName ContosoWorkspace -LinkConnectionName ContosoLinkConnection -EditTablesRequestFile "C:\\samples\\edittables.json"
 ```