Compartir a través de

  • Artículo

sp_ActiveDirectory_Obj (Transact-SQL)

Controla el registro de una base de datos de Microsoft SQL Server en Microsoft Windows Active Directory.

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

Sintaxis

sp_ActiveDirectory_Obj [ @Action = N'action'
     [ , [@ObjType = ] N'database' ]
          , [ @ObjName = ] N'database_name'

Argumentos

  • [ @Action = ] N'action'
    Especifica si el objeto de Active Directory que registra la base de datos 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 base de datos de SQL Server en Active Directory mediante la creación de un objeto MS-SQL-SQLDatabaseen el directorio. El objeto MS-SQL-SQLDatabase registra los atributos de la base de datos cuando se lleva a cabo la acción. Si se especifica este valor y la base de datos ya está registrada, el objeto se actualiza.

    update

    Actualiza los atributos de la base de datos registrados en Active Directory mediante la actualización de los atributos registrados en el objeto MS-SQL-SQLDatabase en Active Directory.

    delete

    Quita el registro de la base de datos en Active Directory al eliminar el objeto MS-SQL-SQLDatabase de Active Directory.

  • [ @ObjType = ] N'database'
    Especifica que sp_ActiveDirectory_Obj realice la acción solicitada en un objeto de base de datos en Active Directory. N'database' es de tipo nvarchar(15) y su valor predeterminado es N'database'. Es el único valor admitido.

  • [ @ObjName = ] N'database_name'
    Especifica el nombre de la base de datos en la que se realiza la acción de registro; database_name es de tipo sysname y debe especificarse un valor. database_name debe especificar el nombre de una base de datos existente en la instancia de SQL Server en la que se ejecuta sp_ActiveDirectory_Obj. database_name debe cumplir las reglas de los identificadores.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Ninguno

Comentarios

La instancia actual de SQL Server debe estar registrada en Active Directory para poder registrar cualquiera de las bases de datos de la instancia. Si quita el registro de la instancia de Active Directory, se quitarán también todos los registros de las bases de datos de dicha instancia.

Las bases de datos son las únicas entidades que se pueden registrar en Active Directory utilizando sp_ActiveDirectory_Obj directamente. Para controlar el registro de las instancias de SQL Server en Active Directory, utilice sp_ActiveDirectory_SCP.

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 al rol fijo de servidor sysadmin o al rol fijo de base de datos db_owner.

Ejemplos

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

DECLARE @RetCode INT

EXEC @RetCode = sp_ActiveDirectory_Obj @Action = N'create',
     @ObjType = N'database',
     @ObjName = N'AdventureWorks2008R2';

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