SPGlobalAdmin.ExtendVirtualServer-Methode (Uri, Boolean, String, Boolean, String, String)

Artikel
05/06/2015

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 ( _
    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 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(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(
    Uri uri,
    bool bCreateNewAppPool,
    string strAppPoolId,
    bool bConfigurableAppPoolAccount,
    string strAppPoolUserName,
    string strAppPoolPassword
)

Parameter

uri
Typ: System.Uri

Ein 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.Boolean

true zum Erstellen eines Anwendungspools; andernfalls false.

strAppPoolId
Typ: System.String

Eine Zeichenfolge, die eine ID für den Anwendungspool angibt.

bConfigurableAppPoolAccount
Typ: System.Boolean

true , um anzugeben, dass das Anwendungspoolkonto konfiguriert werden kann; andernfalls false.

strAppPoolUserName
Typ: System.String
- Eine Zeichenfolge, die einen Benutzernamen für das Administratorkonto des Anwendungspools angibt. Der Parameter strAppPoolUserName ist erforderlich, nur, wenn der Parameter bConfigurableAppPoolAccount auf truefestgelegt ist.

strAppPoolPassword
Typ: System.String

Eine Zeichenfolge, die ein Kennwort für das Administratorkonto des Anwendungspools angibt. Der Parameter strAppPoolPassword 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, fügt eine Inhaltsdatenbank für den virtuellen Server und erstellt eine Website auf oberster Ebene.

Dim globalAdmin As New SPGlobalAdmin()
Dim vServers As SPVirtualServerCollection = globalAdmin.VirtualServers

If vServers(5).State = SPVirtualServerState.NeedExtend Then
    Dim uri As New System.Uri(vServers(5).Url.ToString())

    Try
        Dim spVServer As SPVirtualServer = _
          globalAdmin.ExtendVirtualServer(uri, False, "StsAppPool1", _
          False, Nothing, Nothing)
        Dim dbCollection As SPContentDatabaseCollection = _
          spVServer.ContentDatabases
        dbCollection.Add("Database_Server", "Database_Name", Nothing, _
          Nothing, 1000, 1000, 0)

        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[5].State == SPVirtualServerState.NeedExtend)
{
    System.Uri uri =  new System.Uri(vServers[5].Url.ToString());

    try
    {
        SPVirtualServer spVServer = 
          globalAdmin.ExtendVirtualServer(uri, false, "StsAppPool1", 
          false, null, null);
        SPContentDatabaseCollection dbCollection = 
          spVServer.ContentDatabases;
        dbCollection.Add("Database_Server", "Database_Name", null, 
          null, 1000, 1000, 0);

        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); 
    }
}

Siehe auch

Referenz

SPGlobalAdmin Klasse

SPGlobalAdmin-Member

ExtendVirtualServer-Überladung

Microsoft.SharePoint.Administration-Namespace

Freigeben über