Program PowerShell dla aliasu DNS w usłudze 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 parametry połączenia

Aby połączyć logiczny serwer SQL, klient, taki jak SQL Server Management Studio (SSMS) może podać alias DNS nazwy zamiast prawdziwej nazwy serwera. W poniższym przykładowym ciągu serwera alias any-unique-alias-name zastępuje pierwszy węzeł rozdzielany kropką w ciągu serwera 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 rozpoczyna się od przypisania wartości literału do kilku zmiennych.

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

Program 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 skonfigurowaną do odwoływania się z serwera 1 do serwera 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 polecenia 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;

Interfejs wiersza polecenia platformy Azure

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 odwoływania się z serwera 1 do serwera 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