(Uri, Boolean, String, Boolean, String, String) del método SPGlobalAdmin.ExtendVirtualServer

NOTA: esta API está ahora obsoleta.

Use la clase SPWebApplicationBuilder para crear una nueva aplicación Web en su lugar. (En Windows SharePoint Services 2.0 el método ExtendVirtualServer extendido de un sitio Web de Internet Information Services (IIS) con SharePoint Foundation y se mantiene por compatibilidad con versiones anteriores.)

Espacio de nombres:  Microsoft.SharePoint.Administration
Ensamblado:  Microsoft.SharePoint (en Microsoft.SharePoint.dll)

Sintaxis

'Declaración
<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
'Uso
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
)

Parámetros

• uri
  Tipo: System.Uri

  Un identificador URI absoluto para el servidor virtual, que incluye el nombre de host, el número de puerto y la información de dirección URL personalizada. Por ejemplo, si el URI es https://Server_Name:Port_Number/Sample_URL, cuando el servidor virtual se ha ampliado el Sample_URL se incluye como parte de la dirección URL.

• bCreateNewAppPool
  Tipo: System.Boolean

  true para crear un grupo de aplicaciones; en caso contrario, false.

• strAppPoolId
  Tipo: System.String

  Una cadena que especifica un identificador para el grupo de aplicaciones.

• bConfigurableAppPoolAccount
  Tipo: System.Boolean

  true para indicar que la cuenta de grupo de aplicaciones es configurable; en caso contrario, false.

• strAppPoolUserName
  Tipo: System.String
  • Una cadena que especifica un nombre de usuario para la cuenta de administrador del grupo de aplicaciones. El parámetro strAppPoolUserName es necesario sólo si el parámetro bConfigurableAppPoolAccount se establece en true.

• strAppPoolPassword
  Tipo: System.String

  Una cadena que especifica una contraseña para la cuenta de administrador del grupo de aplicaciones. El parámetro strAppPoolPassword es necesario sólo si el parámetro se establece en true.

Valor devuelto

Tipo: Microsoft.SharePoint.Administration.SPVirtualServer
Un objeto SPVirtualServer que representa el servidor virtual extendido.

Comentarios

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.

Ejemplos

En el ejemplo de código siguiente se amplía un servidor virtual especificado, se agrega una base de datos de contenido para el servidor virtual y se crea un sitio de nivel superior.

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

Vea también

Referencia

clase SPGlobalAdmin

Miembros SPGlobalAdmin

Sobrecarga ExtendVirtualServer

Espacio de nombres Microsoft.SharePoint.Administration