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.StringChaîne qui spécifie le serveur de base de données.
strDatabaseName
Type : System.StringChaîne qui contient le nom de la base de données.
strUserName
Type : System.StringChaî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.StringChaî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.UriUn 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.Booleantrue pour créer un pool d'applications ; dans le cas contraire, false.
strAppPoolId
Type : System.StringChaîne qui spécifie un ID pour le pool d'applications.
bConfigurableAppPoolAccount
Type : System.Booleantrue pour indiquer que le compte de pool d'applications est configurable ; dans le cas contraire, false.
- strAppPoolUserName
Type : System.StringChaî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.StringChaî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);
}
}