• Artículo

sp_ActiveDirectory_SCP (Transact-SQL)

Controla el registro de una instancia de Microsoft SQL Server en Microsoft Windows Active Directory. Las acciones de sp_ActiveDirectory_SCP siempre se aplican a la instancia conectada de SQL Server.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

sp_ActiveDirectory_SCP [ @Action = ] N'action'

Argumentos

  • [ @Action = ] N'action'
    Especifica si el objeto de Active Directory que registra la instancia de SQL Server se debe crear, actualizar o eliminar. action es de tipo nvarchar(20) y su valor predeterminado es N'create'.

    Valor

    Descripción

    create

    Registra la instancia de SQL Server en Active Directory mediante la creación de un objeto MS-SQL-SQLServer en el directorio. El objeto MS-SQL-SQLServer registra los atributos de la instancia de SQL Server cuando se lleva a cabo la acción. Si especifica este valor y la instancia ya está registrada, el objeto se actualiza.

    update

    Actualiza los atributos de la instancia actual de SQL Server registrados en Active Directory. Actualiza los atributos registrados en el objeto MS-SQL-SQLServer en Active Directory.

    delete

    Quita el registro en Active Directory de la instancia actual de SQL Server. Elimina el objeto MS-SQL-SQLServer de Active Directory. Quita además los registros de las bases de datos y publicaciones de la instancia.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Ninguno

Comentarios

Después de registrar una instancia de SQL Server en Active Directory, puede usar sp_ActiveDirectory_Obj para registrar cualquiera de las bases de datos de la instancia y puede usar sp_addpublication o sp_addmergepublication para registrar las publicaciones.

Nota

El registro en Active Directory sólo puede modificarlo la cuenta que lo ha creado. Si cambia la cuenta de seguridad que utiliza el servicio SQL Server, elimine el registro de Active Directory, cambie la cuenta de servicio y vuelva a crear el registro de Active Directory.

Permisos

Debe pertenecer a la función fija de servidor sysadmin.

Ejemplos

En el ejemplo siguiente se registra la instancia actual de SQL Server en Active Directory.

DECLARE @RetCode INT

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

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