# Onedrive

{% code fullWidth="true" %}

```
名称:
   singularity存储更新onedrive - 微软OneDrive

用法:
   singularity存储更新onedrive [命令选项] <名称|ID>

说明:
   --client-id
      OAuth客户端ID。
      
      通常为空。

   --client-secret
      OAuth客户端密钥。
      
      通常为空。

   --token
      OAuth访问令牌，以JSON格式提供。

   --auth-url
      认证服务器URL。
      
      如果不填写，默认使用提供者的默认值。

   --token-url
      令牌服务器URL。
      
      如果不填写，默认使用提供者的默认值。

   --region
      选择OneDrive的国家云区域。

      示例:
         | global | 微软全球云
         | us     | 美国政府用微软云
         | de     | 微软德国云
         | cn     | 在中国由微软Vnet Group运营的Azure和Office 365

   --chunk-size
      上传文件的块大小 - 必须是320k（327,680字节）的倍数。
      
      超过此大小的文件将被分块处理 - 必须是320k（327,680字节）的倍数，并且不应超过250M（262,144,000字节），否则可能会遇到 "Microsoft.SharePoint.Client.InvalidClientQueryException: The request message is too big."。
      请注意，分块数据将被缓存到内存中。

   --drive-id
      要使用的驱动器的ID。

   --drive-type
      驱动器类型（personal | business | documentLibrary）。

   --root-folder-id
      根文件夹的ID。
      
      通常情况下不需要，但在特殊情况下，您可能知道要访问的文件夹的ID，但无法通过路径遍历访问。
      

   --access-scopes
      设置rclone请求的范围。
      
      选择或手动输入一个自定义的以空格分隔的范围列表，以便rclone请求。
      

      示例:
         | Files.Read Files.ReadWrite Files.Read.All Files.ReadWrite.All Sites.Read.All offline_access | 对所有资源进行读写访问
         | Files.Read Files.Read.All Sites.Read.All offline_access                                     | 只读访问所有资源
         | Files.Read Files.ReadWrite Files.Read.All Files.ReadWrite.All offline_access                | 对所有资源进行读写访问，但无法浏览SharePoint站点。 
         |                                                                                             | 相当于将disable_site_permission设置为true时的操作

   --disable-site-permission
      禁用对Sites.Read.All权限的请求。
      
      如果设置为true，您将无法在配置驱动器ID时搜索SharePoint站点，因为rclone将不会请求Sites.Read.All权限。
      如果您的组织未将Sites.Read.All权限分配给应用程序，并且您的组织禁止用户自行同意应用程序权限请求，请将其设置为true。

   --expose-onenote-files
      设置以使OneNote文件显示在目录列表中。
      
      默认情况下，rclone在目录列表中隐藏OneNote文件，因为无法对它们执行“打开”和“更新”等操作。但是，此行为可能也会防止您删除它们。如果要删除OneNote文件或以其他方式希望它们出现在目录列表中，请设置此选项。

   --server-side-across-configs
      允许在不同的OneDrive配置之间进行服务器端操作（例如复制）。
      
      这仅适用于在两个OneDrive *个人*驱动器之间进行复制，并且要复制的文件已在它们之间共享。在其他情况下，rclone将回退到正常的复制（速度稍慢一些）。

   --list-chunk
      列出块的大小。

   --no-versions
      在修改操作中删除所有版本。
      
      当rclone覆盖现有文件并设置修改时间时，OneDrive for Business会创建版本。
      
      这些版本将占用配额空间。
      
      此标志在文件上传和设置修改时间后检查版本，并删除除最后一个版本之外的所有版本。
      
      **注意** OneDrive个人目前无法删除版本，因此请勿在此处使用此标志。
      

   --link-scope
      设置link命令创建的链接范围。

      示例:
         | anonymous    | 链接对任何人都可访问，无需登录。
         |              | 这可能包括组织外的人员。
         |              | 管理员可能已禁用匿名链接支持。
         | organization | 组织（租户）中已登录的任何人都可以使用该链接访问。
         |              | 仅在OneDrive for Business和SharePoint中可用。

   --link-type
      设置link命令创建的链接类型。

      示例:
         | view  | 创建到项目的只读链接。
         | edit  | 创建到项目的读写链接。
         | embed | 创建到项目的可嵌入链接。

   --link-password
      设置link命令创建的链接的密码。
      
      在编写本文时，此功能仅适用于OneDrive个人付费帐户。
      

   --hash-type
      指定后端使用的哈希。
      
      这指定了正在使用的哈希类型。如果设置为"auto"，它将使用默认哈希，即QuickXorHash。
      
      在rclone 1.62之前，默认情况下，OneDrive个人使用SHA1哈希。对于1.62及更高版本，默认情况下所有OneDrive类型都使用QuickXorHash。如果需要SHA1哈希，请相应地设置此选项。
      
      从2023年7月起，QuickXorHash将是OneDrive for Business和OneDriver Personal的唯一可用哈希。
      
      可以将其设置为"none"以不使用任何哈希。
      
      如果所请求的哈希在对象上不存在，它将返回一个空字符串，rclone将将其视为缺少的哈希。
      

      示例:
         | auto     | Rclone选择最佳哈希
         | quickxor | QuickXor
         | sha1     | SHA1
         | sha256   | SHA256
         | crc32    | CRC32
         | none     | 无 - 不使用任何哈希

   --encoding
      后端的编码。
      
      有关更多信息，请参阅[概述中的编码部分](/overview/#encoding)。


选项:
   --client-id value      OAuth客户端ID。[$CLIENT_ID]
   --client-secret value  OAuth客户端密钥。[$CLIENT_SECRET]
   --help, -h             显示帮助信息
   --region value         选择OneDrive的国家云区域。（默认值: "global"）[$REGION]

   高级选项

   --access-scopes value         设置rclone请求的范围。（默认值: "Files.Read Files.ReadWrite Files.Read.All Files.ReadWrite.All Sites.Read.All offline_access"）[$ACCESS_SCOPES]
   --auth-url value              认证服务器URL。[$AUTH_URL]
   --chunk-size value            上传文件的块大小 - 必须是320k（327,680字节）的倍数。（默认值: "10Mi"）[$CHUNK_SIZE]
   --disable-site-permission     禁用对Sites.Read.All权限的请求。（默认值: false）[$DISABLE_SITE_PERMISSION]
   --drive-id value              要使用的驱动器的ID。[$DRIVE_ID]
   --drive-type value            驱动器类型（personal | business | documentLibrary）。[$DRIVE_TYPE]
   --encoding value              后端的编码。（默认值: "Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Del,Ctl,LeftSpace,LeftTilde,RightSpace,RightPeriod,InvalidUtf8,Dot"）[$ENCODING]
   --expose-onenote-files        设置以使OneNote文件显示在目录列表中。（默认值: false）[$EXPOSE_ONENOTE_FILES]
   --hash-type value             指定后端使用的哈希。（默认值: "auto"）[$HASH_TYPE]
   --link-password value         设置link命令创建的链接的密码。[$LINK_PASSWORD]
   --link-scope value            设置link命令创建的链接的范围。（默认值: "anonymous"）[$LINK_SCOPE]
   --link-type value             设置link命令创建的链接的类型。（默认值: "view"）[$LINK_TYPE]
   --list-chunk value            列出块的大小。（默认值: 1000）[$LIST_CHUNK]
   --no-versions                 在修改操作中删除所有版本。（默认值: false）[$NO_VERSIONS]
   --root-folder-id value        根文件夹的ID。[$ROOT_FOLDER_ID]
   --server-side-across-configs  允许在不同的OneDrive配置之间进行服务器端操作（例如复制）。（默认值: false）[$SERVER_SIDE_ACROSS_CONFIGS]
   --token value                 OAuth访问令牌，以JSON格式提供。[$TOKEN]
   --token-url value             令牌服务器URL。[$TOKEN_URL]

```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://data-programs.gitbook.io/singularity/zh/cli-reference/storage/update/onedrive.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.