Поделиться через

  • Статья

sp_ActiveDirectory_SCP (Transact-SQL)

Управляет регистрацией экземпляра Microsoft SQL Server в службе каталогов Active Directory Microsoft Windows. Действия процедуры sp_ActiveDirectory_SCP всегда применяются к подключенному экземпляру SQL Server.

Значок ссылки на разделСинтаксические обозначения в Transact-SQL

Синтаксис

sp_ActiveDirectory_SCP [ @Action = ] N'action'

Аргументы

  • [ @Action = ] N'action'
    Указывает, что необходимо сделать с объектом службы каталогов Active Directory, регистрирующей экземпляр SQL Server: создать, обновить или удалить. Аргумент action имеет тип nvarchar(20) и значение N'create' по умолчанию.

    Значение

    Описание

    create

    Регистрирует экземпляр SQL Server в службе Active Directory путем создания в каталоге объекта MS-SQL-SQLServer. Объект MS-SQL-SQLServer записывает атрибуты экземпляра SQL Server в момент выполнения действия. Если данное значение указывается, когда экземпляр уже зарегистрирован, объект обновляется.

    update

    Обновляет атрибуты, зарегистрированные для текущего экземпляра SQL Server в службе каталогов Active Directory. Обновляет атрибуты, записанные в объекте MS-SQL-SQLServer в службе каталогов Active Directory.

    delete

    Удаляет регистрацию в службе каталогов Active Directory для текущего экземпляра SQL Server. Удаляет объект MS-SQL_SQLServer из службы каталогов Active Directory. Также удаляет регистрации любых баз данных и публикаций в экземпляре.

Значения кодов возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Результирующие наборы

Нет

Замечания

После регистрации экземпляра SQL Server в службе каталогов Active Directory можно использовать процедуру sp_ActiveDirectory_Obj для регистрации любой из баз данных в экземпляре, также можно использовать процедуру sp_addpublication или sp_addmergepublication для регистрации публикаций.

ПримечаниеПримечание

Данные регистрации службы каталогов Active Directory могут быть изменены только той учетной записью, которой они были созданы. При изменении учетной записи безопасности, используемой службой SQL Server, удалите данные регистрации в службе Active Directory, измените учетную запись службы и заново создайте регистрацию в службе Active Directory.

Разрешения

Требует членства в предопределенной роли сервера sysadmin.

Примеры

В следующем примере текущий экземпляр SQL Server регистрируется в службе каталогов Active Directory.

DECLARE @RetCode INT

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

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