sp_ActiveDirectory_Obj (Transact-SQL)
Controlla la registrazione di un database Microsoft SQL Server in Active Directory di Microsoft Windows.
.gif "Icona di collegamento a un argomento")
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 sicurezza 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 AdventureWorks2008R2 dell'istanza corrente di 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);