使用 Azure SQL 进行仅限 Microsoft Entra 身份验证

必须使用 Azure CLI 2.14.2 或更高版本。

name 对应于服务器或实例名称的前缀（例如 myserver），resource-group 对应于服务器所属的资源（例如 myresource）。

Azure SQL Database

有关详细信息，请参阅 az sql server ad-only-auth。

在 SQL 数据库中启用或禁用

启用

az sql server ad-only-auth enable --resource-group myresource --name myserver

Disable

az sql server ad-only-auth disable --resource-group myresource --name myserver

检查 SQL 数据库中的状态

az sql server ad-only-auth get --resource-group myresource --name myserver

Azure SQL 托管实例

有关详细信息，请参阅 az sql mi ad-only-auth。

启用

az sql mi ad-only-auth enable --resource-group myresource --name myserver

Disable

az sql mi ad-only-auth disable --resource-group myresource --name myserver

检查 SQL 托管实例中的状态

az sql mi ad-only-auth get --resource-group myresource --name myserver

需要 Az.Sql 2.10.0 模块或更高版本。

ServerName 或 InstanceName 对应于服务器名称的前缀（例如 myserver 或 myinstance），ResourceGroupName 对应于服务器所属的资源（例如 myresource）。

Azure SQL Database

在 SQL 数据库中启用或禁用

启用

有关详细信息，请参阅 Enable-AzSqlServerActiveDirectoryOnlyAuthentication。 还可以运行 get-help Enable-AzSqlServerActiveDirectoryOnlyAuthentication -full。

Enable-AzSqlServerActiveDirectoryOnlyAuthentication -ServerName myserver -ResourceGroupName myresource

还可使用以下命令：

Get-AzSqlServer -ServerName myserver | Enable-AzSqlServerActiveDirectoryOnlyAuthentication

禁用

有关详细信息，请参阅 Disable-AzSqlServerActiveDirectoryOnlyAuthentication。

Disable-AzSqlServerActiveDirectoryOnlyAuthentication -ServerName myserver -ResourceGroupName myresource

检查 SQL 数据库中的状态

Get-AzSqlServerActiveDirectoryOnlyAuthentication  -ServerName myserver -ResourceGroupName myresource

还可使用以下命令：

Get-AzSqlServer -ServerName myserver | Get-AzSqlServerActiveDirectoryOnlyAuthentication

Azure SQL 托管实例

在 Azure SQL 托管实例中启用或禁用

启用

有关详细信息，请参阅 Enable-AzSqlInstanceActiveDirectoryOnlyAuthentication。

Enable-AzSqlInstanceActiveDirectoryOnlyAuthentication -InstanceName myinstance -ResourceGroupName myresource

还可使用以下命令：

Get-AzSqlInstance -InstanceName myinstance | Enable-AzSqlInstanceActiveDirectoryOnlyAuthentication

如需这些 PowerShell 命令的详细信息，请运行 get-help Enable-AzSqlInstanceActiveDirectoryOnlyAuthentication -full。

禁用

有关详细信息，请参阅 Disable-AzSqlInstanceActiveDirectoryOnlyAuthentication。

Disable-AzSqlInstanceActiveDirectoryOnlyAuthentication -InstanceName myinstance -ResourceGroupName myresource

检查 SQL 托管实例中的状态

Get-AzSqlInstanceActiveDirectoryOnlyAuthentication -InstanceName myinstance -ResourceGroupName myresource

还可使用以下命令：

Get-AzSqlInstance -InstanceName myinstance | Get-AzSqlInstanceActiveDirectoryOnlyAuthentication

需要定义以下参数：

• 在 Azure 门户中导航到“订阅”可以找到 <subscriptionId>。
• <myserver> 对应于服务器或实例名称的前缀（例如 myserver）。
• <myresource> 对应于服务器所属的资源（例如 myresource）

若要使用最新的 MSAL，请从 https://www.powershellgallery.com/packages/MSAL.PS 下载。

$subscriptionId = '<subscriptionId>'
$serverName = "<myserver>"
$resourceGroupName = "<myresource>"

Azure SQL Database

有关详细信息，请参阅服务器 - 仅限 Azure AD 身份验证 REST API 文档。

在 SQL 数据库中启用或禁用

启用

$body = @{ properties = @{ azureADOnlyAuthentication = 1 } } | ConvertTo-Json
Invoke-RestMethod -Uri "https://management.chinacloudapi.cn/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Sql/servers/$serverName/azureADOnlyAuthentications/default?api-version=2020-02-02-preview" -Method PUT -Headers $authHeader -Body $body -ContentType "application/json"

Disable

$body = @{ properties = @{ azureADOnlyAuthentication = 0 } } | ConvertTo-Json
Invoke-RestMethod -Uri "https://management.chinacloudapi.cn/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Sql/servers/$serverName/azureADOnlyAuthentications/default?api-version=2020-02-02-preview" -Method PUT -Headers $authHeader -Body $body -ContentType "application/json"

检查 SQL 数据库中的状态

Invoke-RestMethod -Uri "https://management.chinacloudapi.cn/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Sql/servers/$serverName/azureADOnlyAuthentications/default?api-version=2020-02-02-preview" -Method GET -Headers $authHeader  | Format-List

Azure SQL 托管实例

有关详细信息，请参阅 托管实例 - 仅限 Azure AD 身份验证 REST API 文档。

在 Azure SQL 托管实例中启用或禁用

启用

$body = @{   properties = @{  azureADOnlyAuthentication = 1 }  } | ConvertTo-Json 
Invoke-RestMethod -Uri "https://management.chinacloudapi.cn/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Sql/managedInstances/$serverName/azureADOnlyAuthentications/default?api-version=2020-02-02-preview" -Method PUT -Headers $authHeader -Body $body -ContentType "application/json"

Disable

$body = @{   properties = @{  azureADOnlyAuthentication = 0 }  } | ConvertTo-Json 
Invoke-RestMethod -Uri "https://management.chinacloudapi.cn/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Sql/managedInstances/$serverName/azureADOnlyAuthentications/default?api-version=2020-02-02-preview" -Method PUT -Headers $authHeader -Body $body -ContentType "application/json"

检查 SQL 托管实例中的状态

Invoke-RestMethod -Uri "https://management.chinacloudapi.cn/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Sql/managedInstances/$serverName/azureADOnlyAuthentications/default?api-version=2020-02-02-preview" -Method GET -Headers $authHeader  | Format-List

• 输入部署的 Microsoft Entra 管理员。 转到 Azure 门户并导航到“Microsoft Entra ID”资源可以找到“用户对象 ID”。 在“管理”下，选择“用户” 。 搜索要设置为 Azure SQL 服务器 Microsoft Entra 管理员的用户。 选择该用户，在其“配置文件”页下可以看到“对象 ID” 。
• 可以在“Microsoft Entra ID”资源的“概述”页面中找到租户 ID。

Azure SQL 数据库

启用

以下 ARM 模板在 Azure SQL 数据库中启用“仅限 Microsoft Entra 身份验证”。 若要禁用“仅限 Microsoft Entra 身份验证”，请将 azureADOnlyAuthentication 属性设置为 false。

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.1",
    "parameters": {
        "sqlServer_name": {
            "type": "String"
        },
        "aad_admin_name": {
            "type": "String"
        },
        "aad_admin_objectid": {
            "type": "String"
        },
        "aad_admin_tenantid": {
            "type": "String"
        }
    },
    "resources": [
        {
            "type": "Microsoft.Sql/servers/administrators",
            "apiVersion": "2020-02-02-preview",
            "name": "[concat(parameters('sqlServer_name'), '/ActiveDirectory')]",
            "properties": {
                "administratorType": "ActiveDirectory",
                "login": "[parameters('aad_admin_name')]",
                "sid": "[parameters('aad_admin_objectid')]",
                "tenantId": "[parameters('aad_admin_tenantId')]"
            }
        },        
        {
            "type": "Microsoft.Sql/servers/azureADOnlyAuthentications",
            "apiVersion": "2020-02-02-preview",
            "name": "[concat(parameters('sqlServer_name'), '/Default')]",
            "dependsOn": [
                "[resourceId('Microsoft.Sql/servers/administrators', parameters('sqlServer_name'), 'ActiveDirectory')]"
            ],
            "properties": {
                "azureADOnlyAuthentication": true
            }
        }
    ]
}

有关详细信息，请参阅 Microsoft.Sql servers/azureADOnlyAuthentications。

Azure SQL 托管实例

启用

以下 ARM 模板在 Azure SQL 托管实例中启用“仅限 Microsoft Entra 身份验证”。 若要禁用“仅限 Microsoft Entra 身份验证”，请将 azureADOnlyAuthentication 属性设置为 false。

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.1",
    "parameters": {
        "instance": {
            "type": "String"
        },
        "aad_admin_name": {
            "type": "String"
        },
        "aad_admin_objectid": {
            "type": "String"
        },
        "aad_admin_tenantid": {
            "type": "String"
        }
    },
    "resources": [
        {
            "type": "Microsoft.Sql/managedInstances/administrators",
            "apiVersion": "2020-02-02-preview",
            "name": "[concat(parameters('instance'), '/ActiveDirectory')]",
            "properties": {
                "administratorType": "ActiveDirectory",
                "login": "[parameters('aad_admin_name')]",
                "sid": "[parameters('aad_admin_objectid')]",
                "tenantId": "[parameters('aad_admin_tenantId')]"
            }
        },
        {
            "type": "Microsoft.Sql/managedInstances/azureADOnlyAuthentications",
            "apiVersion": "2020-02-02-preview",
            "name": "[concat(parameters('instance'), '/Default')]",
            "dependsOn": [
                "[resourceId('Microsoft.Sql/managedInstances/administrators', parameters('instance'), 'ActiveDirectory')]"
            ],
            "properties": {
                "azureADOnlyAuthentication": true
            }
        }
    ]
}

有关详细信息，请参阅 Microsoft.Sql managedInstances/azureADOnlyAuthentications。