Freigeben über


sp_ActiveDirectory_SCP (Transact-SQL)

Steuert die Registrierung einer Instanz von MicrosoftSQL Server in Microsoft Windows Active Directory. Die Aktionen von sp_ActiveDirectory_SCP werden immer auf die verbundene Instanz von SQL Server angewendet.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

sp_ActiveDirectory_SCP [ @Action = ] N'action'

Argumente

  • [ @Action = ] N'action'
    Gibt an, ob das Active Directory-Objekt, das die Instanz von SQL Server registriert, erstellt, aktualisiert oder gelöscht werden soll. action ist vom Datentyp nvarchar(20) und hat den Standardwert N'create'.

    Wert

    Beschreibung

    create

    Registriert die Instanz von SQL Server in Active Directory, indem ein MS-SQL-SQLServer-Objekt im Verzeichnis erstellt wird. Das MS-SQL-SQLServer-Objekt zeichnet die Attribute der Instanz von SQL Server zum Zeitpunkt der Ausführung der Aktion auf. Falls Sie diesen Wert angeben und die Instanz bereits registriert ist, wird das Objekt aktualisiert.

    update

    Aktualisiert die Attribute, die für die aktuelle Instanz von SQL Server in Active Directory registriert sind. Aktualisiert die Attribute, die im MS-SQL-SQLServer-Objekt in Active Directory erfasst sind.

    delete

    Entfernt die Active Directory-Registrierung für die aktuelle Instanz von SQL Server. Löscht das MS-SQL_SQLServer-Objekt aus Active Directory. Entfernt zudem die Registrierung aller Datenbanken und Veröffentlichungen in der Instanz.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Keine

Hinweise

Nach dem Registrieren einer Instanz von SQL Server in Active Directory können Sie sp_ActiveDirectory_Obj verwenden, um eine beliebige Datenbank in der Instanz zu registrieren, und Sie können sp_addpublication oder sp_addmergepublication verwenden, um Veröffentlichungen zu registrieren.

HinweisHinweis

Die Active Directory-Registrierung kann nur von dem Konto geändert werden, von dem es erstellt wurde. Wenn Sie das vom SQL Server-Dienst verwendete Sicherheitskonto ändern, müssen Sie die Active Directory-Registrierung löschen, das Dienstkonto ändern und dann die Active Directory-Registrierung erneut erstellen.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Serverrolle sysadmin.

Beispiele

Im folgenden Beispiel wird die aktuelle Instanz von SQL Server in Active Directory registriert.

DECLARE @RetCode INT

EXEC @RetCode = sp_ActiveDirectory_SCP @Action = N'create'

PRINT 'Return code = ' + CAST(@RetCode AS VARCHAR)