Skip to content

Latest commit

 

History

History
66 lines (50 loc) · 2.67 KB

File metadata and controls

66 lines (50 loc) · 2.67 KB
title sp_denylogin (Transact-SQL) | Microsoft Docs
ms.custom
ms.date 03/14/2017
ms.prod sql
ms.prod_service database-engine
ms.reviewer
ms.technology system-objects
ms.topic language-reference
f1_keywords
sp_denylogin_TSQL
sp_denylogin
dev_langs
TSQL
helpviewer_keywords
sp_denylogin
ms.assetid db80f152-e8af-4303-95b6-3a3a7b664374
author stevestein
ms.author sstein

sp_denylogin (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-xxxx-xxxx-xxx-md]

Prevents a Windows user or Windows group from connecting to an instance of [!INCLUDEssNoVersion].

Important

[!INCLUDEssNoteDepFutureAvoid] Use ALTER LOGIN instead.

Topic link icon Transact-SQL Syntax Conventions

Syntax

  
sp_denylogin [ @loginame = ] 'login'   

Arguments

[ @loginame = ] 'login_ ' Is the name of a Windows user or group. login is sysname, with no default.

Return Code Values

0 (success) or 1 (failure)

Remarks

sp_denylogin denies CONNECT SQL permission to the server-level principal mapped to the specified Windows user or Windows group. If the server principal does not exist, it will be created. The new principal will be visible in the sys.server_principals (Transact-SQL) catalog view.

sp_denylogin cannot be executed within a user-defined transaction.

Permissions

Requires membership in the sysadmin fixed server role.

Examples

The following example shows how to use sp_denylogin to prevent Windows user CORPORATE\GeorgeV from connecting to the server.

EXEC sp_denylogin 'CORPORATE\GeorgeV';  

See Also

sp_grantlogin (Transact-SQL)
Security Stored Procedures (Transact-SQL)
ALTER LOGIN (Transact-SQL)
System Stored Procedures (Transact-SQL)