Skip to content

connect-to-sql-server-when-system-administrators-are-locked-out.md

Latest commit

 

History

History
212 lines (135 loc) · 14.9 KB

connect-to-sql-server-when-system-administrators-are-locked-out.md

File metadata and controls

212 lines (135 loc) · 14.9 KB
title Connect to SQL Server when system administrators are locked out
description Learn how to regain access to SQL Server as a system administrator if you've been mistakenly locked out.
author rwestMSFT
ms.author randolphwest
ms.date 07/14/2022
ms.service sql
ms.subservice configuration
ms.topic conceptual
ms.custom contperf-fy20q4
helpviewer_keywords
sa account
connecting when locked out [SQL Server]
locked out [SQL Server]

Connect to SQL Server when system administrators are locked out

[!INCLUDE SQL Server]

This article describes how you can regain access to the [!INCLUDEssDEnoversion] as a system administrator if you've been locked out. A system administrator can lose access to an instance of [!INCLUDEssNoVersion] due to one of the following reasons:

  • All logins that are members of the sysadmin fixed server role have been removed by mistake.

  • All Windows Groups that are members of the sysadmin fixed server role have been removed by mistake.

  • The logins that are members of the sysadmin fixed server role are for individuals who have left the company or who aren't available.

  • The sa account is disabled or no one knows the password.

Resolution

In order to resolve your access issue, we recommend that you start the instance of [!INCLUDEssNoVersion] in single-user mode. This mode prevents other connections from occurring while you try to regain access. From here, you can connect to your instance of SQL Server and add your login to the sysadmin server role. Detailed steps for this solution are provided in the step-by-step-instructions section.

You can start an instance of [!INCLUDEssNoVersion] in single-user mode with either the -m or -f options from the command line. Any member of the computer's local Administrators group can then connect to the instance of [!INCLUDEssNoVersion] as a member of the sysadmin fixed server role.

When you start the instance in single-user mode, first stop the [!INCLUDEssNoVersion] Agent service. Otherwise, [!INCLUDEssNoVersion] Agent might connect first, taking the only available connection to the server and blocking you from logging in.

It's also possible for an unknown client application to take the only available connection before you're able to sign in. In order to prevent this from happening, you can use the -m option followed by an application name to limit connections to a single connection from the specified application. For example, starting [!INCLUDEssNoVersion] with -mSQLCMD limits connections to a single connection that identifies itself as the sqlcmd client program. To connect through the Query Editor in [!INCLUDEssManStudio], use -m"Microsoft SQL Server Management Studio - Query".

Important

Do not use -m with an application name as a security feature. Client applications specify the application name through the connection string settings, so it can easily be spoofed with a false name.

The following table summarizes the different ways to start your instance in single-user mode in the command line.

Option Description When to use
-m Limits connections to a single connection When there are no other users attempting to connect to the instance, or you aren't sure of the application name you're using to connect to the instance.
-mSQLCMD Limits connections to a single connection that must identify itself as the sqlcmd client program When you plan to connect to the instance with sqlcmd, and you want to prevent other applications from taking the only available connection.
-m"Microsoft SQL Server Management Studio - Query" Limits connections to a single connection that must identify itself as the Microsoft SQL Server Management Studio - Query application. When you plan to connect to the instance through the Query Editor in [!INCLUDEssManStudio] and you want to prevent other applications from taking the only available connection.
-f Limits connections to a single connection and starts the instance in minimal configuration When some other configuration is preventing you from starting.

Step-by-step instructions

For step-by-step instructions about how to start [!INCLUDEssNoVersion] in single-user mode, see Start SQL Server in Single-User Mode.

Use PowerShell

Option 1: Run the steps directly in an executable notebook via Azure Data Studio

Note

Before attempting to open this notebook, check that Azure Data Studio is installed on your local machine. To install, go to Learn how to install Azure Data Studio.

[!div class="nextstepaction"] Open Notebook in Azure Data Studio

Option 2: Follow the step manually

  1. Open a Windows PowerShell command - Run as an Administrator

  2. Set up service name and SQL Server instance, and Windows login variables. Replace these with values to match your environment

    If you have a default instance, use MSSQLSERVER without an instance name.

    $service_name = "MSSQL`$instancename"
$sql_server_instance = "machine_name\instance"
$login_to_be_granted_access = "[CONTOSO\PatK]"

  3. Stop SQL Server service so it can be restarted with single-user mode, using the following command:

    If you have a default instance, use MSSQLSERVER without an instance name.

    net stop $service_name

  4. Now start your SQL Server instance in a single user mode and only allow SQLCMD.exe to connect (/mSQLCMD)

    [!NOTE]
    Be sure to use upper-case SQLCMD

    If you have a default instance, use MSSQLSERVER without an instance name.

    net start $service_name /f /mSQLCMD

  5. Using sqlcmd execute a CREATE LOGIN command followed by ALTER SERVER ROLE command. This step assumes you've logged into Windows with an account that is a member of the Local Administrators group. This assumes you've replaced the domain and login names with the credentials you want to give sysadmin membership.

    If you have a default instance, use the name of the server.

    sqlcmd.exe -E -S $sql_server_instance -Q "CREATE LOGIN $login_to_be_granted_access FROM WINDOWS; ALTER SERVER ROLE sysadmin ADD MEMBER $login_to_be_granted_access; "

    [!NOTE]
    If you receive the following error, you must ensure no other SQLCMD has connected to SQL Server:
    Sqlcmd: Error: Microsoft ODBC Driver X for SQL Server : Login failed for user 'CONTOSO\BobD'. Reason: Server is in single user mode. Only one administrator can connect at this time..

  6. Mixed Mode (optional): If your SQL Server is running in mixed authentication mode, you can also:

    1. Grant the Sysadmin role membership to a SQL login. Execute code such as the following to create a new SQL Server authentication login that is a member of the sysadmin fixed server role. Replace "?j8:z$G=JE9" with a strong password of your choice.

      If you have a default instance, use the name of the server.

      $strong_password = "j8:zG=J?E9"
sqlcmd.exe -E -S $sql_server_instance -Q "CREATE LOGIN TempLogin WITH PASSWORD = '$strong_password'; ALTER SERVER ROLE sysadmin ADD MEMBER TempLogin; "

    2. Also, if your SQL Server is running in mixed authentication mode and you want to reset the password of an enabled sa account. Change the password of the sa account with the following syntax. Be sure to replace "j8:zG=J?E9" with a strong password of your choice:

      If you have a default instance, use the name of the server.

      $strong_password = "j8:zG=J?E9"
sqlcmd.exe -E -S $sql_server_instance -Q "ALTER LOGIN sa WITH PASSWORD = $strong_password; "

  7. Stop and restart your SQL Server instance in multi-user mode

    If you have a default instance, use MSSQLSERVER without an instance name.

    net stop $service_name
net start $service_name

Use SQL Server Configuration Manager and Management Studio (SSMS)

These instructions assume:

  • [!INCLUDEssNoVersion] is running on Windows 8 or higher. Slight adjustments for earlier versions of SQL Server or Windows are provided where applicable.

  • [!INCLUDEssManStudioFull] is installed on the computer.

Perform these instructions while logged in to Windows as a member of the local administrators group.

  1. From the Windows Start menu, right-click the icon for [!INCLUDEssNoVersion] Configuration Manager and choose Run as administrator to pass your administrator credentials to Configuration Manager.

  2. In [!INCLUDEssNoVersion] Configuration Manager, in the left pane, select SQL Server Services. In the right-pane, find your instance of [!INCLUDEssNoVersion]. (The default instance of [!INCLUDEssNoVersion] includes (MSSQLSERVER) after the computer name. Named instances appear in upper case with the same name that they have in Registered Servers.) Right-click the instance of [!INCLUDEssNoVersion], and then select Properties.

  3. On the Startup Parameters tab, in the Specify a startup parameter box, type -m and then select Add. (That's a dash then lower case letter m.)

    For some earlier versions of [!INCLUDEssNoVersion] there is no Startup Parameters tab. In that case, on the Advanced tab, double-click Startup Parameters. The parameters open up in a small window. Be careful not to change any of the existing parameters. At the very end, add a new parameter ;-m and then select OK. (That's a semi-colon then a dash then lower case letter m.)

  4. Select OK, and after the message to restart, right-click your server name, and then select Restart.

  5. After [!INCLUDEssNoVersion] has restarted, your server will be in single-user mode. Make sure that [!INCLUDEssNoVersion] Agent isn't running. If started, it will take your only connection.

  6. From the Windows Start menu, right-click the icon for [!INCLUDEssManStudio] and select Run as administrator. This will pass your administrator credentials to SSMS.

    For earlier versions of Windows, the Run as administrator option appears as a submenu.

    In some configurations, SSMS will attempt to make several connections. Multiple connections will fail because [!INCLUDEssNoVersion] is in single-user mode. Based on your scenario, perform one of the following actions.

    1. Connect with Object Explorer using Windows Authentication, which includes your Administrator credentials. Expand Security, expand Logins, and double-select your own login. On the Server Roles page, select sysadmin, and then select OK.

    2. Instead of connecting with Object Explorer, connect with a Query Window using Windows Authentication (which includes your Administrator credentials). (You can only connect this way if you didn't connect with Object Explorer.) Execute code such as the following to add a new Windows Authentication login that is a member of the sysadmin fixed server role. The following example adds a domain user named CONTOSO\PatK.

      CREATE LOGIN [CONTOSO\PatK] FROM WINDOWS;
ALTER SERVER ROLE sysadmin ADD MEMBER [CONTOSO\PatK];

    3. If your [!INCLUDEssNoVersion] is running in mixed authentication mode, connect with a Query Window using Windows Authentication (which includes your Administrator credentials). Execute code such as the following to create a new [!INCLUDEssNoVersion] authentication login that is a member of the sysadmin fixed server role.

      CREATE LOGIN TempLogin WITH PASSWORD = '************';
ALTER SERVER ROLE sysadmin ADD MEMBER TempLogin;

      [!WARNING]
      Replace ************ with a strong password.

    4. If your [!INCLUDEssNoVersion] is running in mixed authentication mode and you want to reset the password of the sa account, connect with a Query Window using Windows Authentication (which includes your Administrator credentials). Change the password of the sa account with the following syntax.

      ALTER LOGIN sa WITH PASSWORD = '************';

      [!WARNING]
      Replace ************ with a strong password.

  7. Close [!INCLUDEssManStudio].

  8. These next few steps change SQL Server back to multi-user mode. In [!INCLUDEssNoVersion] Configuration Manager, in the left pane, select SQL Server Services.

  9. In the right-pane, right-click the instance of [!INCLUDEssNoVersion], and then select Properties.

  10. On the Startup Parameters tab, in the Existing parameters box, select -m and then select Remove.

    For some earlier versions of [!INCLUDEssNoVersion] there is no Startup Parameters tab. In that case, on the Advanced tab, double-select Startup Parameters. The parameters open up in a small window. Remove the ;-m that you added earlier, and then select OK.

  11. Right-click your server name, and then select Restart. Make sure to start [!INCLUDEssNoVersion] Agent again if you stopped it before starting [!INCLUDEssNoVersion] in single-user mode.

Now you should be able to connect normally with one of the accounts that is now a member of the sysadmin fixed server role.

See also