PowerShell a DNS-aliashoz az Azure SQL Database-be

A következőre vonatkozik: Azure SQL DatabaseAzure Synapse Analytics

Ez a cikk egy PowerShell-szkriptet tartalmaz, amely bemutatja, hogyan kezelheti az Azure SQL Database-t futtató SQL Server DNS-aliasát.

Megjegyzés:

Ez a cikk az Azure PowerShell Az modul vagy az Azure CLI használatára lett frissítve. Dönthet úgy is, hogy az AzureRM modult használja, amely továbbra is megkapja a hibajavításokat, legalább 2020 decemberéig.

Az Az modulról és az AzureRM kompatibilitásáról további információt az Azure PowerShell Az modul bemutatása című témakörben talál. A telepítési utasításokat az Azure PowerShell telepítése vagy az Azure CLI telepítése című témakörben találja.

DNS-alias a kapcsolati sztringben

Logikai SQL-kiszolgáló csatlakoztatásához egy ügyfél, például az SQL Server Management Studio (SSMS) a valódi kiszolgálónév helyett a DNS-aliasnevet is megadhatja. A következő példakiszolgálói sztringben az alias any-unique-alias-name a négy csomópont kiszolgálói sztringjének első ponthatárolt csomópontja helyébe lép:

<yourServer>.database.windows.net

Előfeltételek

Ha a cikkben megadott demo PowerShell-szkriptet szeretné futtatni, az alábbi előfeltételek érvényesek:

• Egy Azure-előfizetés és -fiók ingyenes próbaverziója, lásd : Azure-próbaverziók
• Két kiszolgáló

Példa

Az alábbi példakód a literális értékek több változóhoz való hozzárendelésével kezdődik.

A kód futtatásához szerkessze a helyőrző értékeket a rendszer valós értékeinek megfelelően.

PowerShell

A használt parancsmagok a következők:

• New-AzSqlServerDNSAlias: Létrehoz egy DNS-aliast az Azure SQL Database szolgáltatásrendszerben. Az alias az 1. kiszolgálóra hivatkozik.
• Get-AzSqlServerDNSAlias: Az 1. kiszolgálóhoz rendelt összes alias lekérése és listázása.
• Set-AzSqlServerDNSAlias: Módosítja az alias által hivatkozott kiszolgálónevet az 1. kiszolgálótól a 2. kiszolgálóig.
• Remove-AzSqlServerDNSAlias: Távolítsa el az aliast a 2. kiszolgálóról az alias nevével.

A telepítéshez vagy frissítéshez olvassa el az Azure PowerShell-modul telepítését ismertető cikket.

A verzió megkereséséhez használja Get-Module -ListAvailable Az a powershell_ise.exe fájlban.

$subscriptionName = '<subscriptionName>';
$sqlServerDnsAliasName = '<aliasName>';
$resourceGroupName = '<resourceGroupName>';  
$sqlServerName = '<sqlServerName>';
$resourceGroupName2 = '<resourceGroupNameTwo>'; # can be same or different than $resourceGroupName
$sqlServerName2 = '<sqlServerNameTwo>'; # must be different from $sqlServerName.

# login to Azure
Connect-AzAccount -SubscriptionName $subscriptionName;
$subscriptionId = Get-AzSubscription -SubscriptionName $subscriptionName;

Write-Host 'Assign an alias to server 1...';
New-AzSqlServerDnsAlias –ResourceGroupName $resourceGroupName -ServerName $sqlServerName `
    -Name $sqlServerDnsAliasName;

Write-Host 'Get the aliases assigned to server 1...';
Get-AzSqlServerDnsAlias –ResourceGroupName $resourceGroupName -ServerName $sqlServerName;

Write-Host 'Move the alias from server 1 to server 2...';
Set-AzSqlServerDnsAlias –ResourceGroupName $resourceGroupName2 -TargetServerName $sqlServerName2 `
    -Name $sqlServerDnsAliasName `
    -SourceServerResourceGroup $resourceGroupName -SourceServerName $sqlServerName `
    -SourceServerSubscriptionId $subscriptionId.Id;

Write-Host 'Get the aliases assigned to server 2...';
Get-AzSqlServerDnsAlias –ResourceGroupName $resourceGroupName2 -ServerName $sqlServerName2;

Write-Host 'Remove the alias from server 2...';
Remove-AzSqlServerDnsAlias –ResourceGroupName $resourceGroupName2 -ServerName $sqlServerName2 `
    -Name $sqlServerDnsAliasName;

Azure CLI

A használt parancsok a következők:

• az sql server dns-alias create: Létrehoz egy DNS-aliast egy kiszolgálóhoz. Az alias az 1. kiszolgálóra hivatkozik.
• az sql server dns-alias show: Az 1. kiszolgálóhoz rendelt összes alias lekérése és listázása.
• az sql Server dns-aliaskészlet: Módosítja az alias által hivatkozott kiszolgálónevet az 1. kiszolgálótól a 2. kiszolgálóig.
• az sql server dns-alias delete: Távolítsa el az aliast a 2. kiszolgálóról az alias nevével.

A telepítéssel vagy frissítéssel kapcsolatban lásd: Az Azure CLI telepítése.

$subscriptionName = '<subscriptionName>';
$sqlServerDnsAliasName = '<aliasName>';
$resourceGroupName = '<resourceGroupName>';  
$sqlServerName = '<sqlServerName>';
$resourceGroupName2 = '<resourceGroupNameTwo>'; # can be same or different than $resourceGroupName
$sqlServerName2 = '<sqlServerNameTwo>'; # must be different from $sqlServerName.

# login to Azure
az login -SubscriptionName $subscriptionName;
$subscriptionId = az account list[0].i -SubscriptionName $subscriptionName;

Write-Host 'Assign an alias to server 1...';
az sql server dns-alias create –-resource-group $resourceGroupName --server $sqlServerName `
    --name $sqlServerDnsAliasName;

Write-Host 'Get the aliases assigned to server 1...';
az sql server dns-alias show –-resource-group $resourceGroupName --server $sqlServerName;

Write-Host 'Move the alias from server 1 to server 2...';
az sql server dns-alias set –-resource-group $resourceGroupName2 --server $sqlServerName2 `
    --name $sqlServerDnsAliasName `
    --original-resource-group $resourceGroupName --original-server $sqlServerName `
    --original-subscription-id $subscriptionId.Id;

Write-Host 'Get the aliases assigned to server 2...';
az sql server dns-alias show –-resource-group $resourceGroupName2 --server $sqlServerName2;

Write-Host 'Remove the alias from server 2...';
az sql server dns-alias delete –-resource-group $resourceGroupName2 --server $sqlServerName2 `
    --name $sqlServerDnsAliasName;

További lépések

Az SQL Database DNS-alias funkciójának teljes ismertetését az Azure SQL Database DNS-aliasában talál.