SPFarm.Create Method (SqlConnectionStringBuilder, String, SecureString)

NOTE: This API is now obsolete.

Creates a server farm and its associated configuration database, based on the specified user and password. This method is obsolete. Use the Create() method that takes a passphrase.

Namespace:  Microsoft.SharePoint.Administration
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Available in Sandboxed Solutions: No

Syntax

'Declaration
<ObsoleteAttribute("Use the SPFarm.Create method that takes a passphrase.",  _
    False)> _
Public Shared Function Create ( _
    configurationDatabase As SqlConnectionStringBuilder, _
    farmUser As String, _
    farmPassword As SecureString _
) As SPFarm
'Usage
Dim configurationDatabase As SqlConnectionStringBuilder
Dim farmUser As String
Dim farmPassword As SecureString
Dim returnValue As SPFarm

returnValue = SPFarm.Create(configurationDatabase, _
    farmUser, farmPassword)

[ObsoleteAttribute("Use the SPFarm.Create method that takes a passphrase.", 
    false)]
public static SPFarm Create(
    SqlConnectionStringBuilder configurationDatabase,
    string farmUser,
    SecureString farmPassword
)

Parameters

• configurationDatabase
  Type: System.Data.SqlClient.SqlConnectionStringBuilder

  A SqlConnectionStringBuilder object that specifies the connection string of the configuration database for the new server farm.

• farmUser
  Type: System.String

  A String object that contains the user name for the server farm account that is used for the administrative site application pool and timer service.

• farmPassword
  Type: System.Security.SecureString

  A SecureString object that contains the password for the server farm account that is used for the administrative site application pool and timer service. The text is encrypted for privacy when it is used, and deleted from computer memory when it is no longer needed.

Return Value

Type: Microsoft.SharePoint.Administration.SPFarm
An SPFarm object that represents the new server farm.

Remarks

The user name and password that you provide must be associated with a domain account.

See Also

Reference

SPFarm Class

SPFarm Members

Create Overload

Microsoft.SharePoint.Administration Namespace