Condividi tramite

  • Articolo

sp_ActiveDirectory_Obj (Transact-SQL)

Controlla la registrazione di un database MicrosoftSQL Server in Active Directory di Microsoft Windows.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

  • [ @Action = ] N'action'
    Specifica se l'oggetto Active Directory per la registrazione del database di SQL Server deve essere creato, aggiornato o eliminato. action è di tipo nvarchar(20) e il valore predefinito è N'create'.

    Valore

    Descrizione

    create

    Registra il database di SQL Server in Active Directory tramite la creazione di un oggetto MS-SQL-SQLDatabasenella directory. L'oggetto MS-SQL-SQLDatabase registra gli attributi del database durante l'esecuzione dell'azione. Se si specifica questo valore e il database è già registrato, l'oggetto viene aggiornato.

    update

    Aggiorna gli attributi registrati per il database in Active Directory tramite l'aggiornamento degli attributi registrati nell'oggetto MS-SQL-SQLDatabase in Active Directory.

    delete

    Rimuove la registrazione Active Directory per il database tramite l'eliminazione dell'oggetto MS-SQL_SQLDatabase da Active Directory.

  • [ @ObjType = ] N'database'
    Specifica che sp_ActiveDirectory_Obj esegue l'azione richiesta in un oggetto di database in Active Directory. N'database' è di tipo nvarchar(15) e il valore predefinito è N'database'. Si tratta dell'unico valore supportato.

  • [ @ObjName = ] N'database_name'
    Specifica il nome del database di cui viene eseguita l'azione di registrazione. database_name è di tipo sysname ed è obbligatorio specificare un valore. database_name deve corrispondere al nome di un database esistente nell'istanza di SQL Server in cui viene eseguita la stored procedure sp_ActiveDirectory_Obj. database_name deve essere conforme alle regole relative agli identificatori.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Nessuno

Osservazioni

Per poter registrare uno dei database dell'istanza corrente di SQL Server, è prima necessario registrare l'istanza in Active Directory. Se si rimuove la registrazione dell'istanza da Active Directory, vengono rimosse tutte le registrazioni di database di tale istanza.

I database rappresentano l'unica entità che è possibile registrare in Active Directory direttamente tramite sp_ActiveDirectory_Obj. Per controllare la registrazione delle istanze di SQL Server in Active Directory, utilizzare sp_ActiveDirectory_SCP.

[!NOTA]

La registrazione Active Directory può essere modificata soltanto dall'account che l'ha creata. Quando si modifica l'account di protezione utilizzato dal servizio SQL Server, è necessario eliminare la registrazione Active Directory, modificare l'account del servizio e quindi ricreare la registrazione Active Directory.

Autorizzazioni

È richiesta l'appartenenza al ruolo predefinito del server sysadmin o al ruolo predefinito del database db_owner.

Esempi

Nell'esempio seguente viene registrato in Active Directory il database AdventureWorks dell'istanza corrente di SQL Server.

DECLARE @RetCode INT

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

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