Afficher Sommaire / Index / Recherche

Utilitaire de ligne de commande sftp

L'utilitaire de ligne de commande sftp est un programme de transfert de fichiers interactif, semblable à ftp, et qui réalise toutes ses opérations via un canal Secure Shell chiffré. Il peut également utiliser de nombreuses fonctionnalités de ssh, telles que l'authentification de clé publique.

Si vous ne spécifiez aucun fichier sur la ligne de commande, sftp passe en mode de commande interactive. Vous pouvez utiliser toutes les commandes interactives détaillées plus loin. Pour créer un script de plusieurs commandes, vous pouvez utiliser l'option de fichier séquentiel (-B).

Si vous spécifiez des fichiers sur la ligne de commande, sftp les transfère et se ferme.

Remarque : Vous pouvez réutiliser une connexion SecureShell existante. Toutefois, pour ce faire, vous devez l'activer explicitement à chaque ligne de commande ou attribuer la valeur Yes à la variable d'environnement SSHConnectionReUse. Pour plus d'informations, reportez-vous à la section Réutilisation de connexion dans les sessions Secure Shell.

Options de la ligne de commande

-a

Transfère les fichiers en mode ASCII.

-b tailletampon

Définit la taille maximale du tampon pour une requête. Les valeurs valides sont comprises entre 1024 et 32768.

-B fichierséquentiel

Après établissement d'une connexion, exécute chaque commande du fichier séquentiel spécifié, puis met fin à la connexion. Par exemple, la commande suivante ouvre une connexion à hôte sous le nom nom et exécute les commandes de fichier. Une fois toutes les commandes du fichier exécutées, la connexion est fermée.

sftp -B c:\chemin\fichier hote.com nom

Le fichier séquentiel peut utiliser toutes les commandes interactives détaillées plus loin.

Remarque : Les points-virgules ne sont pas interprétés comme commentaires des scripts fournis dans la ligne de commande sftp à l'aide de l'option -B. Utilisez le signe dièse (#) pour marquer les commentaires dans ces fichiers.

-c codechiffrement

Liste de codes de chiffrement pris en charge par ordre de préférence, séparés par des virgules. La valeur par défaut est « aes128-ctr,aes128-cbc,aes192-ctr,aes192-cbc,aes256-ctr,aes256-cbc,3des-cbc,blowfish-cbc,cast128-cbc,arcfour128,arcfour256,arcfour ». Si la connexion est configurée pour s'exécuter en mode FIPS, la valeur par défaut est « aes128-ctr,aes128-cbc,aes192-ctr,aes192-cbc,aes256-ctr,aes256-cbc,3des-cbc ».

La version 1 du protocole (dépassée et déconseillée) permet la spécification d'un seul code de chiffrement. Les valeurs acceptées sont « 3des », « blowfish » et « des ».

-C

Active la compression de toutes les données transmises. La compression est souhaitable pour les lignes modem et toute autre connexion lente, mais elle ralentit le flux de réponse sur les réseaux rapides.

-d

Implique que la cible doit être un répertoire.

-F fichier_config

Indique un fichier de configuration à utiliser pour cette connexion. Si un fichier de configuration est indiqué sur la ligne de commande, tout autre fichier de configuration est ignoré.

-H schéma

Indique un schéma de configuration SSH à utiliser pour cette connexion.

-i fichier_clé

Indique la clé privée à utiliser pour l'authentification par clé. Les fichiers de clé peuvent également être spécifiés pour chaque hôte dans un fichier de configuration. Il est possible d'avoir plusieurs options -i (et plusieurs clés spécifiées dans un fichier de configuration). Utilisez des guillemets si le fichier ou le chemin contient des espaces.

-o option

Définit toute option prise en charge par le fichier de configuration. Par exemple :

ssh "-o FIPSMode=yes" utilisateur@hôte

-p

Conserve la date et l'heure et les attributs du fichier.

-q

Active le mode silencieux qui entraîne la suppression de tous les messages d'avertissement et de diagnostic, y compris les indicatifs.

-R maximum_requêtes

Indique le nombre maximal de requêtes simultanées. Augmenter ce nombre peut légèrement améliorer la vitesse de transfert, mais accroît l'utilisation de la mémoire. La valeur par défaut est 16 requêtes en attente.

-s soussystème

Indique le sous-système ssh.

-S programme

Indique le programme à utiliser pour les connexions chiffrées.

-u

Supprime le fichier source une fois copié.

-v

Active le mode détaillé pour le débogage, ce qui équivaut à définir le niveau de débogage sur 2.

-V

Affiche le nom de produit, la version et ferme l'utilitaire. Si d'autres options sont spécifiées sur la ligne de commande, elles sont ignorées.

Mode interactif

En mode interactif, sftp comprend un ensemble de commandes similaires, mais non identiques aux commandes ftp standard. Les commandes font la distinction entre majuscules et minuscules. Utilisez des guillemets si le fichier ou le chemin contiennent des espaces.

ascii

Indique le type de transfert ASCII.

binary

Indique le type de transfert binaire.

bye

Ferme sftp.

cd chemin

Change de répertoire distant pour chemin.

chmod chemin

Modifie les autorisations associées à chemin. Utilisez mode pour spécifier une autorisation numérique à trois chiffres.

lcd chemin

Change de répertoire local pour chemin.

exit

Ferme sftp.

get chemin-distant [chemin-local]

Obtient le chemin-distant et l'enregistre sur l'ordinateur local. Si aucun chemin local n'est spécifié, il sera le même que celui sur l'ordinateur distant.

getext [extension,extension...]

Affiche les extensions de fichier qui utilisent le transfert ascii. Utilisez setext pour modifier cette liste.

help

Affiche le texte d'aide.

lls [ls-options [chemin]]

Affiche la liste des répertoires locaux du chemin ou du répertoire en cours si aucun chemin n'est spécifié.

lmkdir chemin

Crée le répertoire local spécifié par chemin.

lpwd

Imprime le répertoire de travail local.

ls [chemin]

Affiche la liste des répertoires distants du chemin ou du répertoire en cours si aucun chemin n'est spécifié.

mkdir chemin

Crée le répertoire distant spécifié par chemin.

put chemin-local [chemin-local]

Enregistre le chemin-local sur l'ordinateur distant. Si aucun chemin distant n'est spécifié, il sera le même que celui sur l'ordinateur local.

pwd

Affiche le répertoire de travail distant.

quit

Ferme sftp.

reget fichier-distant [fichier-local]

Reprend le transfert spécifié. Agit comme la commande get, mais vérifie la présence d'un fichier local partiellement écrit et, s'il le trouve, reprend le transfert là où il en était resté à la dernière tentative.

rename ancienchemin nouveauchemin

Renomme le fichier distant en remplaçant ancienchemin par nouveauchemin.

rmdir chemin

Supprime le répertoire distant spécifié par chemin.

rm chemin

Supprime le fichier distant spécifié par chemin.

setext [extension,extension...]

Définit les extensions de fichier qui utilisent le transfert ascii. Les caractères génériques sont pris en charge. Si aucun argument n'est précisé, aucune extension de fichier n'utilise le transfert ascii.

version

Affiche la version de sftp.

?

Synonyme de help.