Condividi tramite

  • Articolo

sp_ActiveDirectory_SCP (Transact-SQL)

Controlla la registrazione di un'istanza di MicrosoftSQL Server in Active Directory di Microsoft Windows. Le azioni di sp_ActiveDirectory_SCP sono sempre disponibili per l'istanza connessa di SQL Server.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

sp_ActiveDirectory_SCP [ @Action = ] N'action'

Argomenti

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

    Valore

    Descrizione

    create

    Registra l'istanza di SQL Server in Active Directory tramite la creazione di un oggetto MS-SQL-SQLServer nella directory. L'oggetto MS-SQL-SQLServer registra gli attributi dell'istanza di SQL Server durante l'esecuzione dell'azione. Se si specifica questo valore e l'istanza è già registrata, l'oggetto viene aggiornato.

    update

    Aggiorna in Active Directory gli attributi registrati per l'istanza corrente di SQL Server e gli attributi registrati nell'oggetto MS-SQL-SQLServer in Active Directory.

    delete

    Rimuove la registrazione Active Directory per l'istanza corrente di SQL Server. Elimina l'oggetto MS-SQL_SQLServer da Active Directory e rimuove le registrazioni di qualsiasi database e pubblicazione dell'istanza.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Nessuno

Osservazioni

Dopo avere registrato un'istanza di SQL Server in Active Directory, è possibile utilizzare sp_ActiveDirectory_Obj per registrare qualsiasi database nell'istanza e sp_addpublication o sp_addmergepublication per registrare le pubblicazioni.

[!NOTA]

La registrazione Active Directory può essere modificata solo 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.

Esempi

Nell'esempio seguente viene registrata l'istanza corrente di SQL Server in Active Directory.

DECLARE @RetCode INT

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

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