sp_ActiveDirectory_SCP (Transact-SQL)

Controla o registro de uma instância do Microsoft SQL Server no Microsoft Windows Active Directory. As ações de sp_ActiveDirectory_SCP sempre se aplicam à instância conectada do SQL Server.

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

Sintaxe

sp_ActiveDirectory_SCP [ @Action = ] N'action'

Argumentos

  • [ @Action = ] N'action'
    Especifica se o objeto do Active Directory que está registrando a instância do SQL Server deve ser criada, atualizada ou excluída. action é nvarchar(20) com um padrão de N'create'.

    Valor

    Descrição

    create

    Registra a instância do SQL Server no Active Directory, criando um objeto MS-SQL-SQLServer no diretório. O objeto MS-SQL-SQLServer registra os atributos da instância do SQL Server no momento em que a ação é executada. Se você especificar esse valor e a instância já estiver registrada, o objeto será atualizado.

    update

    Atualiza os atributos registrados para a instância atual do SQL Server no Active Directory. Atualiza os atributos registrados no objeto MS-SQL-SQLServer no Active Directory.

    delete

    Remove o registro da instância atual do SQL Server do Active Directory. Exclui o objeto MS-SQL_SQLServer do Active Directory. Também remove os registros de qualquer banco de dados e publicações na instância.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

Depois de registrar uma instância do SQL Server no Active Directory, você pode usar sp_ActiveDirectory_Obj para registrar qualquer um dos bancos de dados na instância, e usar sp_addpublication ou sp_addmergepublication para registrar publicações.

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.

Exemplos

O exemplo a seguir registra a instância atual do SQL Server no Active Directory.

DECLARE @RetCode INT

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

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