sp_ActiveDirectory_Obj (Transact-SQL)

語法

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

引數

• [ @Action = ] N'action'
  指定要建立、更新或刪除註冊 SQL Server 資料庫的 Active Directory 物件。action 是 nvarchar(20)，預設值是 N'create'。

  值	描述
  create	在目錄中建立 MS-SQL-SQLDatabase物件，以便在 Active Directory 中註冊 SQL Server 資料庫。當執行這個動作時，MS-SQL-SQLDatabase 物件會記錄資料庫的屬性。如果您指定了這個值，但資料庫已註冊過，就會更新物件。
  update	更新 Active Directory 中 MS-SQL-SQLDatabase 物件所記錄的屬性來重新整理資料庫在 Active Directory 中所註冊的屬性。
  delete	從 Active Directory 中刪除 MS-SQL_SQLDatabase 物件來移除資料庫的 Active Directory 註冊。

• [ @ObjType = ] N'database'
  指定 sp_ActiveDirectory_Obj 在 Active Directory 中的資料庫物件上，執行所要求的動作。N'database' 是 nvarchar(15)，預設值是 N'database'。這是唯一支援的值。

• [ @ObjName = ] N'database_name'
  指定註冊動作所執行的資料庫名稱。database_name 是 sysname，您必須指定一個值。database_name 必須指定執行 sp_ActiveDirectory_Obj 的 SQL Server 執行個體中之資料庫名稱。database_name 必須符合識別碼的規則。

傳回碼值

0 (成功) 或 1 (失敗)

結果集

無

備註

您必須先在 Active Directory 中註冊目前的 SQL Server 執行個體，之後，才能註冊執行個體中的任何資料庫。如果您從 Active Directory 中移除執行個體的註冊，也會移除這個執行個體中各資料庫的所有註冊。

資料庫是您可以利用 sp_ActiveDirectory_Obj 直接在 Active Directory 中註冊的實體。若要控制 Active Directory 中的 SQL Server 執行個體註冊，請使用 sp_ActiveDirectory_SCP。

權限

需要系統管理員 (sysadmin) 固定伺服器角色或 db_owner 固定資料庫角色中的成員資格。

範例

下面範例會在 Active Directory 中，註冊目前 SQL Server 執行個體的 AdventureWorks2008R2 資料庫。

DECLARE @RetCode INT

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

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

請參閱

參考

概念