sp_ActiveDirectory_Obj (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çã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);

Consulte também

Referência

Conceitos