Метод SPGlobalAdmin.ExtendVirtualServer (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 ( _
    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 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
)

Параметры

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
- Строка, которая указывает имя пользователя для учетной записи администратора пула приложений. Параметр strAppPoolUserName необходим только в том случае, если параметр bConfigurableAppPoolAccount имеет значение true.

strAppPoolPassword
Тип: System.String

Строка, определяющая пароль для учетной записи администратора пула приложений. Параметр strAppPoolPassword необходим только в том случае, если параметр имеет значение 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.

Примеры

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

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

См. также

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

SPGlobalAdmin класс

Элементы SPGlobalAdmin

Перегрузка ExtendVirtualServer

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

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