Traduccion manual comandos onedrive

This commit is contained in:
Manuel Vergara 2022-09-14 10:58:18 +02:00
commit 635cf79ace

304
README.md Normal file
View File

@ -0,0 +1,304 @@
# onedrive - Página de manual
***Sincronización de carpetas con OneDrive***
---
## Sinopsis
`onedrive [OPCIÓN] --sincronizar`<br>
`onedrive [OPCIÓN] --monitor`<br>
`onedrive [OPCIÓN] --display-config`<br>
`onedrive [OPCIÓN] --mostrar-estado-de-sincronización`
---
## Descripción
Herramienta CLI para interactuar con OneDrive desde la terminal Linux.
---
## Opciones
Si no se da ninguna opción, no se realiza ninguna sincronización y el programa se cierra.
`--auth-files ARG`<br>
Realiza la autorización a través de dos archivos pasados como ARG en el formato authUrl:responseUrl. La URL de autorización se escribe en authUrl, luego onedrive espera que el archivo responseUrl esté presente, y lee la respuesta de ese archivo.
`--auth-response ARG`<br>
Realiza la autenticación no a través de un diálogo interactivo, sino proporcionando la url de respuesta directamente.
`--check-for-nomount`<br>
Comprueba la presencia de .nosync en la raíz de syncdir. Si se encuentra, no realiza la sincronización.
Clave del archivo de configuración: check_nomount (por defecto: false)
`--check-for-nosync`<br>
Comprueba la presencia de .nosync en cada directorio. Si se encuentra, omite el directorio de la sincronización.
Clave del archivo de configuración: check_nosync (por defecto: false)
`--classify-as-big-delete`<br>
Número de hijos de una ruta que se elimina localmente y que se clasificará como un "gran borrado de datos
Clave del archivo de configuración: classify_as_big_delete (por defecto: 1000)
`--confdir ARG`<br>
Establece el directorio utilizado para almacenar los archivos de configuración
`--create-directory ARG`<br>
Crea un directorio en OneDrive - no se realizará ninguna sincronización.
`--create-share-link ARG`<br>
Crea un enlace compartible para un archivo existente en OneDrive
`--debug-https`<br>
Depurar la comunicación HTTPS de OneDrive.<br>
Clave del archivo de configuración: debug_https (por defecto: false)
`--destination-directory ARG`<br>
Directorio de destino para renombrar o mover en OneDrive - no se realizará ninguna sincronización.
`--disable-download-validation`<br>
Desactivar la validación de descargas cuando se descargan desde OneDrive<br>
Clave del archivo de configuración: disable_download_validation (por defecto: false)
`--disable-notifications`<br>
No utilizar las notificaciones del escritorio en el modo de monitorización<br>
Clave del archivo de configuración: disable_notifications (por defecto: false)
`--disable-upload-validation`<br>
Desactivar la validación de la carga cuando se sube a OneDrive
Clave del archivo de configuración: disable_upload_validation (por defecto: false)
`--display-config`<br>
Muestra las opciones que el cliente utilizará tal y como están configuradas actualmente; no se realizará ninguna sincronización.
`--display-sync-status`<br>
Muestra el estado de sincronización del cliente - no se realizará ninguna sincronización.
`--download-only`<br>
Replica el estado en línea de OneDrive localmente, descargando sólo los cambios de OneDrive. No subir los cambios locales a OneDrive.<br>
Clave del archivo de configuración: download_only (por defecto: false)
`--dry-run`<br>
Realiza una sincronización de prueba sin realizar cambios. Sólo puede utilizarse con `--synchronize`. Se ignorará para `--monitor`<br>
Clave del archivo de configuración: dry_run (por defecto: false)
`--enable-logging`<br>
Habilitar la actividad del cliente en un archivo de registro separado<br>
Clave del archivo de configuración: enable_logging (por defecto: false)
`--force`<br>
Forzar el borrado de datos cuando se detecta un 'big delete'
`--force-http-11`<br>
Forzar el uso de HTTP 1.1 para todas las operaciones<br>
Clave del archivo de configuración: force_http_11 (por defecto: false)
`--force-sync`<br>
Forzar la sincronización de una carpeta específica, sólo cuando se utiliza `--synchronize --single-directory` e ignorar
todas las reglas skip_dir y skip_file no predeterminadas
`--get-O365-drive-id ARG`<br>
Consulta y devuelve el ID de unidad de Office 365 para una determinada biblioteca compartida de SharePoint de Office 365
`--get-file-link ARG`<br>
Muestra el enlace de un archivo sincronizado
`--list-shared-folders`<br>
Lista de carpetas compartidas de OneDrive Business
`--local-first`<br>
Sincronizar primero desde el origen del directorio local, antes de descargar los cambios desde OneDrive.<br>
Clave del archivo de configuración: local_first (por defecto: false)
`--logout`<br>
Cerrar la sesión del usuario actual
`--log-dir ARG`<br>
define el directorio donde se guarda la salida del registro, debe terminar con una barra<br>
Clave del archivo de configuración: log_dir (por defecto: /var/log/onedrive/)
`--min-notify-changes`<br>
el número mínimo de cambios entrantes pendientes necesarios para activar una notificación en el escritorio<br>
Clave del archivo de configuración: min_notify_changes (por defecto: 5)
'-m --modified-by ARG`<br>
Muestra los detalles de la última modificación por de una ruta determinada
`-m --monitor`<br>
Mantener la monitorización de los cambios locales y remotos
`--monitor-interval ARG`<br>
El número de segundos por el que se realiza cada operación de sincronización cuando está inactivo en el modo de monitorización<br>
Clave del archivo de configuración: monitor_interval (por defecto: 300)
`--monitor-fullscan-frequency ARG`<br>
Número de ejecuciones de sincronización antes de realizar un escaneo local completo del directorio sincronizado<br>
Clave del archivo de configuración: monitor_fullscan_frequency (por defecto: 10)
`--monitor-log-frequency ARG`<br>
Frecuencia de registro en el modo de monitorización<br>
Clave del archivo de configuración: monitor_log_frequency (por defecto: 5)
`--no-remote-delete`<br>
No eliminar los archivos locales 'borrados' de OneDrive cuando se utiliza `--upload-only`<br>
Clave del archivo de configuración: no_remote_delete (por defecto: false)
`--operation-timeout ARG`<br>
Establece la cantidad máxima de tiempo (segundos) que puede durar una operación de archivo. Esto incluye la resolución de DNS, la conexión, la transferencia de datos, etc.<br>
Clave del archivo de configuración: operation_timeout (por defecto: 3600)
`--print-token`<br>
Imprime el token de acceso, útil para la depuración
`--reauth`<br>
Reautenticar el cliente con OneDrive
`--remove-directory ARG`<br>
Elimina un directorio en OneDrive - no se realizará ninguna sincronización.
`--remove-source-files`<br>
Eliminar el archivo de origen después de la transferencia exitosa a OneDrive cuando se utiliza `--upload-only`<br>
Clave del archivo de configuración: remove_source_files (por defecto: false)
`--resync`<br>
Olvida el último estado guardado, realiza una sincronización completa
`--resync-auth`<br>
Aprueba el uso de realizar una acción `--resync` sin necesidad de autorización de la CLI
`--single-directory ARG`<br>
Especificar un único directorio local dentro de la raíz de OneDrive para sincronizar.
`--skip-dir ARG`<br>
Omite la sincronización de cualquier directorio que coincida con este patrón
`--skip-dir-strict-match`<br>
Cuando se comparan los directorios de skip_dir, sólo coinciden las coincidencias explícitas<br>
Clave del archivo de configuración: skip_dir_strict_match (por defecto: false)
`--skip-dot-files`<br>
Omitir la sincronización de archivos y carpetas de puntos<br>
Clave del archivo de configuración: skip_dotfiles (por defecto: false)
`--skip-file`<br>
Omitir la sincronización de cualquier archivo que coincida con este patrón<br>
Clave del archivo de configuración: skip_file (por defecto: ~*|.~*|*.tmp)
`--skip-tamaño ARG`<br>
Omitir los archivos nuevos que superen este tamaño (en MB)
`--skip-symlinks`<br>
Omitir la sincronización de los enlaces simbólicos<br>
Clave del archivo de configuración: skip_symlinks (por defecto: false)
`--source-directory ARG`<br>
Directorio de origen para renombrar o mover en OneDrive - no se realizará ninguna sincronización.
`--reservación de espacio ARG`<br>
La cantidad de espacio en disco a reservar (en MB) para evitar la utilización del 100% del espacio en disco
`--sync-root-files`<br>
Sincroniza todos los archivos en sync_dir root cuando se utiliza sync_list.
`--sync-shared-folders`<br>
Sincronizar las carpetas compartidas de OneDrive Business<br>
Clave del archivo de configuración: sync_business_shared_folders (por defecto: false)
`--syncdir ARG`<br>
Establecer el directorio utilizado para sincronizar los archivos que se sincronizan<br>
Clave del archivo de configuración: sync_dir (por defecto: ~/OneDrive)
`--sincronizar`<br>
Realiza una sincronización
`--solo-carga`<br>
Replica el estado de sync_dir configurado localmente a OneDrive, subiendo sólo los cambios locales a OneDrive. No descargue los cambios de OneDrive.<br>
Clave del archivo de configuración: upload_only (por defecto: false)
`--user-agent ARG`<br>
Establece el identificador de agente de usuario utilizado<br>
Clave del archivo de configuración: user_agent (por defecto: no cambiar)
`-v --verbose`<br>
Imprime más detalles, útiles para la depuración. Si se da dos veces (o más), se pueden obtener declaraciones de depuración aún más detalladas.
`--versión`<br>
Imprime la versión y sale
`-h --help`<br>
Esta información de ayuda.
---
## Características
- Caché de estado
- Monitorización de archivos en tiempo real con Inotify
- Validación de carga/descarga de archivos para garantizar la integridad de los datos
- Cargas reanudables
- Compatibilidad con OneDrive for Business (parte de Office 365)
- Soporte de carpetas compartidas para cuentas de OneDrive Personal y OneDrive Business
- Bibliotecas compartidas de SharePoint / Office365
- Notificaciones de escritorio a través de libnotify
- Capacidad de ejecución en seco para probar los cambios de configuración
- Prevención de la eliminación accidental de datos de OneDrive tras un cambio de configuración
- Compatibilidad con implementaciones en la nube nacional (Microsoft Cloud para el Gobierno de los Estados Unidos, Microsoft Cloud Alemania, Azure y Office 365 operado por 21Vianet en China)
---
## Configuración
Debe copiar el archivo de configuración por defecto en su directorio principal antes de realizar cambios:
```
mkdir -p ~/.config/onedrive
cp @DOCDIR@/config ~/.config/onedrive/config
```
Para ver las opciones soportadas, consulte la lista anterior de opciones de línea de comandos para la disponibilidad de una clave de configuración.
Los patrones no distinguen entre mayúsculas y minúsculas. Se admiten los caracteres comodín `*` y `?` Utilice | para separar varios patrones.
Después de cambiar los filtros (`skip_file` o `skip_dir` en sus configuraciones) debe ejecutar:
```
onedrive --synchronize --resync
```
---
## Primera ejecución
Después de instalar la aplicación debes ejecutarla al menos una vez desde la terminal para autorizarla.
Se te pedirá que abras un enlace específico usando tu navegador web donde tendrás que iniciar sesión en tu cuenta de Microsoft y darle a la aplicación el permiso para acceder a tus archivos. Después de dar el permiso, serás redirigido a una página en blanco. Copie el URI de la página en blanco en la aplicación.
---
## Integración de Systemd
Los archivos de servicio se instalan en los directorios del usuario y del sistema.
### El servicio OneDrive se ejecuta como usuario root
Para habilitar este modo, ejecute como usuario root
```
systemctl enable onedrive
systemctl start onedrive
```
### El servicio OneDrive se ejecuta como usuario root para un usuario no root
Este modo permite iniciar el servicio OneDrive automáticamente con el inicio del sistema para varios usuarios. Para cada `<nombre de usuario>` ejecute
```
systemctl enable onedrive@<nombredeusuario>
systemctl start onedrive@<nombredeusuario>
```
### Servicio OneDrive ejecutado como usuario no root
En este modo, el servicio se iniciará cuando el usuario inicie sesión. Ejecutar como usuario
```
systemctl --user enable onedrive
systemctl --user start onedrive
```
---
## Registro de resultados
Cuando se ejecuta onedrive, todas las acciones pueden ser registradas en un archivo de registro separado. Esto se puede habilitar utilizando la bandera `--enable-logging`. Por defecto, los archivos de registro se escribirán en `/var/log/onedrive`.
Todos los archivos de registro tendrán el formato de `%nombredeusuario%.onedrive.log`, donde `%nombredeusuario%` representa el usuario que ejecutó el cliente.
---
## Notificaciones
Si OneDrive ha sido compilado con soporte para notificaciones, un onedrive en funcionamiento en modo monitor enviará notificaciones sobre la inicialización y los errores a través de libnotify al dbus.
Tenga en cuenta que esto no funciona si onedrive se inicia como root para un usuario a través del servicio `onedrive@<nombredeusuario>`.
---
## Vea también
Más ejemplos y documentación en [yannisdran/onedrive](https://github.com/yannisdran/onedrive)
---
## Información
*Julio 2022 v2.4.20*