Partager via


SPGlobalAdmin.ExtendVirtualServer - Méthode (String, String, String, String, Uri, Boolean, String, Boolean, String, String)

Remarque : cette API est désormais obsolète.

Utilisez la classe SPWebApplicationBuilder pour créer une nouvelle application Web à la place. (Dans Windows SharePoint Services 2.0 la méthode ExtendVirtualServer étendue d'un site Web de Internet Information Services (IIS) avec SharePoint Foundationet est conservée pour la compatibilité ascendante.)

Espace de noms :  Microsoft.SharePoint.Administration
Assembly :  Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
<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
'Utilisation
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
)

Paramètres

  • strDatabaseServer
    Type : System.String

    Chaîne qui spécifie le serveur de base de données.

  • strDatabaseName
    Type : System.String

    Chaîne qui contient le nom de la base de données.

  • strUserName
    Type : System.String

    Chaîne qui contient le nom d'utilisateur pour le compte administrateur. Le paramètre est nécessaire uniquement si l'authentification SQL est utilisée.

  • strPassword
    Type : System.String

    Chaîne qui contient le mot de passe pour le compte administrateur. Le paramètre est nécessaire uniquement si l'authentification SQL est utilisée.

  • uri
    Type : System.Uri

    Un URI absolu pour le serveur virtuel, ce qui inclut le nom d'hôte, le numéro de port et l'informations d'URL personnalisées. Par exemple, si l'URI est https://Server_Name:Port_Number/Sample_URL, lorsque le serveur virtuel est étendu Sample_URL est inclus dans le cadre de l'URL.

  • bCreateNewAppPool
    Type : System.Boolean

    true pour créer un pool d'applications ; dans le cas contraire, false.

  • strAppPoolId
    Type : System.String

    Chaîne qui spécifie un ID pour le pool d'applications.

  • bConfigurableAppPoolAccount
    Type : System.Boolean

    true pour indiquer que le compte de pool d'applications est configurable ; dans le cas contraire, false.

  • strAppPoolUserName
    Type : System.String
    • Chaîne qui spécifie un nom d'utilisateur du compte d'administrateur du pool d'applications. Si est true, spécifiez l'une des valeurs suivantes :

    • NetworkService

    • LocalService

    • LocalSystem

  • strAppPoolPassword
    Type : System.String

    Chaîne qui spécifie un mot de passe du compte d'administrateur du pool d'applications. Le paramètre est requis uniquement si le paramètre est défini sur true.

Valeur renvoyée

Type : Microsoft.SharePoint.Administration.SPVirtualServer
Objet SPVirtualServer qui représente le serveur virtuel étendu.

Remarques

Avant d'étendre un serveur virtuel à l'aide de la méthode ExtendVirtualServer , vous pouvez personnaliser le fichier web.config qui sera placé sur le serveur en créant un fichier XML qui complètent le fichier web.config sur le serveur en cours. Pour plus d'informations, consultez Working with web.config Files in Windows SharePoint Services.

Exemples

L'exemple de code suivant permet d'étendre un serveur virtuel donné et ajoute un site de niveau supérieur.

Cet exemple suppose la présence d'un digest du formulaire d'administration dans le fichier .cs ou .vb. Pour plus d'informations sur la validation de la sécurité, consultez 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); 
    }
}

Voir aussi

Référence

SPGlobalAdmin classe

SPGlobalAdmin - Membres

ExtendVirtualServer - Surcharge

Microsoft.SharePoint.Administration - Espace de noms