Upgradesolution : opération Stsadm (Office SharePoint Server)

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

Requis ?

Description

name

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

Oui

Permet à l’administrateur de spécifier le nom d’une solution dans le 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

Un format date:heure valide qui est spécifique à la culture de la langue d’administration, tel que « 16/2/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 à laquelle le déploiement doit se produire.

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 :

« Le format de l’heure de ‘<heure entrée par l’utilisateur>’ n’est pas valide. Le déploiement n’a pas commencé. »

immediate

<aucune>

Non

Provoque le déploiement immédiatement 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 du 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’est pas spécifié. Vous devez spécifier un déploiement uniquement sur ce serveur (-local), sur tous les serveurs de la batterie (-immediate) ou un déploiement retardé sur tous les serveurs de la batterie (-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, 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 totalement fiable, utilisez le paramètre -allowcaspolicies pour effectuer le déploiement. »

lcid

Un ID de paramètre régional valide, tel que « 1033 » pour l’anglais

Non

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