Server.ActiveDirectory Property

Note: This API is now obsolete.

Gets information about the Active Directory settings for the instance of SQL Server.

Namespace:  Microsoft.SqlServer.Management.Smo
Assembly:  Microsoft.SqlServer.Smo (in Microsoft.SqlServer.Smo.dll)

Syntax

'Declaration
<SfcObjectAttribute(SfcObjectRelationship.Object, SfcObjectCardinality.One)> _
<ObsoleteAttribute> _
Public ReadOnly Property ActiveDirectory As ServerActiveDirectory 
    Get
'Usage
Dim instance As Server 
Dim value As ServerActiveDirectory 

value = instance.ActiveDirectory
[SfcObjectAttribute(SfcObjectRelationship.Object, SfcObjectCardinality.One)]
[ObsoleteAttribute]
public ServerActiveDirectory ActiveDirectory { get; }
[SfcObjectAttribute(SfcObjectRelationship::Object, SfcObjectCardinality::One)]
[ObsoleteAttribute]
public:
property ServerActiveDirectory^ ActiveDirectory {
    ServerActiveDirectory^ get ();
}
[<SfcObjectAttribute(SfcObjectRelationship.Object, SfcObjectCardinality.One)>]
[<ObsoleteAttribute>]
member ActiveDirectory : ServerActiveDirectory
function get ActiveDirectory () : ServerActiveDirectory

Property Value

Type: Microsoft.SqlServer.Management.Smo.ServerActiveDirectory
A ServerActiveDirectory object that specifies the Active Directory settings for the database.

Remarks

The ActiveDirectory property points to a ServerActiveDirectory object, which can be used to register the instance of SQL Server in Active Directory.

When you call the Register method to add an instance of SQL Server to Active Directory, users can use Active Directory to find this instance of SQL Server. This is useful in large organizations with many instances of SQL Server.

Examples

Visual Basic

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Register the instance of SQL Server in the Active Directory directory service.
srv.ActiveDirectory.Register()

PowerShell

$srv = new-object Microsoft.SqlServer.Management.Smo.Server
$srv.ActiveDirectory.Register()

See Also

Reference

Server Class

Microsoft.SqlServer.Management.Smo Namespace

Other Resources

Connecting to an Instance of SQL Server

Disconnecting from an Instance of SQL Server

Managing Servers