Метод SPGlobalAdmin.ExtendVirtualServer (String, String, String, String, Uri, Boolean, String, Boolean, String, String)

Статья
05/13/2015

Примечание. Этот API устарел.

Класс SPWebApplicationBuilder используется для создания нового веб-приложения, вместо этого. (В Windows SharePoint Services 2.0 метод ExtendVirtualServer расширенные Internet Information Services (IIS) веб-сайта с помощью SharePoint Foundation и сохраняется для обеспечения обратной совместимости.)

Пространство имен: Microsoft.SharePoint.Administration
Сборка: Microsoft.SharePoint (в Microsoft.SharePoint.dll)

Синтаксис

'Декларация
<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
'Применение
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
)

Параметры

strDatabaseServer
Тип: System.String

Строка, которая указывает сервер базы данных.

strDatabaseName
Тип: System.String

Строка, содержащая имя базы данных.

strUserName
Тип: System.String

Строка, содержащая имя пользователя для учетной записи администратора. Параметр является обязательным только в том случае, если используется проверка подлинности SQL.

strPassword
Тип: System.String

Строка, содержащая пароль для учетной записи администратора. Параметр является обязательным только в том случае, если используется проверка подлинности SQL.

uri
Тип: System.Uri

Абсолютный URI для виртуального сервера, включая имя узла, номер порта и настраиваемые сведения URL-адрес. Например если URI является https://Server_Name:Port_Number/Sample_URL, при расширении виртуального сервера Sample_URL включены в URL-адрес.

bCreateNewAppPool
Тип: System.Boolean

true для создания пула приложений; в противном случае — false.

strAppPoolId
Тип: System.String

Строка, которая указывает идентификатор пула приложений.

bConfigurableAppPoolAccount
Тип: System.Boolean

true , чтобы указать, что учетная запись пула приложений может быть настроен; в противном случае — false.

strAppPoolUserName
Тип: System.String
- Строка, которая указывает имя пользователя для учетной записи администратора пула приложений. Если будет true, укажите одно из следующих значений:
- NetworkService
- LocalService
- LocalSystem

strAppPoolPassword
Тип: System.String

Строка, определяющая пароль для учетной записи администратора пула приложений. Параметр является обязательным только в том случае, если параметр имеет значение true.

Возвращаемое значение

Тип: Microsoft.SharePoint.Administration.SPVirtualServer
Объект SPVirtualServer , который представляет расширенного виртуального сервера.

Замечания

Before extending a virtual server by using the ExtendVirtualServer method, you can customize the web.config file that will be placed on the server by creating an XML file that supplements the web.config file on the current server. For information, see Working with web.config Files in Windows SharePoint Services.

Примеры

В следующем примере кода расширяет указанный виртуальный сервер и добавляет сайта верхнего уровня.

This example assumes the presence of an administrative form digest in the .cs or .vb file. For information on security validation, see 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); 
    }
}

См. также

Справочные материалы

SPGlobalAdmin класс

Элементы SPGlobalAdmin

Перегрузка ExtendVirtualServer

Пространство имен Microsoft.SharePoint.Administration

Поделиться через