sys.xp_grantlogin(Transact-SQL)

適用対象:SQL Server

WINDOWS グループまたはユーザーに SQL Server へのアクセスを許可します。

重要

この機能は、 SQL Serverの将来のバージョンで削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。 CREATE LOGIN を代わりに使用します。

Transact-SQL 構文表記規則

構文

sys.xp_grantlogin
    [ @loginame = ] N'loginame'
    [ , [ @logintype = ] 'logintype' ]
[ ; ]

引数

[ @loginame = ] N'loginame'

追加する Windows ユーザーまたはグループの名前。 Windows ユーザーまたはグループは、 <domain>\<user>形式で Windows ドメイン名で修飾する必要があります。 @loginamesysname で、既定値はありません。

[ @logintype = ] 「logintype

アクセス権が付与されているログインのセキュリティ レベル。 @logintypevarchar(5) で、既定値は NULL です。 adminのみを指定できます。 adminが指定されている場合、@loginameには SQL Server へのアクセスが許可され、固定サーバー ロールである sysadmin のメンバーとして追加されます。

リターン コードの値

0 (成功) または 1 (失敗)。

解説

xp_grantlogin は、拡張ストアド プロシージャではなくシステム ストアド プロシージャです。 xp_grantlogin sp_grantloginsp_addsrvrolememberを呼び出します。

アクセス許可

securityadmin固定サーバー ロールのメンバーシップが必要です。 @logintypeを変更するには、固定サーバー ロールsysadmin のメンバーシップが必要です。