Upgradesolution : opération Stsadm (Windows SharePoint Services)

Mise à jour : 2007-04-26

Nom de l’opération : Upgradesolution

Met à niveau une solution existante. La solution à mettre à niveau peut être déployée ou non ; toutefois, les paramètres immediate et time s’appliquent uniquement si la solution a été déployée.

Si la solution n’est pas déployée, l’opération upgradesolution met simplement à jour les bits stockés dans la base de données pour une solution et crée la sauvegarde de retour à la version antérieure.

Syntaxe

stsadm -o upgradesolution

-name <nom de la solution>

-filename <nom du fichier de mise à niveau>

[-time] <heure de mise à niveau>

[-immediate]

[-local]

[-allowgacdeployment]

[-allowcaspolicies]

[-lcid] <langue>

Paramètres

Paramètre (nom abrégé)

Valeur

Obligatoire ?

Description

name

Un nom valide d’une solution, tel que « Upgradesolution.wsp »

Oui

Permet à l’administrateur de spécifier le nom d’une solution à l’intérieur du magasin de solutions.

filename

Un des formats suivants :

  • *.cab

  • *.wsp

  • *.wpp

Oui

Permet à l’administrateur de spécifier le nom de la solution sur le disque. Si un administrateur spécifie le paramètre filename, cela revient à appeler les opérations addsolution et addwppack, puis à déployer la solution.

time

Format de date et d’heure valide, spécifique à la langue d’administration, par exemple « 2/16/2007 12:15:12 »

Le paramètre -time n’est pas nécessaire si le paramètre immediate ou local est spécifié. Dans le cas contraire, le paramètre -time est requis.

Permet à l’administrateur de planifier l’heure du déploiement.

Le paramètre Time nécessite qu’un utilisateur utilise un format d’heure acceptable pour la méthode DateTime.Parse. Si le format date:heure n’est pas analysé correctement, le message d’erreur suivant s’affiche :

« « <Date/heure entrée par l’utilisateur> » n’est pas un format de date/heure valide. Le déploiement n’a pas été lancé ».

immediate

<aucune>

Non

Déclenche immédiatement le déploiement après l’exécution de la commande.

local

<aucune>

Le paramètre -local n’est pas nécessaire si le paramètre immediate ou time est spécifié. Dans le cas contraire, le paramètre -local est requis.

Déploie la solution de manière synchrone sur l’ordinateur local uniquement. Le service de minuteur n’est pas utilisé.

Un développeur doit spécifier le paramètre -immediate, -local ou -time. Si un de ces paramètres n’est pas spécifié, le message suivant s’affiche :

« Le type de déploiement n’a pas été spécifié. Vous devez spécifier un déploiement sur ce serveur uniquement (-local), un déploiement sur tous les serveurs de la batterie de serveurs (-immediate) ou un déploiement retardé sur tous les serveurs de la batterie de serveurs (-time) ».

allowgacdeployment (allgac)

<aucune>

Non

Si la solution contient des assemblys qui doivent être placés dans un Global Assembly Cache (GAC), ce paramètre doit être spécifié. Dans le cas contraire, le message d’erreur suivant s’affiche :

« La solution ’<nom de la solution>’ doit installer des assemblys dans le Global Assembly Cache (GAC). Si cette solution est totalement fiable, utilisez le paramètre -allowgacdeployment pour effectuer le déploiement. »

allowcaspolicies (allowcas)

<aucune>

Non

Si la solution contient des stratégies de sécurité d’accès du code (CAS), ce paramètre doit être spécifié. Dans le cas contraire, le message d’erreur suivant s’affiche :

« La solution « nom de la solution » doit ajouter des stratégies de sécurité d’accès du code. Si cette solution est entièrement fiable, utilisez le paramètre -allowCasPolicies pour la déployer. »

lcid

Identificateur valide de paramètres régionaux, par exemple « 1036 » pour le français

Non

ID de paramètres régionaux de langue de la solution