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

  • Article

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

Pour étendre une application Web vers un nouveau site Web de Internet Information Services (IIS), ajouter une nouvelle entrée pour les paramètres IIS par le biais de la propriété IisSettings de la classe SPWebApplication . SharePoint Foundation gère automatiquement la duplication des sites Web IIS sur d'autres ordinateurs de la batterie de serveurs. (Dans Windows SharePoint Services 2.0, la méthode ExtendVirtualServerInWebFarm étendu un serveur virtuel dans une batterie de serveurs 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("To extend a web application to a new iis web site, add a new entry to SPWebApplication.IisSettings.  Duplicating IIS Web Sites on other machines in the farm is now handled automattically.",  _
    False)> _
Public Function ExtendVirtualServerInWebFarm ( _
    uri As Uri, _
    strVirtualServerName As String, _
    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 strVirtualServerName As String
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.ExtendVirtualServerInWebFarm(uri, _
    strVirtualServerName, bCreateNewAppPool, _
    strAppPoolId, bConfigurableAppPoolAccount, _
    strAppPoolUserName, strAppPoolPassword)

[ObsoleteAttribute("To extend a web application to a new iis web site, add a new entry to SPWebApplication.IisSettings.  Duplicating IIS Web Sites on other machines in the farm is now handled automattically.", 
    false)]
public SPVirtualServer ExtendVirtualServerInWebFarm(
    Uri uri,
    string strVirtualServerName,
    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.

  • strVirtualServerName
    Type : System.String

    Chaîne qui spécifie le nom d'un serveur virtuel qui contient une base de données de contenu à utiliser pour le serveur étendu.

  • 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 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

La méthode ExtendVirtualServerInWebFarm ne crée pas une nouvelle base de données de contenu, mais connecte le serveur étendu à la base de données de contenu du serveur virtuel spécifié.

Avant d'étendre un serveur virtuel à l'aide de la méthode ExtendVirtualServerInWebFarm , 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.

Voir aussi

Référence

SPGlobalAdmin classe

SPGlobalAdmin - Membres

ExtendVirtualServerInWebFarm - Surcharge

Microsoft.SharePoint.Administration - Espace de noms