Instance.RegisterLocal Method (String, String, Boolean, String, String, String, String, String)

Class-level method that registers the instance of Notification Services locally, optionally creating a local Windows service that runs the Notification Services engine.

Namespace: Microsoft.SqlServer.Management.Nmo
Assembly: Microsoft.SqlServer.Smo (in microsoft.sqlserver.smo.dll)

Syntax

'Declaration
Public Shared Sub RegisterLocal ( _
    instanceName As String, _
    databaseServer As String, _
    installService As Boolean, _
    sqlUserName As String, _
    sqlPassword As String, _
    serviceUserName As String, _
    servicePassword As String, _
    argumentKey As String _
)

public static void RegisterLocal (
    string instanceName,
    string databaseServer,
    bool installService,
    string sqlUserName,
    string sqlPassword,
    string serviceUserName,
    string servicePassword,
    string argumentKey
)

public:
static void RegisterLocal (
    String^ instanceName, 
    String^ databaseServer, 
    bool installService, 
    String^ sqlUserName, 
    String^ sqlPassword, 
    String^ serviceUserName, 
    String^ servicePassword, 
    String^ argumentKey
)

public static void RegisterLocal (
    String instanceName, 
    String databaseServer, 
    boolean installService, 
    String sqlUserName, 
    String sqlPassword, 
    String serviceUserName, 
    String servicePassword, 
    String argumentKey
)

public static function RegisterLocal (
    instanceName : String, 
    databaseServer : String, 
    installService : boolean, 
    sqlUserName : String, 
    sqlPassword : String, 
    serviceUserName : String, 
    servicePassword : String, 
    argumentKey : String
)

Parameters

• instanceName
  A String specifying the name of the instance of Notification Services.

• databaseServer
  A String specifying the instance of the Database Engine that hosts the instance and application databases. The default value is the local server.

• installService
  true to install the NS$instanceName Windows service; otherwise, false. If false, the sqlUsername, sqlPassword, serviceUsername, and servicePassword parameters are ignored.

• sqlUserName
  A String specifying a SQL Server login for the instance of Notification Services. Specify a value only if using SQL Server Authentication.

• sqlPassword
  A String specifying the password for the SQL Server login. Specify a value only if using SQL Server Authentication.

• serviceUserName
  A String specifying the Windows account for the Microsoft Windows service. If using Windows Authentication, the Windows service uses this account to connect to the Database Engine.

• servicePassword
  A String specifying the password for the serviceUsername.

• argumentKey
  The ArgumentKey for the instance of Notification Services. Used only of the EncryptArguments property is true.

Remarks

For information about the permissions required by the Windows service, see Configuring Windows Accounts for an Instance of Notification Services and Configuring SQL Server Permissions for an Instance of Notification Services.

Thread Safety

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

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

See Also

Reference

Instance Class
Instance Members
Microsoft.SqlServer.Management.Nmo Namespace

Other Resources

Securing Files and Folders
Deploying Notification Services
Updating Registry Information