RegisteredServer Class

Represents a SQL Serverregistered server.

Inheritance Hierarchy

System.Object
  Microsoft.SqlServer.Management.Sdk.Sfc.SfcInstance
    Microsoft.SqlServer.Management.RegisteredServers.RegisteredServer

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

Syntax

'Declaration
Public NotInheritable Class RegisteredServer _
    Inherits SfcInstance _
    Implements ISfcValidate, ISfcCreatable, ICreatable, ISfcAlterable,  _
    IAlterable, ISfcDroppable, IDroppable, ISfcRenamable, IRenamable,  _
    ISfcMovable
'Usage
Dim instance As RegisteredServer
public sealed class RegisteredServer : SfcInstance, 
    ISfcValidate, ISfcCreatable, ICreatable, ISfcAlterable, IAlterable, 
    ISfcDroppable, IDroppable, ISfcRenamable, IRenamable, ISfcMovable
public ref class RegisteredServer sealed : public SfcInstance, 
    ISfcValidate, ISfcCreatable, ICreatable, ISfcAlterable, IAlterable, 
    ISfcDroppable, IDroppable, ISfcRenamable, IRenamable, ISfcMovable
[<SealedAttribute>]
type RegisteredServer =  
    class
        inherit SfcInstance
        interface ISfcValidate
        interface ISfcCreatable
        interface ICreatable
        interface ISfcAlterable
        interface IAlterable
        interface ISfcDroppable
        interface IDroppable
        interface ISfcRenamable
        interface IRenamable
        interface ISfcMovable
    end
public final class RegisteredServer extends SfcInstance implements ISfcValidate, ISfcCreatable, ICreatable, ISfcAlterable, IAlterable, ISfcDroppable, IDroppable, ISfcRenamable, IRenamable, ISfcMovable

The RegisteredServer type exposes the following members.

Constructors

  Name Description
Public method RegisteredServer() Initializes a new instance of the RegisteredServer class with the default property values.
Public method RegisteredServer(String) Initializes a new instance of the RegisteredServer class that has the specified name.
Public method RegisteredServer(ServerGroup, String) Initializes a new instance of the RegisteredServer class with the specified name and server.

Top

Properties

  Name Description
Protected property AbstractIdentityKey Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Public property ConnectionString Gets or sets the connection string that is used to connect to the instance of SQL Server.
Public property ConnectionStringWithEncryptedPassword Gets the connection string that is used to connect to the instance of SQL Server that has the encrypted password. 
Public property CredentialPersistenceType Gets or sets how the logins and passwords are persisted on the registered server.
Public property CustomConnectionColorArgb Gets or sets the specified ARGB color of the RegisteredServer object.
Public property Description Gets the name of the registered server.
Public property ID Gets the ID value that uniquely identifies the registered server.
Public property IdentityKey Gets the key value that uniquely identifies the registered server.
Public property IsDropped Gets the Boolean value that specifies whether the registered server has been dropped or not.
Public property IsLocal Gets the Boolean value that specifies whether the registered server is local or not.
Public property Metadata Returns metadata about the instance and its domain. (Inherited from SfcInstance.)
Public property Name Gets the name of the RegisteredServer object.
Public property Parent Gets the parent of the RegisteredServer object.
Public property Properties Returns a collection instance properties. (Inherited from SfcInstance.)
Protected property PropertyStorageProvider Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Public property SecureConnectionString Gets or sets the secure string that is used to connect to the instance of SQL Server.
Public property ServerName Gets or sets the name of the server that is associated with the registered server.
Public property ServerType Gets or the kind of server that is associated with the registered server.
Protected property State Returns the state of the SfcInstance object. (Inherited from SfcInstance.)
Public property Urn Returns the uniform resource name of the SfcInstance object. (Inherited from SfcInstance.)
Public property UseCustomConnectionColor Gets or sets a value indicating whether the object uses a custom connection color.

Top

Methods

  Name Description
Public method Alter Updates any RegisteredServer object property changes on the instance of SQL Server. 
Protected method AlterImpl Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Protected method CheckObjectCreated Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Protected method CheckObjectState Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Public method Create Creates a registered server on the instance of SQL Server as defined by the RegisteredServer object.
Protected method CreateIdentityKey Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Protected method CreateImpl Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Public method Discover Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Public method Drop Drops the registered server.
Protected method DropImpl Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Public method Equals (Inherited from Object.)
Public method Export Exports the registered server to the specified file and using the given credential persistence type.
Protected method Finalize (Inherited from Object.)
Protected method GetChildCollection Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Public method GetConnectionObject Returns the SFC interface object that represents the connection to the instance of SQL Server.
Public method GetDomain Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Public method GetHashCode (Inherited from Object.)
Public methodStatic member GetObjectFactory Returns the SFC object factory for the RegisteredServer object.
Public method GetPropertySet Returns the set of properties for the SfcInstance object. (Inherited from SfcInstance.)
Public method GetType (Inherited from Object.)
Protected method GetTypeMetadataImpl Indicates the domains that override by returning the right TypeMetadata class directly. Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Protected method InitializeUIPropertyState Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Protected method MarkForDropImpl Returns a value that indicates the existing objects to be dropped. Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Protected method MarkRootAsConnected Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Protected method MemberwiseClone (Inherited from Object.)
Public method Move Specifies the RegisteredServer to move in a new location.
Protected method MoveImpl Indicates the new parent object to move in an instance. Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Protected method OnPropertyMetadataChanges Invoked whenever the effective value of any SfcInstance metadata is updated. (Inherited from SfcInstance.)
Protected method OnPropertyValueChanges Invoked whenever the effective value of any SfcInstance property is updated. (Inherited from SfcInstance.)
Protected method PostAlter Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Protected method PostCreate Indicates the default implementor that creates the execution result. Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Protected method PostDrop Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Protected method PostMove Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Protected method PostRename Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Public method Refresh Refreshes the object's properties by reading them from the server. (Inherited from SfcInstance.)
Public method Rename(String) Renames the RegisteredServer object by using the specified name.
Public method Rename(SfcKey) Specifies the RegisteredServer object to rename.
Protected method RenameImpl Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Protected method ResetKey Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Public method Serialize Serializes the instance to XML. (Inherited from SfcInstance.)
Public method ToString Returns a string representation of the instance Urn. (Inherited from SfcInstance.)
Protected method UpdateUIPropertyState Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Protected method Validate() Indicates the basic child object's validation. Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Public method Validate(String, array<Object[]) Validates the RegisteredServer object against the specified method and arguments.

Top

Events

  Name Description
Protected event propertyChanged Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Public event PropertyChanged CLS-compliant event for property changes. (Inherited from SfcInstance.)
Protected event propertyMetadataChanged Do not reference this member directly in your code. It supports the SQL Server infrastructure. (Inherited from SfcInstance.)
Public event PropertyMetadataChanged CLS-compliant event for property metadata changes. (Inherited from SfcInstance.)

Top

Explicit Interface Implementations

  Name Description
Explicit interface implemetationPrivate method ISfcAlterable.ScriptAlter Alters the properties of the base object if it has been changed. This class cannot be inherited.
Explicit interface implemetationPrivate method ISfcCreatable.ScriptCreate Produces the script to create this object to storage in its current state. This class cannot be inherited.
Explicit interface implemetationPrivate method ISfcDroppable.ScriptDrop Produces the script to drop this object from storage. This class cannot be inherited.
Explicit interface implemetationPrivate method ISfcMovable.Move Moves this object under the specified parent object and updates the storage to reflect the move. This class cannot be inherited.
Explicit interface implemetationPrivate method ISfcMovable.ScriptMove Produces the script to move this object under the specified parent object. This class cannot be inherited.
Explicit interface implemetationPrivate method ISfcRenamable.ScriptRename Renames the instance of ISfcScript identified by the key parameter. This class cannot be inherited.

Top

Remarks

This namespace, class, or member is supported only in version 2.0 of the Microsoft .NET Framework.

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are safe for multithreaded operations. Any instance members are not guaranteed to be thread safe.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.