SPFarm.Open-Methode (SqlConnectionStringBuilder, String, String)
HINWEIS: Diese API ist veraltet.
Gibt eine remote-Server-Farm basierend auf der angegebenen Verbindungszeichenfolge, Benutzernamen und das Kennwort an. Veraltet. Verwenden Sie die Open() -Methode, die eine Passphrase annimmt.
Namespace: Microsoft.SharePoint.Administration
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
<ObsoleteAttribute("Use the SPFarm.Open method that takes a passphrase.", _
False)> _
Public Shared Function Open ( _
connectionString As SqlConnectionStringBuilder, _
user As String, _
password As String _
) As SPFarm
'Usage
Dim connectionString As SqlConnectionStringBuilder
Dim user As String
Dim password As String
Dim returnValue As SPFarm
returnValue = SPFarm.Open(connectionString, _
user, password)
[ObsoleteAttribute("Use the SPFarm.Open method that takes a passphrase.",
false)]
public static SPFarm Open(
SqlConnectionStringBuilder connectionString,
string user,
string password
)
Parameter
connectionString
Typ: System.Data.SqlClient.SqlConnectionStringBuilderEin SqlConnectionStringBuilder -Objekt, das die Verbindungszeichenfolge für die Konfigurationsdatenbank der Farm Remoteserver enthält.
user
Typ: System.StringEin String -Objekt, das den Benutzernamen für das Serverfarmkonto enthält, die für die Verwaltungswebsite Anwendungsdienst Pool und den Timerdienst verwendet wird.
password
Typ: System.StringEin String -Objekt, das Kennwort für das Serverfarmkonto enthält, die für die Verwaltungswebsite Anwendungsdienst Pool und den Timerdienst verwendet wird.
Rückgabewert
Typ: Microsoft.SharePoint.Administration.SPFarm
Ein SPFarm -Objekt, die remote-Server-Farm darstellt.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentNullException | SqlConnectionStringBuilder -Objekt ist ein Nullverweis (Nothing in Visual Basic). |
Hinweise
Wenn ein Objekt [T:System:String] vertraulichen Informationen wie ein Kennwort enthält, ist ein Risiko dar, die die Informationen möglicherweise angezeigt, nachdem sie verwendet wird, weil die Anwendung die Daten aus dem Computerspeicher löschen kann. Sie können den Parameter farmPassword als ein SecureString -Objekt, das es vor versehentlichen oder böswilligen Belichtung schützen bereitstellen. Finden Sie unter Open.
Den Benutzernamen und das Kennwort, die Sie bereitstellen müssen ein Domänenkonto zugeordnet werden.
Diese Methode benötigt Zugriff auf die Konfigurationsdatenbank Remotefarmen. Wenn die aktuelle Benutzer oder Prozess Identität verfügt nicht über die Berechtigung für den Datenbankzugriff oder wenn der lokale Computer nicht im gleichen Netzwerk wie die Datenbank vorhanden ist, schlägt fehl dieses Anrufs mit einem mit einer Ausnahme vom Typ SqlException und eine Meldung angezeigt, dass dies der Fall ist.