Compartilhar via


sp_ActiveDirectory_Obj (Transact-SQL)

Controla o registro de um banco de dados Microsoft SQL Server no Microsoft Windows Active Directory.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

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

Argumentos

  • [ @Action = ] N'action'
    Especifica se o objeto no Active Directory que registra o banco de dados SQL Server será criado, atualizado ou excluído. action é nvarchar(20) com um padrão de N'create.

    Valor

    Descrição

    create

    Registra o banco de dados SQL Server no Active Directory criando um objeto MS-SQL-SQLDatabaseno diretório. O objeto MS-SQL-SQLDatabase registra os atributos do banco de dados no momento em que a ação é executada. Se você especificar esse valor e o banco de dados já estiver registrado, o objeto será atualizado.

    update

    Atualiza os atributos registrados para o banco de dados no Active Directory atualizando os atributos registrados no objeto MS-SQL-SQLDatabase no Active Directory.

    delete

    Remove o registro do Active Directory para o banco de dados excluindo o objeto MS-SQL_SQLDatabase do Active Directory.

  • [ @ObjType = ] N'database'
    Especifica que sp_ActiveDirectory_Obj executa a ação solicitada em um objeto de banco de dados no Active Directory. **N' '**database é nvarchar(15), com um padrão de N'database. Esse é o único valor com suporte.

  • @ ObjName = ] **N'**database_name
    Especifica o nome do banco de dados para o qual a ação de registro é executada. database_name é sysnamee você deve especificar um valor. database_name devem especificar o nome de um banco de dados que existe na instância de SQL Server no qual sp_ActiveDirectory_Obj é executado. database_name devem estar em conformidade com as regras para identificadores.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

A instância atual de SQL Server deve ser registrada no Active Directory antes de você poder registrar quaisquer dos bancos de dados na instância. Se você remover o registro da instância do Active Directory, todos os registros de bancos de dados nessa instância também serão removidos.

Os bancos de dados são as únicas entidades que você pode registrar no Active Directory usando sp_ActiveDirectory_Obj diretamente. Para controlar o registro de instâncias de SQL Server no Active Directory, use sp_ActiveDirectory_SCP.

ObservaçãoObservação

O registro de Active Directory pode ser modificado apenas pela conta que o criou. Ao alterar a conta de segurança usada pelo serviço do SQL Server, exclua o registro do Active Directory, altere a conta de serviço e, em seguida, crie o registro do Active Directory novamente.

Permissões

Requer associação na função de servidor fixa sysadmin ou na função de banco de dados fixa db_owner.

Exemplos

O exemplo a seguir registra no Active Directory, o banco de dados AdventureWorks2008R2 da instância atual de SQL Server.

DECLARE @RetCode INT

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

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