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

Article
10/14/2015

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 ( _
    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 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
)

Paramètres

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. Le paramètre strAppPoolUserName est requis uniquement si le paramètre bConfigurableAppPoolAccount est défini sur true.

strAppPoolPassword
Type : System.String

Chaîne qui spécifie un mot de passe du compte d'administrateur du pool d'applications. Le paramètre strAppPoolPassword 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 étend un serveur virtuel donné, ajoute une base de données de contenu pour le serveur virtuel et de créer un site de niveau supérieur.

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

Voir aussi

Référence

SPGlobalAdmin classe

SPGlobalAdmin - Membres

ExtendVirtualServer - Surcharge

Microsoft.SharePoint.Administration - Espace de noms

Share via