> For the complete documentation index, see [llms.txt](https://chaoses-ib.gitbook.io/directory-opus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chaoses-ib.gitbook.io/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-2/readme.zh/setattr.zh.md).

# SetAttr

**SetAttr** 内部命令可用于：

* 修改文件或文件夹的属性
* 压缩（通过设置 **C** 属性）或加密文件（通过设置 **E** 属性），并设置文件夹的默认压缩/加密状态
* 修改文件或文件夹的上次修改和创建的时间戳
* 修改文件元数据，可以通过 [用户界面](/directory-opus/guan-fang-shou-ce/readme.zh-2/readme.zh-3.md) 或 [以编程方式](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-6/keywords_for_setattr_meta.zh.md)
* 为文件和文件夹分配你自己的描述，并编辑 Zip 压缩包的内部 [注释](/directory-opus/guan-fang-shou-ce/readme.zh-2/readme.zh-2/readme.zh-1/zip_comment.zh.md)
* 修改远程 FTP 站点上的文件属性

**命令参数：**

| 参数             | 类型                           | 可能的值                    | 描述                                                                                                                                                                                                                                                                                                                                                                                                        |
| -------------- | ---------------------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *(无参数)*        | -                            | -                       | <p>显示 <a href="/directory-opus/guan-fang-shou-ce/readme.zh-2/changing_attributes.zh.md"><strong>更改属性和时间</strong></a> 对话框，该对话框允许你修改所选文件和文件夹的属性和时间戳。</p><p><em>示例：</em> <code>SetAttr</code></p>                                                                                                                                                                                                            |
| ATTR           | /K                           | *<属性>*                  | <p>设置所选文件和文件夹的指定属性，并清除所有其它属性。<em><属性></em> 值必须包含以下一个或多个字母：</p><p>请注意，修改 <strong>C</strong> 或 <strong>E</strong> 属性可能会比正常情况下花费更长时间，因为文件数据必须（解）压缩或（解）加密。为文件夹设置这些属性会设置在这些文件夹中创建的新文件的默认压缩/加密状态。可以对文件进行压缩或加密，但不能同时进行。</p><p><em>示例：</em> <code>SetAttr ATTR rca</code></p>                                                                                                                                     |
|                |                              |                         |                                                                                                                                                                                                                                                                                                                                                                                                           |
| **R**          | 只读（无法删除或覆盖文件）                |                         |                                                                                                                                                                                                                                                                                                                                                                                                           |
| **A**          | 压缩包（需要压缩包文件，由备份工具使用）         |                         |                                                                                                                                                                                                                                                                                                                                                                                                           |
| **H**          | 隐藏（文件可以标记为隐藏以在显示中隐藏它们）       |                         |                                                                                                                                                                                                                                                                                                                                                                                                           |
| **S**          | 系统（文件是系统文件 - 通常与 **H** 结合设置） |                         |                                                                                                                                                                                                                                                                                                                                                                                                           |
| **N**          | 正常（正常属性，没有设置其它属性）            |                         |                                                                                                                                                                                                                                                                                                                                                                                                           |
| **I**          | 非内容索引（内容不会被系统编入索引）           |                         |                                                                                                                                                                                                                                                                                                                                                                                                           |
| **C**          | 压缩（仅限于 NTFS 格式化的驱动器）         |                         |                                                                                                                                                                                                                                                                                                                                                                                                           |
| **E**          | 加密（仅限于 NTFS 格式化的驱动器）         |                         |                                                                                                                                                                                                                                                                                                                                                                                                           |
| CHMOD          | /K                           | *<属性掩码>*                | <p>设置远程 FTP 站点上文件的指定属性。<em><属性掩码></em> 使用 <a href="http://en.wikipedia.org/wiki/File_system_permissions#Octal_notation">八进制表示法</a> 指定。</p><p><em>示例：</em> <code>SetAttr CHMOD 666</code></p>                                                                                                                                                                                                              |
| CLEARATTR      | /K                           | *<属性>*                  | <p>清除所选文件和文件夹的指定属性。指定的属性将被关闭，但其它属性将保持不变。有关属性值列表，请参见 <strong>ATTR</strong> 参数的描述。</p><p><em>示例：</em> <code>SetAttr CLEARATTR c</code></p>                                                                                                                                                                                                                                                                  |
| CREATED        | /K                           | *<日期/时间>*               | <p>设置所选文件和文件夹的创建时间戳。此参数的值可以仅作为一个日期、仅作为一个时间或一个日期和时间来给出。</p><p>日期字符串的可接受格式为 <strong>YYYYMMDD</strong> 或 <strong>YYYY-MM-DD</strong>，并且时间字符串必须为 <strong>HH:MM:SS</strong> 格式。</p><p>如果你指定时间和日期，则时间必须在日期之后，用空格分隔，并且你必须用引号将整个值括起来（因为有嵌入空格）。如果只提供时间，则文件的当前日期将保留（反之亦然）。</p><p><em>示例：</em> <code>SetAttr CREATED "1973-09-22 3:35"</code></p>                                                                    |
|                |                              | **now**                 | <p>将创建时间戳设置为当前日期和时间。</p><p><em>示例：</em> <code>SetAttr CREATED=now</code></p>                                                                                                                                                                                                                                                                                                                              |
|                |                              | **modified**            | <p>复制文件的最后修改时间戳。</p><p><em>示例：</em> <code>SetAttr CREATED=modified</code></p>                                                                                                                                                                                                                                                                                                                             |
|                |                              | **taken**               | <p>对于图像文件，复制 <em>拍摄日期</em> 时间戳。如果文件没有 EXIF 标记，则创建的时间戳将不会更改。</p><p><em>示例：</em> <code>SetAttr CREATED=taken</code></p>                                                                                                                                                                                                                                                                                     |
|                |                              | **digitized**           | <p>对于图像文件，复制 <em>数字化日期</em> 时间戳。如果文件没有 EXIF 标记，则创建的时间戳将不会更改。</p><p><em>示例：</em> <code>SetAttr CREATED=digitized</code></p>                                                                                                                                                                                                                                                                                |
|                |                              | **parent**              | <p>从父文件夹复制创建的时间戳。</p><p><em>示例：</em> <code>SetAttr CREATED=parent</code></p>                                                                                                                                                                                                                                                                                                                              |
|                |                              | **doccreated**          | <p>对于文档文件，复制 <em>文档创建</em> 时间戳。如果文件在其元数据中没有此时间戳，则创建的时间戳将不会更改。</p><p><em>示例：</em> <code>SetAttr CREATED=doccreated</code></p>                                                                                                                                                                                                                                                                              |
|                |                              | **docedited**           | <p>对于文档文件，复制 //文档最后编辑 //时间戳。如果文件在其元数据中没有此时间戳，则创建的时间戳将不会更改。</p><p><em>示例：</em> <code>SetAttr CREATED=docedited</code></p>                                                                                                                                                                                                                                                                                  |
|                |                              | **docsaved**            | <p>对于文档文件，复制 <em>文档上次保存</em> 时间戳。如果文件在其元数据中没有此时间戳，则创建的时间戳将不会更改。</p><p><em>示例：</em> <code>SetAttr CREATED=docsaved</code></p>                                                                                                                                                                                                                                                                              |
| DEHYDRATE      | /S                           | *(无值)*                  | <p>对于 Windows 10 及更高版本上的云文件，此命令会“脱水”文件（删除本地数据并用占位符替换）。这等效于 OneDrive 添加的“释放空间”上下文菜单命令。</p><p><em>示例：</em> <code>SetAttr DEHYDRATE</code></p>                                                                                                                                                                                                                                                               |
| DESCRIPTION    | /O                           | *(无值)*                  | <p>显示 <a href="/directory-opus/guan-fang-shou-ce/readme.zh-2/file_descriptions.zh.md"><strong>设置描述</strong></a> 对话框，该对话框允许你为选定的文件和文件夹分配你自己的描述字符串。</p><p><em>示例：</em> <code>SetAttr DESCRIPTION</code></p>                                                                                                                                                                                                 |
|                |                              | *<描述>*                  | <p>将所选文件和文件夹的描述设置为指定字符串。</p><p><em>示例：</em> <code>SetAttr DESCRIPTION "Project Files for Keith"</code></p><p>请注意，空字符串将被视为根本没有传递字符串，从而导致 <a href="/directory-opus/guan-fang-shou-ce/readme.zh-2/file_descriptions.zh.md"><strong>设置描述</strong></a> 对话框打开。如果要使用空字符串来清除描述，请改用 <strong>SETDESCRIPTION</strong> 参数。</p>                                                                                        |
| FILE           | /M                           | *<文件名>, ...*            | <p>指定要修改的文件或文件的文件名。如果你不提供此参数，则该命令将对源文件窗口中所有选定的项进行操作。这是 <strong>SetAttr</strong> 命令的默认参数 - 你不需要指定 <strong>FILE</strong> 关键字。</p><p>如果你只指定文件名而不是文件或文件的完整路径，Opus 将在当前源文件夹中查找。你还可以指定 <a href="/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh/pattern_matching_syntax.zh.md">通配符模式</a>。请记住，如果文件名包含空格，则需要用引号将其括起来。 <em>示例:</em> <code>SetAttr \*.xls DESCRIPTION "2011 年年报" SETATTR r</code></p>      |
| 过滤器            | /K                           | *<过滤器>*                 | <p>对选定文件夹的内容应用指定的过滤器。过滤器之前必须在【配置】中的\*\*<a href="/directory-opus/guan-fang-shou-ce/readme.zh-5/readme.zh/readme.zh-5/filters.zh.md">过滤器</a>\*\*页面创建。还可以直接指定一个<a href="/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh/pattern_matching_syntax.zh.md">简单通配符模式</a></p><p><em>示例:</em> <code>SetAttr FILTER "temp files" ATTR n</code></p>                                                           |
| FILTERDEF      | /K/R                         | *\<filter>*             | <p>允许使用<a href="/directory-opus/guan-fang-shou-ce/readme.zh-2/readme.zh-4/textual_filters.zh.md">文本格式</a>定义过滤器，以便对选定文件夹的内容进行过滤。这类似于<strong>FILTER</strong>参数，但不必预定义过滤器。</p><p>这是一个 <strong>/R</strong> 参数，因此在 <strong>FILTERDEF</strong> 关键字后面的所有内容都将作为该参数的值来处理。</p><p><em>示例:</em> <code>SetAttr ATTR n FILTERDEF name match \*.zip and size match > 2 mb</code></p>                                     |
| 元数据            | /O/M                         | *(无值)*                  | <p>显示\*\*<a href="/directory-opus/guan-fang-shou-ce/readme.zh-2/readme.zh-3.md">设置元数据</a>\*\*对话框，你可以使用该对话框修改选定文件和文件夹的元数据。</p><p><em>示例:</em> <code>SetAttr META</code></p>                                                                                                                                                                                                                                |
|                |                              | *keyword:\<value>, ...* | <p>将指定的元数据字段设置为提供的。更改（如适用）将应用于所有选定的文件。</p><p>如果值包含任何空格，则必须用引号将每个 <em>keyword:\<value></em> 对括起来。此参数可以接受多个 <em>keyword:\<value></em> 对，以便一次对多个元数据字段进行更改。</p><p>有关详细信息，请参见有关<a href="/directory-opus/guan-fang-shou-ce/readme.zh-2/readme.zh-3/programmatic_setting_of_metadata.zh.md">通过编程设置元数据</a>的部分。</p><p><em>示例:</em> <code>SetAttr META "artist:Pink Floyd" "album:Dark Side of the Moon"</code></p> |
| 修改             | /K                           | *\<date/time>*          | <p>设置选定文件和文件夹的上次修改时间戳。可以将此参数的值指定为仅日期、仅时间或日期和时间。</p><p>日期字符串的接受格式为 <strong>YYYYMMDD</strong> 或 <strong>YYYY-MM-DD</strong>，时间字符串必须为 <strong>HH:MM:SS</strong> 格式。</p><p>如果您指定时间和日期，则时间必须紧跟在日期之后，用空格分隔，并且必须用引号将整个值括起来（因为有嵌入的空格）。如果仅提供时间，则文件当前的日期将保留下来（反之亦然）。</p><p><em>示例:</em> <code>SetAttr MODIFIED 20080110</code></p>                                                                                  |
|                |                              | **now**                 | <p>将上次修改时间戳设置为当前日期和时间。</p><p><em>示例:</em> <code>SetAttr MODIFIED=now</code></p>                                                                                                                                                                                                                                                                                                                           |
|                |                              | **created**             | <p>复制文件的创建时间戳。</p><p><em>示例:</em> <code>SetAttr MODIFIED=created</code></p>                                                                                                                                                                                                                                                                                                                               |
|                |                              | **taken**               | <p>对于图像文件，复制 <em>拍摄日期</em>时间戳。如果文件没有 EXIF 标记，则上次修改时间戳将不会更改。</p><p><em>示例:</em> <code>SetAttr MODIFIED=taken</code></p>                                                                                                                                                                                                                                                                                    |
|                |                              | **digitized**           | <p>对于图像文件，复制 <em>数字化日期</em>时间戳。如果文件没有 EXIF 标记，则上次修改时间戳将不会更改。</p><p><em>示例:</em> <code>SetAttr MODIFIED=digitized</code></p>                                                                                                                                                                                                                                                                               |
|                |                              | **parent**              | <p>从父文件夹复制上次修改时间戳。</p><p><em>示例:</em> <code>SetAttr MODIFIED=parent</code></p>                                                                                                                                                                                                                                                                                                                            |
|                |                              | **doccreated**          | <p>对于文档文件，复制 <em>文档创建</em>时间戳。如果文件在其元数据中没有这个时间戳，则上次修改时间戳不会更改。</p><p><em>示例:</em> <code>SetAttr MODIFIED=doccreated</code></p>                                                                                                                                                                                                                                                                             |
|                |                              | **docedited**           | <p>对于文档文件，复制 //文档上次编辑 //时间戳。如果文件在其元数据中没有这个时间戳，则上次修改时间戳不会更改。</p><p><em>示例:</em> <code>SetAttr MODIFIED=docedited</code></p>                                                                                                                                                                                                                                                                                |
|                |                              | **docsaved**            | <p>对于文档文件，复制 <em>文档上次保存</em>时间戳。如果文件在其元数据中没有这个时间戳，则上次修改时间戳不会更改。</p><p><em>示例:</em> <code>SetAttr MODIFIED=docsaved</code></p>                                                                                                                                                                                                                                                                             |
| PIN            | /O                           | *(无值)*                  | <p>对于 Windows 10 及更高版本的云文件，此命令切换文件上的“已固定”状态。这等效于 OneDrive 添加的“始终保持在此设备上”上下文菜单命令。当文件被“固定”时，它一直保存在该设备上。当它被“取消固定”时，它可能被保存在本地，也可能不被保存在本地。</p><p><em>示例:</em> <code>SetAttr PIN</code></p>                                                                                                                                                                                                                     |
|                |                              | **yes**                 | <p>在选定的云文件上设置已固定状态。</p><p><em>示例:</em> <code>SetAttr PIN=yes</code></p>                                                                                                                                                                                                                                                                                                                                   |
|                |                              | **no**                  | <p>清除选定的云文件上的已固定状态。</p><p><em>示例:</em> <code>SetAttr PIN=no</code></p>                                                                                                                                                                                                                                                                                                                                    |
| 递归             | /O                           | *(无值)*                  | <p>通过此命令进行的更改将递归地应用于选定文件夹中的文件。这不会影响 <strong>META</strong> 参数 - 只有属性、时间戳和说明可以递归应用。</p><p><em>示例:</em> <code>SetAttr CLEARATTR hs RECURSE</code></p>                                                                                                                                                                                                                                                        |
|                |                              | **no**                  | <p>如果默认情况下已启用递归选项，则阻止命令递归执行。</p><p><em>示例:</em> <code>SetAttr SETDESCRIPTION="2023 Trip To Japan" RECURSE=no</code></p>                                                                                                                                                                                                                                                                                   |
| SETATTR        | /K                           | *\<attributes>*         | <p>为选定的文件和文件夹设置指定属性。指定的属性将被启用，但不会更改其它属性。有关属性值的列表，请参见 <strong>ATTR</strong> 参数的说明。</p><p><em>示例:</em> <code>SetAttr SETATTR r</code></p>                                                                                                                                                                                                                                                                   |
| SETDESCRIPTION | /O                           | *(无值)*                  | <p>清除选定文件和文件夹的说明。</p><p><em>示例:</em> <code>SetAttr SETDESCRIPTION</code></p><p><strong>DESCRIPTION</strong> 和 <strong>SETDESCRIPTION</strong> 参数的区别在于，在没有给定值时的不同行为。<strong>SETDESCRIPTION</strong> 清除说明，而 <strong>DESCRIPTION</strong> 打开一个对话框，让您键入说明。</p>                                                                                                                                                |
|                |                              | *\<description>*        | <p>将选定文件和文件夹的说明设置为指定字符串。</p><p><em>示例:</em> <code>SetAttr SETDESCRIPTION "Approved for release"</code></p>                                                                                                                                                                                                                                                                                                |
| TOGGLEATTR     | /K                           | *\<attributes>*         | <p>切换（反转）指定属性的状态。如果指定了每个属性，并且该属性当前已设置，则该属性将被清除，反之亦然。没有指定的属性将不受影响。有关属性值的列表，请参见 <strong>ATTR</strong> 参数的说明。</p><p><em>示例:</em> <code>SetAttr TOGGLEATTR h</code></p>                                                                                                                                                                                                                                       |
| ZIPCOMMENT     | /S                           | *(无值)*                  | 查看压缩包内容时，允许你编辑压缩包内部的[Zip 注释](/directory-opus/guan-fang-shou-ce/readme.zh-2/readme.zh-2/readme.zh-1/zip_comment.zh.md)。注释存储在压缩包内，可以使用其它压缩工具显示。 *范例:* `SetAttr ZIPCOMMENT`                                                                                                                                                                                                                                  |

|       |                              |
| ----- | ---------------------------- |
| **R** | 只读（无法删除或覆盖文件）                |
| **A** | 压缩包（需要压缩包文件，由备份工具使用）         |
| **H** | 隐藏（文件可以标记为隐藏以在显示中隐藏它们）       |
| **S** | 系统（文件是系统文件 - 通常与 **H** 结合设置） |
| **N** | 正常（正常属性，没有设置其它属性）            |
| **I** | 非内容索引（内容不会被系统编入索引）           |
| **C** | 压缩（仅限于 NTFS 格式化的驱动器）         |
| **E** | 加密（仅限于 NTFS 格式化的驱动器）         |
