在子網路之間移動 Azure SQL 受控執行個體

用於選擇執行個體子網路的選項位於 Azure 入口網站的 [網路] 窗格。 您選取子網路並儲存變更時，執行個體移動作業就會啟動。

移動作業的第一個步驟是準備部署所需的目的地子網路，這可能需要幾分鐘的時間。 子網路就緒後，執行個體移動管理作業就會啟動，並在 Azure 入口網站中顯示。

可在 Azure 入口網站的 [概觀] 窗格中監視執行個體移動作業。 選取通知即可開啟另一個窗格，其中包含目前步驟、步驟總數和作業取消按鈕的相關資訊。

在與目的地子網路所在位置相同的虛擬網路中建立子網路之後，請使用 Azure PowerShell 命令 Set-AzSqlInstance 移動執行個體。 如果想要使用現有的子網路，請在 PowerShell 命令中提供該子網路名稱。

本節中的範例 PowerShell 命令會準備執行個體部署的目的地子網路，並移動受控執行個體。

使用下列 PowerShell 命令來指定您的參數：

### PART 1 - DEFINE PARAMETERS

#Generating basic parameters
$currentSubscriptionID = 'subscription-id'
$sqlMIResourceGroupName = 'resource-group-name-of-sql-mi'
$sqlMIName = 'sql-mi-name'
$sqlMIResourceVnetName = 'vnet-name-of-sql-mi'
$destinationSubnetName = 'name-of-the-destination-subnet-for-sql-mi'

如果您的子網路已部署執行個體，請略過此命令。 如果要使用新的子網路，請使用下列 Azure PowerShell 命令來準備子網路：

### PART 2 - PREPARE DESTINATION SUBNET

#Loading the url of script used for preparing the subnet for SQL MI deployment
$scriptUrlBase = 'https://raw.githubusercontent.com/Microsoft/sql-server-samples/master/samples/manage/azure-sql-db-managed-instance/delegate-subnet'

#Generating destination subnet parameters
$parameters = @{
    subscriptionId = $currentSubscriptionID
    resourceGroupName = $sqlMIResourceGroupName
    virtualNetworkName = $sqlMIResourceVnetName
    subnetName = $destinationSubnetName
}

#Initiating subnet prepartion script
Invoke-Command -ScriptBlock ([Scriptblock]::Create((iwr ($scriptUrlBase+'/delegateSubnet.ps1?t='+ [DateTime]::Now.Ticks)).Content)) -ArgumentList $parameters

下列 Azure PowerShell 命令會將執行個體移至來源子網路：

### PART 3 - MOVE INSTANCE TO THE NEW SUBNET

Set-AzSqlInstance -Name $sqlMIName -ResourceGroupName $sqlMIResourceGroupName `
-SubnetId "/subscriptions/$currentSubscriptionID/resourceGroups/$sqlMIResourceGroupName/providers/Microsoft.Network/virtualNetworks/$sqlMIResourceVnetName/subnets/$destinationSubnetName"

下列 Azure PowerShell 命令會移動執行個體，也會提供監視進度的方法：

###PART 3 EXTENDED - MOVE INSTANCE AND MONITOR PROGRESS

# Extend the Set-AzSqlInstance command with -AsJob -Force parameters to be able to monitor the progress or proceed with script execution as moving the instance to another subnet is long running operation 
Set-AzSqlInstance -Name $sqlMIName -ResourceGroupName $sqlMIResourceGroupName `
-SubnetId "/subscriptions/$currentSubscriptionID/resourceGroups/$sqlMIResourceGroupName/providers/Microsoft.Network/virtualNetworks/$sqlMIResourceVnetName/subnets/$destinationSubnetName" -AsJob -Force

$operationProgress = Get-AzSqlInstanceOperation -ManagedInstanceName $sqlMIName -ResourceGroupName $sqlMIResourceGroupName
#checking the operation step status
Write-Host "Checking the ongoing step" -ForegroundColor Yellow
$operationProgress.OperationSteps.StepsList

使用 Azure CLI az sql mi update 命令將您的執行個體移至另一個子網路。

將子網路識別碼指定為 --subnet 屬性，或將虛擬網路名稱指定為 --vnet-name 屬性且將子網路名稱 --subnet 指定為屬性，以此方式提供目的地。

下列範例會指定子網路識別碼，將受控執行個體移至另一個子網路：

az sql mi update -g myResourceGroup -n mySqlManagedInstance --subnet /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVirtualNetworkName/subnets/destinationSubnetName

下列範例會指定虛擬網路名稱和子網路名稱，將受控執行個體移至另一個子網路：

az sql mi update -g myResourceGroup -n mySqlManagedInstance --vnet-name myVirtualNetworkName --subnet destinationSubnetName

使用下列命令來監視管理作業的進度：

az sql mi op list -g myResourceGroup --mi mySqlManagedInstance