SPFarm.Open-Methode (SqlConnectionStringBuilder, String, SecureString)
HINWEIS: Diese API ist veraltet.
Veraltet. Verwenden Sie die Open() -Methode, die eine Passphrase annimmt. Gibt ein Objekt, das eine remote-SPFarm darstellt.
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, _
username As String, _
password As SecureString _
) As SPFarm
'Usage
Dim connectionString As SqlConnectionStringBuilder
Dim username As String
Dim password As SecureString
Dim returnValue As SPFarm
returnValue = SPFarm.Open(connectionString, _
username, password)
[ObsoleteAttribute("Use the SPFarm.Open method that takes a passphrase.",
false)]
public static SPFarm Open(
SqlConnectionStringBuilder connectionString,
string username,
SecureString password
)
Parameter
connectionString
Typ: System.Data.SqlClient.SqlConnectionStringBuilderEnthält die Verbindungszeichenfolge für die Konfigurationsdatenbank der Farm Remoteserver an.
username
Typ: System.StringEnthält den Benutzernamen für das Serverfarmkonto, das für die Verwaltungswebsite Anwendungsdienst Pool und den Timerdienst verwendet wird.
password
Typ: System.Security.SecureStringEnthält das Kennwort für das Serverfarmkonto, das für die Verwaltungswebsite Anwendungsdienst Pool und den Timerdienst verwendet wird. Der Text ist für den Datenschutz verschlüsselt, wenn es Computerspeicher verwendet und aus gelöscht wird, wenn es nicht mehr benötigt wird.
Rückgabewert
Typ: Microsoft.SharePoint.Administration.SPFarm
Ein SPFarm -Objekt, die remote-Server-Farm darstellt.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| InvalidOperationException | Veraltet. Verwenden Sie die Open() -Methode, die eine Passphrase annimmt. |
| ArgumentNullException | SqlConnectionStringBuilder -Objekt ist ein Nullverweis (Nothing in Visual Basic). |
Hinweise
Den Benutzernamen und das Kennwort, die bereitgestellt werden, 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, dieses Anrufs mit einer Ausnahme vom Typ SqlException und eine Meldung angezeigt fehl schlägt, dass ist dies der Fall.