Program PowerShell do konfigurowania aliasu DNS dla usługi Azure SQL Database

Dotyczy:Azure SQL DatabaseAzure Synapse Analytics

Ten artykuł zawiera skrypty do modułu Az programu Azure PowerShell lub Azure CLI, które pokazują, jak zarządzać aliasem DNS dla serwera logicznego Azure SQL, który hostuje Twoją bazę danych Azure SQL Database.

Alias DNS w łańcuchu połączenia

Aby połączyć logiczny serwer SQL, klient taki jak SQL Server Management Studio (SSMS) może podać zamiast nazwy prawdziwego serwera alias DNS. W poniższym przykładowym ciągu serwera alias any-unique-alias-name zastępuje pierwszy węzeł rozdzielany kropką w ciągu serwera składającym się z czterech węzłów.

<yourServer>.database.windows.net

Wymagania wstępne

Jeśli chcesz uruchomić demonstracyjny skrypt programu PowerShell podany w tym artykule, obowiązują następujące wymagania wstępne:

• Subskrypcja i konto platformy Azure, aby uzyskać bezpłatną wersję próbną, zobacz Wersje próbne platformy Azure
• Dwa serwery logiczne usługi Azure SQL
• Zainstaluj moduł Azure PowerShell lub interfejs wiersza polecenia platformy Azure .

Przykład

Poniższy przykład kodu zaczyna się od przypisania wartości literalnych do kilku zmiennych.

Aby uruchomić kod, zmodyfikuj wartości symboli zastępczych, aby dopasować rzeczywiste wartości w systemie.

PowerShell

Używane polecenia cmdlet są następujące:

• New-AzSqlServerDNSAlias: tworzy alias DNS w systemie usługi Azure SQL Database. Alias odnosi się do serwera 1.
• Get-AzSqlServerDNSAlias: Pobierz i wyświetl wszystkie aliasy przypisane do serwera 1.
• Set-AzSqlServerDNSAlias: modyfikuje nazwę serwera, do której alias jest skonfigurowany, zmieniając ją z serwera 1 na serwer 2.
• Remove-AzSqlServerDNSAlias: usuń alias z serwera 2, używając nazwy aliasu.

Aby przeprowadzić instalację lub uaktualnienie, zobacz Instalowanie modułu Azure PowerShell.

Użyj Get-Module -ListAvailable Az w powershell_ise.exe, aby znaleźć wersję.

$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

Używane polecenia są następujące:

• az sql server dns-alias create: Tworzy alias DNS dla serwera. Alias odnosi się do serwera 1.
• az sql server dns-alias show: Pobierz i wyświetl wszystkie aliasy przypisane do serwera 1.
• az sql server dns-alias set: modyfikuje nazwę serwera, do którego skonfigurowano alias, zmieniając z serwera 1 na serwer 2.
• az sql server dns-alias delete: Usuń alias z serwera 2, używając nazwy aliasu.

Aby zainstalować lub uaktualnić, zobacz Instalowanie interfejsu wiersza polecenia platformy Azure.

$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;

Powiązana zawartość

• alias DNS dla usługi Azure SQL Database