sys.sp_addremotelogin (Transact-SQL)

Gäller för:SQL Server

Lägger till ett nytt fjärrinloggnings-ID på den lokala servern. Detta möjliggör att fjärrservrar kan ansluta och utföra fjärrproceduranrop.

Important

Den här funktionen tas bort i en framtida version av SQL Server. Undvik att använda den här funktionen i nytt utvecklingsarbete och planera att ändra program som för närvarande använder den här funktionen. Använd länkade servrar och lagrade procedurer för länkad server i stället.

Transact-SQL syntaxkonventioner

Syntax

sys.sp_addremotelogin
    [ @remoteserver = ] N'remoteserver'
    [ , [ @loginame = ] N'loginame' ]
    [ , [ @remotename = ] N'remotename' ]
[ ; ]

Arguments

[ @remoteserver = ] N'remoteserver'

Namnet på den fjärrserver som fjärrinloggningen gäller för. @remoteserver är sysname, utan standard. Om endast @remoteserver anges mappas alla användare på @remoteserver till befintliga inloggningar med samma namn på den lokala servern. Servern måste vara känd av den lokala servern. Detta läggs till genom att använda sp_addserver. När användare på @remoteserver ansluter till den lokala servern som körs SQL Server för att köra en fjärrlagrad procedur, ansluter de som den lokala inloggningen som matchar deras egen inloggning på @remoteserver. @remoteserver är servern som initierar fjärrproceduranropet.

[ @loginame = ] N'loginame'

Användarens inloggnings-ID på den lokala instansen av SQL Server. @loginame är sysname, med standardvärdet .NULL @loginame måste redan finnas på den lokala instansen av SQL Server. Om @loginame anges mappas alla användare på @remoteserver till just den lokala inloggningen. När användare på @remoteserver ansluter till den lokala instansen av SQL Server för att köra en fjärrlagrad procedur, ansluter de som @loginame.

[ @remotename = ] N'remotename'

Användarens inloggnings-ID på fjärrservern. @remotename är sysname, med standardvärdet .NULL @remotename måste finnas på @remoteserver. Om @remotename anges mappas den specifika användaren @remotename till @loginame på den lokala servern. När @remotename på @remoteserver ansluter till den lokala instansen av SQL Server för att köra en fjärrlagrad procedur, ansluter den som @loginame. Inloggnings-ID:t för @remotename kan skilja sig från inloggnings-ID:t på fjärrservern, @loginame.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Remarks

För att köra distribuerade frågor, använd sp_addlinkedsrvlogin.

sp_addremotelogin Kan inte användas i en användardefinierad transaktion.

Permissions

Endast medlemmar av sysadmin- och securityadmin-fixedserverrollerna kan köra sp_addremotelogin.

Examples

A. Karta en till en

Följande exempel mappar fjärrnamn till lokala namn när fjärrservern ACCOUNTS och den lokala servern har samma användarinloggningar.

EXECUTE sp_addremotelogin 'ACCOUNTS';

B. Kartlägg många till en

Följande exempel skapar en post som mappar alla användare från fjärrservern ACCOUNTS till det lokala inloggnings-ID:t Albert.

EXECUTE sp_addremotelogin 'ACCOUNTS', 'Albert';

C. Använd explicit en-till-en-mappning

Följande exempel mappar en fjärrinloggning från fjärranvändaren Chris på fjärrservern ACCOUNTS till den lokala användaren salesmgr.

EXECUTE sp_addremotelogin 'ACCOUNTS', 'salesmgr', 'Chris';