(String, String, String, String, 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 ( _
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
'Uso
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
)
Parámetros
strDatabaseServer
Tipo: System.StringUna cadena que especifica el servidor de base de datos.
strDatabaseName
Tipo: System.StringUna cadena que contiene el nombre de la base de datos.
strUserName
Tipo: System.StringUna cadena que contiene el nombre de usuario para la cuenta de administrador. El parámetro es necesario únicamente si se usa la autenticación de SQL.
strPassword
Tipo: System.StringUna cadena que contiene la contraseña de la cuenta de administrador. El parámetro es necesario únicamente si se usa la autenticación de SQL.
uri
Tipo: System.UriUn 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.Booleantrue para crear un grupo de aplicaciones; en caso contrario, false.
strAppPoolId
Tipo: System.StringUna cadena que especifica un identificador para el grupo de aplicaciones.
bConfigurableAppPoolAccount
Tipo: System.Booleantrue para indicar que la cuenta de grupo de aplicaciones es configurable; en caso contrario, false.
- strAppPoolUserName
Tipo: System.StringUna cadena que especifica un nombre de usuario para la cuenta de administrador del grupo de aplicaciones. Si es true, especifique uno de los siguientes valores:
NetworkService
LocalService
LocalSystem
strAppPoolPassword
Tipo: System.StringUna cadena que especifica una contraseña para la cuenta de administrador del grupo de aplicaciones. El parámetro 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 y agrega un sitio de nivel superior.
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);
}
}