Create synchronize-vnet-dns-servers-setting-on-virtual-cluster.md

Author: srdan-bozovic-msft

azure-sql/managed-instance/synchronize-vnet-dns-servers-setting-on-virtual-cluster.md

@@ -0,0 +1,56 @@
+---
+title: Synchronize virtual network DNS servers setting on SQL Managed Instance virtual cluster
+description: Learn how synchronize virtual network DNS servers setting on SQL Managed Instance virtual cluster.
+services: sql-database
+ms.service: sql-managed-instance
+author: srdan-bozovic-msft
+ms.author: srbozovi
+ms.date: 01/17/2021
+---
+
+# Synchronize virtual network DNS servers setting on SQL Managed Instance virtual cluster
+[!INCLUDE[appliesto-sqlmi](../includes/appliesto-sqlmi.md)]
+
+This article explains when and how to synchronize virtual network DNS servers setting on SQL Managed Instance virtual cluster.
+
+## When do you need to synchronize DNS server settings on SQL Managed Instance virtual cluster
+
+There are a few scenarios (for example, db mail, linked servers to other SQL Server instances in your cloud or hybrid environment) that require private host names to be resolved from SQL Managed Instance. In this case, you need to configure a custom DNS inside Azure. See [Configure a custom DNS for Azure SQL Managed Instance](custom-dns-configure.md) for details.
+
+If this change is implemented after [virtual cluster](connectivity-architecture-overview.md#virtual-cluster-connectivity-architecture) hosting Managed Instance is created you'll need to synchronize DNS servers setting on the virtual cluster with the virtual network configuration.
+
+> [!IMPORTANT]
+> Synchronizing DNS servers setting will affect all of the Managed Instances hosted in the virtual cluster.
+
+## How to synchronize DNS servers setting on SQL Managed Instance virtual cluster
+
+### Azure RBAC permissions required
+
+User synchronizing DNS server configuration will need to have one of the following Azure roles:
+
+- Subscription Owner role, or
+- Managed Instance Contributor role, or
+- Custom role with the following permission:
+  - `Microsoft.Sql/virtualClusters/updateManagedInstanceDnsServers/action`
+
+### Using PowerShell
+
+Get virtual network where DNS servers setting has been updated.
+
+```powershell
+$ResourceGroup = 'enter resource group of virtual network'
+$VirtualNetworkName = 'enter virtual network name'
+$virtualNetwork = Get-AzVirtualNetwork -$ResourceGroup $ResourceGrou -Name $VirtualNetworkName
+```
+Use PowerShell command [Invoke-AzResourceAction](/powershell/module/az.resources/invoke-azresourceaction) to synchronize DNS servers configuration for all the virtual clusters in the subnet.
+
+```powershell
+Get-AzSqlVirtualCluster `
+    | where SubnetId -match $virtualNetwork.Id `
+    | select Id `
+    | Invoke-AzResourceAction -Action updateManagedInstanceDnsServers -Force
+```
+## Next steps
+
+- Learn more about configuring a custom DNS [Configure a custom DNS for Azure SQL Managed Instance](custom-dns-configure.md).
+- For an overview, see [What is Azure SQL Managed Instance?](sql-managed-instance-paas-overview.md).