SPGlobalAdmin.ExtendVirtualServer-Methode (String, String, String, String, Uri, Boolean, String, Boolean, String, String)
HINWEIS: Diese API ist veraltet.
Verwenden Sie die SPWebApplicationBuilder -Klasse, um stattdessen eine neue Webanwendung erstellen. (In Windows SharePoint Services 2.0 die ExtendVirtualServer -Methode eine Website (Internet Information Services, IIS) mit SharePoint Foundationerweitert und wird für die Abwärtskompatibilität beibehalten.)
Namespace: Microsoft.SharePoint.Administration
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
<ObsoleteAttribute("SPGlobalAdmin.ExtendVirtualServer is obsolete. To create a new Web application, use the SPWebApplicationBuilder class.", _
False)> _
Public Function ExtendVirtualServer ( _
strDatabaseServer As String, _
strDatabaseName As String, _
strUserName As String, _
strPassword As String, _
uri As Uri, _
bCreateNewAppPool As Boolean, _
strAppPoolId As String, _
bConfigurableAppPoolAccount As Boolean, _
strAppPoolUserName As String, _
strAppPoolPassword As String _
) As SPVirtualServer
'Usage
Dim instance As SPGlobalAdmin
Dim strDatabaseServer As String
Dim strDatabaseName As String
Dim strUserName As String
Dim strPassword As String
Dim uri As Uri
Dim bCreateNewAppPool As Boolean
Dim strAppPoolId As String
Dim bConfigurableAppPoolAccount As Boolean
Dim strAppPoolUserName As String
Dim strAppPoolPassword As String
Dim returnValue As SPVirtualServer
returnValue = instance.ExtendVirtualServer(strDatabaseServer, _
strDatabaseName, strUserName, strPassword, _
uri, bCreateNewAppPool, strAppPoolId, _
bConfigurableAppPoolAccount, strAppPoolUserName, _
strAppPoolPassword)
[ObsoleteAttribute("SPGlobalAdmin.ExtendVirtualServer is obsolete. To create a new Web application, use the SPWebApplicationBuilder class.",
false)]
public SPVirtualServer ExtendVirtualServer(
string strDatabaseServer,
string strDatabaseName,
string strUserName,
string strPassword,
Uri uri,
bool bCreateNewAppPool,
string strAppPoolId,
bool bConfigurableAppPoolAccount,
string strAppPoolUserName,
string strAppPoolPassword
)
Parameter
strDatabaseServer
Typ: System.StringEine Zeichenfolge, die den Datenbankserver angibt.
strDatabaseName
Typ: System.StringEine Zeichenfolge, die den Namen der Datenbank enthält.
strUserName
Typ: System.StringEine Zeichenfolge, die den Benutzernamen für das Administratorkonto enthält. Der Parameter ist erforderlich, nur, wenn SQL-Authentifizierung verwendet wird.
strPassword
Typ: System.StringEine Zeichenfolge, die das Kennwort für das Administratorkonto enthält. Der Parameter ist erforderlich, nur, wenn SQL-Authentifizierung verwendet wird.
uri
Typ: System.UriEin absoluter URI für den virtuellen Server, der der Hostname, Portnummer und benutzerdefinierte URL Informationen enthält. Wenn der URI https://Server_Name:Port_Number/istSample_URL, wenn der virtuelle Server Sample_URL erweitert ist Teil der URL.
bCreateNewAppPool
Typ: System.Booleantrue zum Erstellen eines Anwendungspools; andernfalls false.
strAppPoolId
Typ: System.StringEine Zeichenfolge, die eine ID für den Anwendungspool angibt.
bConfigurableAppPoolAccount
Typ: System.Booleantrue , um anzugeben, dass das Anwendungspoolkonto konfiguriert werden kann; andernfalls false.
- strAppPoolUserName
Typ: System.StringEine Zeichenfolge, die einen Benutzernamen für das Administratorkonto des Anwendungspools angibt. Wenn true ist, geben Sie einen der folgenden Werte:
NetworkService
LocalService
LocalSystem
strAppPoolPassword
Typ: System.StringEine Zeichenfolge, die ein Kennwort für das Administratorkonto des Anwendungspools angibt. Der Parameter ist erforderlich, nur, wenn der Parameter auf truefestgelegt ist.
Rückgabewert
Typ: Microsoft.SharePoint.Administration.SPVirtualServer
Ein SPVirtualServer -Objekt, das den erweiterten virtuellen Server darstellt.
Hinweise
Vor dem Erweitern eines virtuellen Servers mithilfe der ExtendVirtualServer -Methode, können Sie die Datei "Web.config" anpassen, die auf dem Server durch Erstellen einer XML-Datei, die als die Datei web.config auf dem aktuellen Server Ergänzung aufgenommen werden. Informationen finden Sie unter Working with web.config Files in Windows SharePoint Services.
Beispiele
Im folgenden Codebeispiel wird einen angegebenen virtuellen Server erweitert und fügt eine Website auf oberster Ebene.
In diesem Beispiel wird das Vorhandensein einer administrativen Formulardigest in der CS- oder VB-Datei vorausgesetzt. Informationen zu Webseiten-Sicherheitsüberprüfung finden Sie unter Security Validation and Making Posts to Update Data.
Dim globalAdmin As New SPGlobalAdmin()
Dim vServers As SPVirtualServerCollection = globalAdmin.VirtualServers
If vServers(3).State = SPVirtualServerState.NeedExtend Then
Dim uri As New System.Uri(vServers(3).Url.ToString())
Try
Dim spVServer As SPVirtualServer = _
globalAdmin.ExtendVirtualServer("Database_Server", _
"Database_Name", Nothing, Nothing, uri, False, "StsAppPool1", _
False, Nothing, Nothing)
Dim sites As SPSiteCollection = spVServer.Sites
sites.Add(spVServer.Url.ToString(), "DOMAIN\User_Alias", _
"Email_Address")
Catch ex As System.Exception
Response.Write(ex.Message + ControlChars.Lf + _
ControlChars.Lf + ex.StackTrace)
End Try
End If
SPGlobalAdmin globalAdmin = new SPGlobalAdmin();
SPVirtualServerCollection vServers = globalAdmin.VirtualServers;
if (vServers[3].State == SPVirtualServerState.NeedExtend)
{
System.Uri uri = new System.Uri(vServers[3].Url.ToString());
try
{
SPVirtualServer spVServer =
globalAdmin.ExtendVirtualServer("Database_Server",
"Database_Name", null, null, uri, false, "StsAppPool1",
false, null, null);
SPSiteCollection sites = spVServer.Sites;
sites.Add(spVServer.Url.ToString(), "DOMAIN\\User_Alias",
"Email_Address");
}
catch (System.Exception ex)
{
Response.Write(ex.Message + "\n\n" + ex.StackTrace);
}
}