3.12 Paramètres généraux
3.12.1 credentials
--credentials=<nom d'utilisateur>,<mot de passe>,encrypted
Informations d'identification pour accéder à une machine, un emplacement de sauvegarde ou un dossier. Le paramètre doit directement suivre l'objet pour lequel les informations d'identification sont nécessaires (par exemple, --host, --loc, --target).
Pour accéder à Acronis Secure Zone, spécifiez uniquement le mot de passe dans ce paramètre.
Pour accéder à un partage réseau qui ne nécessite pas d'informations d'identification, spécifiez
--credentials=anonymous.
Si la valeur du troisième paramètre (encrypted) est spécifiée, cela signifie que le mot de passe
précédent a été chiffré par l'utilitaire acronis_encrypt (p. 153).
Une commande peut utiliser plusieurs paramètres --credentials.
Exemple acrocmd export archive --loc=bsp://ASN/my_vault --credentials="ASN user",pass1
--arc=my_archive --password=123 --target=\\bkpsrv\backups
--credentials=netuser,pass2
Cette commande exporte une archive protégée par un mot de passe à partir d'un emplacement de stockage géré vers un partage réseau. Les premières informations d'identification sont nécessaires pour accéder à l'emplacement de stockage my_vault géré par le nœud de stockage ASN. Le paramètre --password spécifie le mot de passe de l'archive my_archive. Les informations d'identification suivantes permettent d'enregistrer dans le dossier partagé \\bkpsrv\backups.
3.12.2 Gestion erreurs
--retry_count=<nombre de tentatives>
--retry_delay=<délai>
Ces paramètres sont utilisés avec les commandes de sauvegarde et de restauration seulement.
Lorsqu'une erreur récupérable se produit, le logiciel essaie à nouveau d'effectuer l'opération qui a
échoué. Vous pouvez définir le nombre de tentatives et l'intervalle de temps entre ces tentatives. Les tentatives s'arrêteront dès que l'opération réussira OU que le nombre de tentatives sera atteint, suivant lequel de ces deux cas de figure se produit en premier.
Vous devez spécifier les deux paramètres. Le paramètre --retry_delay doit directement suivre le paramètre --retry_count.
Exemple : --retry_count=10 --retry_delay=20s
SI les paramètres ne sont pas spécifiés, le nombre de tentatives est 5 et l'intervalle de temps entre les tentatives est de 30 secondes (comme si vous aviez tapé --retry_count=5
--retry_delay=30s). Pour désactiver complètement les tentatives, spécifiez --retry_count=0.
L'intervalle peut être défini en secondes (s, par défaut), minutes (m) ou heures (h).
Exemples :
123 Copyright © Acronis International GmbH, 2002-2015
Intervalle de 10 secondes : --retry_delay=10 ou --retry_delay=10s
Intervalle de 1 minute : --retry_delay=1m
Intervalle de 1 heure : --retry_delay=1h
3.12.3 file_params
{-f|--file_params}=<chemin d'accès local complet>
Spécifie le chemin d'accès complet vers un fichier de paramètres d'entrée. Le chemin d'accès doit
être local (par exemple c:\temp\1.txt ou /home/user1/1.txt). Pour des informations plus
détaillées, consultez la section Syntax (p. 9).
3.12.4 force_yes
--force_yes
Si le paramètre est spécifié, le logiciel gérera automatiquement les situations nécessitant une intervention de l'utilisateur comme si l'utilisateur répondait Yes ou OK à la demande d'intervention.
Si la demande d'intervention n'implique pas ces réponses (par exemple, les réponses possibles à une invite de redémarrage sont Reboot et Cancel), le logiciel ignorera cette demande. Si une opération ne peut pas se poursuivre sans l'intervention de l'utilisateur, elle échouera.
Si le paramètre n'est pas spécifié, la commande permettra l'interaction avec l'utilisateur.
Le paramètre est principalement destiné à la commande recover lvm_structure (p. 23). Il
automatise la restauration d'un système Linux, y compris son logiciel RAID/sa structure LVM, sur une machine avec une structure du volume logique différentes ou sans volumes logiques. Cette commande demande toujours à l'utilisateur de confirmer le remplacement de la structure des volumes logiques de la machine.
Veuillez noter qu'en utilisant le paramètre --force_yes, vous pouvez involontairement confirmer la suppression de données utiles. Si vous souhaitez que le logiciel ignore simplement les demandes
d'intervention, utilisez le paramètre --silent_mode (p. 128) plutôt que le paramètre
--force_yes. Ces paramètres sont mutuellement exclusifs.
3.12.5 id
--id=<GUID>
GUID de l'activité, tâche ou plan de sauvegarde avec lequel l'opération sera exécutée. Le paramètre
est utilisé avec la commande get log (p. 64) et les commandes de gestion task (p. 70), plan (p. 67) et
activity (p. 66).
3.12.6 log
--log=<chemin complet>
Enregistre dans le fichier spécifié le journal de l'opération avec laquelle le paramètre est utilisé. Le
format du fichier journal dépend de la valeur du paramètre --log_format (p. 124).
3.12.7 log_format
--log_format={structured|unstructured}
124 Copyright © Acronis International GmbH, 2002-2015
Le format du fichier journal spécifié dans le paramètre --log (p. 124). Si la valeur est structured
ou si le paramètre n'est pas spécifié, le logiciel écrira les journaux dans le format structuré XML. Le format est décrit dans le fichier acrocmd.xsd situé dans le dossier où l'utilitaire de ligne de commande est installé. Les chemins d'installation par défaut de l'utilitaire sont répertoriés dans la
section « Installation » (p. 7) sous « Chemins d'installation ��.
Si la valeur est unstructured, le logiciel écrira les journaux dans le format XML d'Acronis.
3.12.8 oss_numbers
--oss_numbers={true|false}
Le paramètre est utilisé dans les cas suivants :
Avec les commandes backup disk (p. 19), recover disk (p. 20), create asz (p. 55), resize
asz (p. 56) et delete asz (p. 58). Avec ces commandes, le paramètre s'applique aux volumes
indiqués dans la valeur du paramètre --volume (p. 89).
Avec la commande list content (p. 45) si la valeur du paramètre --content_type est
volume ou avec la commande list disks (p. 18). Avec ces commandes, le paramètre
s'applique aux numéros des volumes de sortie.
Si la valeur est true ou si le paramètre n'est pas spécifié, les numéros des volumes sont ajustés pour la table de partition MBR. Cela signifie que les partitions primaires ont des numéros 1-1, 1-2, 1-3,
1-4 ; les numéros de volumes logiques commencent par 1-5.
Si la valeur du paramètre est false, une numérotation de volume consécutive doit être utilisée.
Exemple
Si le disque a une partition primaire et deux partitions logiques, leurs numéros peuvent apparaître comme suit :
--volume=1-1,1-5,1-6 ou
--oss_numbers=false --volume=1-1,1-2,1-3
3.12.9 output
--output={formatted|raw}
Mode de sortie. Les valeurs valables sont :
formatted(par défaut)
Génère un tableau lisible. La largeur maximale d'une colonne de tableau est de 20 caractères. Le texte est aligné à gauche. Les en-têtes du tableau et les séparateurs des en-têtes sont affichés.
raw
Ce mode est utilisé pour générer un fichier source destiné à un analyseur tiers. Les en-têtes ne sont pas visibles ; les lignes séparatrices de l'en-tête de colonne ne sont pas visibles ; le séparateur de colonnes est « \t » (caractère de tabulation). De même, ce mode vous permet de voir la longueur complète d'une valeur qui est supérieure à 20 caractères (par exemple, le GUID d'un plan de sauvegarde).
125 Copyright © Acronis International GmbH, 2002-2015
3.12.10 password
--password=<mot de passe>,encrypted
Mot de passe pour l'archive dans les opérations de sauvegarde et de restauration, opérations de gestion d'archives et de sauvegardes. Le paramètre doit directement suivre le paramètre --arc (p.
84).
Ce paramètre est également utilisé avec la commande create asz (p. 55) pour spécifier un mot de
passe pour Acronis Secure Zone.
Si la valeur du deuxième paramètre (encrypted) est spécifiée, cela signifie que le mot de passe
précédent a été chiffré par l'utilitaire acronis_encrypt (p. 153).
3.12.11 process_priority
--process_priority={low|normal|high}
Priorité d'un processus de sauvegarde ou de validation exécuté dans un système. Dans les commandes de validation, ce paramètre est ignoré si la destination de sauvegarde est un emplacement de stockage géré.
Ce paramètre détermine la quantité de ressources processeur et système allouées à ce processus.
Réduire la priorité libérera davantage de ressources pour les autres applications. Augmenter la priorité pourrait accélérer le processus de sauvegarde en imposant au système d'exploitation d'allouer plus de ressources, par exemple de processeur, à l'application de sauvegarde. Cependant, l'effet correspondant dépendra de l'utilisation globale du processeur ainsi que d'autres facteurs comme la vitesse d'E/S du disque ou le trafic réseau.
Les valeurs disponibles sont les suivantes :
low(par défaut)
Utilisez cette valeur pour réduire le plus possible les ressources utilisées par le processus de sauvegarde ou de validation et laisser davantage de ressources aux autres processus en cours d'exécution sur la machine
normal
Utilisez cette valeur pour exécuter le processus de sauvegarde ou de validation à une vitesse normale et allouer des ressources dans des proportions égales à d'autres processus
high
Utilisez cette valeur pour optimiser la vitesse du processus de sauvegarde ou de validation en prenant des ressources à d'autres processus.
3.12.12 progress
--progress
Active l'affichage à l'écran de l'information sur la progression de l'opération (pourcentage complété, temps écoulé, temps estimé). L'information sur la progression est enregistrée dans le journal peu importe la présence du paramètre --progress.
3.12.13 read_speed
--read_speed=<vitesse>{kb|p}
126 Copyright © Acronis International GmbH, 2002-2015
Vitesse de lecture des sauvegardes en cours de validation. Le paramètre est utilisé avec les
commandes validate archive (p. 42), validate backup (p. 46) et validate vault (p. 61).
Ce paramètre est utilisé si l'emplacement de sauvegarde (la valeur du paramètre --loc (p. 83)) est
l'un des suivants :
1. Un partage réseau, un serveur FTP/SFTP ou Acronis Cloud Storage.
Le paramètre définit la quantité de bande passante de connexion réseau allouée pour transférer les données. Si le paramètre n'est pas spécifié, le logiciel utilise toute la bande passante réseau qu'il peut obtenir lors du transfert des données.
2. Un disque dur de la machine où la commande est exécutée.
Pour les autres types d'emplacements, ce paramètre est ignoré.
<vitesse> doit être un nombre positif.
Si l'unité de mesure est kb, la vitesse est calculée en kilo-octets par seconde. Pour le stockage cloud, seule l'unité de mesure kb est efficace.
Si l'unité de mesure est p ou n'est pas spécifiée, la vitesse est mesurée en pourcentage de la vitesse maximale estimée de la connexion réseau ou de la vitesse d'E/S maximale du disque dur.
Exemples :
--read_speed=500kb – la vitesse de lecture des données sera de 500 kilo-octets par seconde
--read_speed=50p ou --read_speed=50 – la vitesse de lecture des données sera de 50 % de la vitesse maximale estimée.
3.12.14 reboot
reboot et reboot later
--reboot
--reboot --later
Redémarre la machine avant l'opération (si nécessaire).
Utilisez le paramètre --reboot lorsque vous exécutez les opérations suivantes, nécessitant un redémarrage : restauration d'un volume contenant le système d'exploitation actuellement actif, restauration de fichiers verrouillés, création/suppression d'Acronis Secure Zone sur un disque système, clonage d'un disque système. La machine sera redémarrée sans invite.
SI les paramètres --reboot et --silent_mode=on (p. 128) ne sont pas spécifiés, l'opération
demandera une intervention de l'utilisateur. Si le paramètre --reboot n'est pas spécifié et que le paramètre --silent_mode=on est spécifié, l'opération échouera.
Pour reporter l'opération jusqu'à ce qu'un utilisateur redémarre le système manuellement, ajoutez le paramètre --later. En utilisant ce paramètre, l'opération sera exécutée après que l'utilisateur amorce un redémarrage. Ce paramètre peut être utilisé seulement avec les commandes create asz
(p. 55) et resize asz (p. 56).
Si vous spécifiez le paramètre --reboot avec des opérations qui ne nécessitent pas un redémarrage, ce paramètre est ignoré.
reboot after
--reboot_after
127 Copyright © Acronis International GmbH, 2002-2015
Redémarrez le serveur à la fin de l'opération.
3.12.15 recreate_archive_meta
--recreate_archive_meta={true|false}
Le paramètre est utilisé avec les commandes list archives (p. 40) et list backups (p. 44).
Si la valeur est true ou si le paramètre n'est pas spécifié, les métadonnées d'archives sont recréées lors de l'exécution de la commande. Cela garantit que la commande n'échoue pas, même si les métadonnées sont manquantes ou corrompues.
Si la valeur est false, les métadonnées d'archive restent intactes. Cela accélère l'exécution de la commande.
3.12.16 silent_mode
--silent_mode={on|off}
Si la valeur du paramètre est on, le mode silencieux est activé. Cela veut dire que le logiciel traite automatiquement les situations demandant une intervention de l'utilisateur. Si une opération ne peut pas se poursuivre sans l'intervention de l'utilisateur, elle échouera. Les détails de l'opération, y compris les erreurs, le cas échéant, apparaissent dans le journal des opérations.
Si la valeur est off ou si le paramètre n'est pas spécifié, la commande permet une interaction avec l'utilisateur. Définissez cette valeur si l'opération nécessite une intervention de l'utilisateur telle qu'insérer un support amovible (CD, DVD ou bande).
Pour empêcher une intervention si le logiciel tombe sur un secteur défectueux pendant la
sauvegarde, utilisez le paramètre --ignore_bad_sectors (p. 101). Le paramètre
--silent_mode ne fonctionne pas dans ce cas particulier.
Les paramètres --silent_mode et --force_yes (p. 124) sont mutuellement exclusifs.
3.12.17 use_registry_defaults
--use_registry_defaults
Le paramètre est utilisé avec les commandes de sauvegarde et de restauration, sauf pour recover
mbr (p. 22). Il détermine les valeurs des options de sauvegarde et de restauration qui ne sont pas
spécifiées explicitement dans une chaîne de commande.
Si le paramètre est spécifié, le logiciel utilisera les valeurs par défaut des options de sauvegarde et de restauration définies dans l'interface graphique utilisateur d'Acronis Backup. Ces valeurs sont stockées sur la machine avec l'agent qui exécute la commande. Sur une machine exécutant Windows, les valeurs sont stockées dans le registre ; sur une machine exécutant Linux, les valeurs sont stockées dans les fichiers de configuration d'Acronis Backup.
Si le paramètre n'est pas spécifié, le logiciel utilisera les valeurs par défaut décrites dans cette référence de la ligne de commande. Ces valeurs sont contenues dans le code utilitaire de la ligne de commande.
3.12.18 utc
--utc
128 Copyright © Acronis International GmbH, 2002-2015
Le paramètre est utilisé avec les commandes list archives (p. 40), list backups (p. 44), list
content (p. 45) et list plans (p. 67). Si spécifié, les valeurs de date et de temps dans la sortie de
commande sont affichées en Temps universel coordonné (UTC). Dans le cas contraire, les valeurs sont affichées dans la zone de temps de la machine sur laquelle vous exécutez la commande.
129 Copyright © Acronis International GmbH, 2002-2015
