Instance.RegisterLocal Method (String, String)

Registers the instance of Notification Services locally and, if the Microsoft Windows service does not exist, installs the Windows service that runs the Notification Services engine.

命名空間: Microsoft.SqlServer.Management.Nmo
組件: Microsoft.SqlServer.Smo (in microsoft.sqlserver.smo.dll)

語法

'宣告
Public Sub RegisterLocal ( _
    serviceUserName As String, _
    servicePassword As String _
)

public void RegisterLocal (
    string serviceUserName,
    string servicePassword
)

public:
void RegisterLocal (
    String^ serviceUserName, 
    String^ servicePassword
)

public void RegisterLocal (
    String serviceUserName, 
    String servicePassword
)

public function RegisterLocal (
    serviceUserName : String, 
    servicePassword : String
)

參數

• serviceUserName
  A String specifying the Windows user name for the instance of Notification Services.

• servicePassword
  A String specifying the password for the user.

備註

重要事項：
Secure any executable and source code that contains passwords.

For information about the permissions required by the Windows service, see 為 Notification Services 的執行個體設定 Windows 帳戶 and 為 Notification Services 的執行個體設定 SQL Server 權限.

範例

The following examples show how to call a method that configures an instance and its applications, and then create, register, and enable that instance:

// Set Database Engine instance and 
// Notification Services object
server = new smo.Server(sqlServer);
notificationServices = server.NotificationServices;

// Determine if the instance already exists. If so, exit.
if (server.NotificationServices.Instances.Contains(
    instanceName))
{
    Console.WriteLine("Instance exists and will be deleted.");
    myInstance = notificationServices.Instances[instanceName];
    DeleteInstance(myInstance);
}

// Call ConfigureInstance method to configure the instance
// and define the application(s).
myInstance = ConfigureInstance(notificationServices);

// Create the instance
Console.WriteLine("Creating instance...");
myInstance.Create();

//Optional: Export an Instance Configuration File (ICF)
Console.WriteLine("Exporting ICF...");
myInstance.Export(@"C:\NS\Full", true);

// Register and enable the instance
Console.WriteLine("Registering instance...");
myInstance.RegisterLocal(serviceUserName, servicePassword);
Console.WriteLine("Enabling instance...");
myInstance.Enable();
Console.WriteLine("Done.");

' Set Database Engine server and 
' Notification Services object
server = New smo.Server(sqlServer)
notificationServices = server.NotificationServices

' Determine if the instance already exists. If so, exit.
If server.NotificationServices.Instances.Contains( _
  instanceName) Then
    Console.WriteLine( _
        "Instance exists and will be deleted.")
    myInstance = notificationServices.Instances( _
        instanceName)
    DeleteInstance(myInstance)
End If

' Call ConfigureInstance method to configure the instance
' and define the application(s).
myInstance = ConfigureInstance(notificationServices)

' Create the instance
Console.WriteLine("Creating instance...")
myInstance.Create()

'Optional: Export an Instance Configuration File (ICF)
Console.WriteLine("Exporting ICF...")
myInstance.Export("C:\NS\Full", True)

' Register and enable the instance
Console.WriteLine("Registering instance...")
myInstance.RegisterLocal(serviceUserName, servicePassword)
Console.WriteLine("Enabling instance...")
myInstance.Enable()
Console.WriteLine("Done.")

執行緒安全性

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.

平台

開發平台

如需受支援的平台清單，請參閱＜安裝 SQL Server 2005 的硬體和軟體需求＞。

目標平台

如需受支援的平台清單，請參閱＜安裝 SQL Server 2005 的硬體和軟體需求＞。

請參閱

參考

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

其他資源

保全檔案與資料夾
部署 Notification Services
更新註冊資訊