commande dotnetup auto-mise à jour

Note

dotnetup est disponible en préversion publique. Ses fonctionnalités et son comportement peuvent changer avant la disponibilité générale.

Name

dotnetup self update - Mettez à jour l’exécutable dotnetup autonome à partir d’un canal de mise en production.

Synopsis

dotnetup self update [--channel <daily|preview|stable>] [--force]
                    [--no-progress [<true|false>]]
dotnetup self update --update-notifications <true|false>

Description

La commande met à jour l’exécutable autonome dotnetup en cours d’exécution en place. Il télécharge la dernière build disponible pour le canal de mise en production sélectionné et le système d’exploitation et l’architecture actuels. Il ne met pas à jour les sdk ou runtimes managés .NET. Pour ces installations, utilisez dotnetup update.

Sur le même canal de version, une version égale ou antérieure disponible ne remplace pas l’exécutable installé, sauf si vous spécifiez --force. La commande signale qu’aucune mise à jour n’a été appliquée et retourne le code 0de sortie. Une modification entre les canaux de version, comme une préversion et une version stable, peut remplacer l’exécutable même lorsque la version cible est plus ancienne.

Le répertoire d’installation doit être accessible en écriture. La mise à jour automatique ne prend pas en charge l’exécution via l’hôte dotnet ou un exécutable qui est un lien symbolique ou un autre point d’analyse. Utilisez l’exécutable autonome dans son répertoire d’installation réel.

Bien que la mise à jour automatique conserve ses verrous de coordination, d’autres commandes dotnetup peuvent échouer avec un message indiquant qu’une mise à jour est en cours. Réessayez ces commandes une fois la mise à jour automatique terminée.

Pour les versions antérieures qui ne reconnaissent self updatepas ou pour la récupération lorsque l’exécutable ne démarre plus, utilisez les scripts de téléchargement.

Options

Option Description
--channel <daily\|preview\|stable> Sélectionnez le canal de mise en production dotnetup, et non pas un canal .NET SDK. Par défaut, les versions sans étiquette de préversion utilisent stable, les versions avec une preview utilisation d’étiquette previewet d’autres versions de préversion utilisent daily.
--force Installez la dernière build du canal sélectionné, même lorsqu’elle n’est pas plus récente. Cette option peut réinstaller ou rétrograder dotnetup.
--update-notifications <true\|false> Activez ou désactivez les notifications de mise à jour sans mettre à jour l’exécutable. Cette option ne peut pas être combinée avec --channel ou --force.
--no-progress [<true\|false>] Désactivez l’affichage de progression du téléchargement.
-?, -h, --help Afficher l’aide de la commande.

Les builds quotidiennes officielles portent également l’étiquette de preview version, de sorte qu’elles sont par défaut du canal d’aperçu. Pour rester sur les builds quotidiennes, spécifiez --channel daily. L’analyseur accepte stable, mais aucune version stable de dotnetup n’est disponible pendant cette préversion publique.

Notifications de mise à jour

Une fois les commandes d’installation et de mise à jour interactives réussies, dotnetup peut écrire une notification dans la sortie standard lorsqu’une build dotnetup plus récente est disponible. Ces commandes incluent baredotnetup, , sdk installinstall, runtime install, update, sdk update, et runtime update.

Les notifications sont activées par défaut. La vérification utilise le canal de mise en production par défaut de la build en cours d’exécution et s’actualise en arrière-plan toutes les 24 heures après une vérification réussie. Il ne télécharge pas ou n’installe pas l’exécutable. Une actualisation réussie produit au plus un avis. Une commande courte peut se terminer avant l’actualisation, de sorte que l’avis peut apparaître après une commande ultérieure.

Les notifications n’apparaissent pas lorsque la sortie est redirigée, même avec --interactive true. Une vérification ayant échoué ne fait pas échouer la commande d’installation ou de mise à jour.

Pour désactiver les notifications, exécutez :

dotnetup self update --update-notifications false

Pour réactiver les notifications, exécutez :

dotnetup self update --update-notifications true

Examples

Mettez à jour dotnetup à partir de son canal de mise en production par défaut :

dotnetup self update

Effectuez une mise à jour vers la dernière build quotidienne sans télécharger la progression :

dotnetup self update --channel daily --no-progress

Revenez à la dernière version d’évaluation, même si elle est antérieure à la build quotidienne installée :

dotnetup self update --channel preview --force

Voir aussi