Client-Side 缓存 Command-Line 选项命令行工具 1.1 版中的特性和函数

本文提供有关脱机文件管理工具 CSCCMD 1.1 中可用的特性和功能的信息。

适用于： Microsoft Windows XP 和 Microsoft Windows Server 2003
原始 KB 编号： 884739

简介

本文包含有关最新版本 Client-Side 缓存 Command-Line 选项 () 命令行工具 (Csccmd.exe) 的功能的信息。

更多信息

可以使用 CSCCMD 工具在 Microsoft Windows 2000、Microsoft Windows XP 和 Microsoft Windows Server 2003 中管理脱机文件。 最新版本的 CSCCMD 工具为 1.1。 版本 1.1 包括早期版本中未提供的新函数和功能。

注意

使用 CSCCMD 工具的用户必须对客户端缓存功能有很好的了解。

若要获取 CSCCMD 工具，请联系 Microsoft 产品支持服务。 有关 Microsoft 产品支持服务电话号码的完整列表以及有关支持成本的信息，请访问以下 Microsoft 网站：

全球客户服务电话号码

注意

还可以下载 CSCCMD 1.0 和其他工具，作为 Windows Server 2003 资源工具包工具的一部分。

CSCCMD 工具使用以下语法：CSCCMD [/RESID] [/ENABLE] [/DISABLE] [/DISCONNECT： \\Server\Share] [/MOVESHARE： \\Server\Share1 \\Server\Share2 ] [/？]

最新版本的 CSCCMD 工具中提供了以下命令行开关及其功能：

• /ENABLE - 使用此开关可在客户端上启用 Client-Side 缓存 (CSC) 。 此开关允许你在脱机工作时访问和同步网络文件。

  注意

  必须是本地计算机上的管理员才能使用此开关。

• /DISABLE - 使用此开关禁用 CSC。 在运行此命令之前，必须确保已关闭所有脱机文件。 如果禁用 CSC，则脱机工作时无法处理网络文件。

  注意

  必须是本地计算机上的管理员才能使用此开关。

• /ENUM[：\\ Server\Share[\Path]] [/RECURSE] - 使用此开关可显示本地缓存中的所有共享。 如果将此开关与 /RECURSE 选项一起使用，则 CSCCMD 工具会显示父共享中共享的内容。 还可以显示服务器的特定共享的内容。 为此，请使用 \\Server\Share 格式。 例如，使用以下命令：CSCCMD /ENUM： \MyServer\MyShare

  注意

  MyServer 是服务器名称， MyShare 是共享资源的名称。

• /DISCONNECT：\\Server\Share - 使用此开关断开特定服务器与客户端计算机上的 Client-Side 缓存的连接。 使用 \\Server\Share 格式指定要断开连接的服务器的特定共享资源的名称。 例如，使用以下命令：CSCCMD /DISCONNECT： \\MyServer\MyShare
  后台 Client-Side 缓存代理不会尝试重新连接服务器。 如果使用同步管理器同步脱机内容，Client-Side 缓存代理随后会重新连接到服务器（如果可用）。

  注意

  必须在此共享上打开句柄或此共享上的任何目录/文件，才能使此函数正常工作。

• /MOVESHARE：\\Server1\Share\\Server2\Share - 使用此开关将文件和目录从一个共享移动到缓存中的另一个共享。 如果脱机文件的目标已移动，并且本地缓存现在必须指向新位置，则此选项非常有用。 例如，使用以下命令：CSCCMD /MOVESHARE： \\MyServer\MyShare\\MyServer1\MyShare1

  注意

  MyServer1 是新的服务器名称， MyShare1 是新共享资源的名称。

• /RESID - 使用此开关，通过使用新的用户安全标识符 (SID) ， (CSC) 数据库中的 Windows 脱机文件中的所有条目重新采样。 此开关用于组织将用户帐户从 Microsoft Windows NT 4.0 域移动到 Windows Server 2003 域的情况。

  如果使用用户的 Windows NT 4.0 SID 增强了用户的缓存的安全性，则不能从 Windows Server 2003 帐户访问缓存，除非使用 Windows Server 2003 SID 对缓存条目进行重采样。

• /ISENABLED 或 /ISCSCENABLED - 使用这两个开关之一来确定是否在客户端计算机上启用了 CSC。

• /PIN2：\\server\share\path[/USER] [/SYSTEM] [/USERINHERIT] [/SYSTEMINHERIT] - 使用此开关固定共享资源。 可以使用 /USER 选项固定文件。 此操作的结果与使用 “脱机文件 ”对话框缓存文件的结果相同。 /SYSTEM 选项指定必须通过配置组策略设置来管理固定共享资源。 /USERINHERIT 选项和 /SYSTEMINHERIT]INHERIT 选项指定如何继承引脚数据。 可以使用引脚类型的任意组合。

• /PIN2： filename /FILELIST [/UNICODE] [/USER] [/SYSTEM] [/USERINHERIT] [/SYSTEMINHERIT]

• 如果要使用描述所有要固定为参数的对象的文件，请使用此开关。 该文件包含通用命名约定 (UNC) 要固定的对象的路径。 对象由回车符/换行符分隔。 例如，使用以下命令：CSCCMD /PIN： MyShare.txt /FILELIST

  注意

  MyShare.txt 文件包含用空格分隔的条目。

  这些条目类似于以下内容：

  MyServer/MyShare //MyServer1/MyShare1

  注意

  /PIN 开关不会将共享资源的内容复制到本地缓存中。 固定不足以使文件脱机可用。 使用 /PIN 开关后，必须将 CSCCMD 命令与 /FILL 开关一起运行，以便将共享资源的内容复制到本地缓存，并确保共享资源脱机可用。 /USERINHERIT 选项和 /SYSTEMINHERIT]INHERIT 选项指定如何继承引脚数据。 可以使用引脚类型的任意组合。

• /UNPIN2： \\server\share\path[/USER] [/SYSTEM] [/USERINHERIT] [/SYSTEMINHERIT] [/RECURSE]

• 使用此开关可取消固定共享资源，或从本地缓存中删除共享资源。 如果将此开关与 /RECURSE 选项一起使用，则 CSCCMD 工具会取消固定路径的所有子级。 如果将此开关与 /RECURSE2 选项一起使用，则 CSCCMD 工具会取消固定路径和路径的子级。 可以使用引脚类型的任意组合。

• /UNPIN2： filename /FILELIST [/UNICODE] [/USER] [/SYSTEM] [/USERINHERIT] [/SYSTEMINHERIT] - 使用此开关可使用文件取消固定特定的共享资源集。 可以使用引脚类型的任意组合。

  注意

  /FILELIST 参数指示指定的文件是一个文本文件，每行都有一个文件名。 将忽略文件开头的任何空格。 但是，将计算行末尾的任何空白。 行由回车字符和/或换行符的任意组合分隔。

  如果将此开关与 /UNICODE 选项一起使用，CSCCMD 工具会创建 Unicode 文本格式的文件列表。

• /FILL： \\Server\Share\Path - 使用此开关将服务器端数据复制到指定共享资源的本地缓存。

• /FILL： FileName /FILELIST [/UNICODE]

• 使用此开关可以使用 文件将服务器端数据复制到一组指定共享资源的本地缓存。

  注意

  /FILELIST 参数指示指定的文件是每行具有一个文件名的文本文件。 将忽略文件开头的任何空格。 但是，将计算行末尾的任何空白。 行由回车字符和/或换行符的任意组合分隔。

  如果将此开关与 /UNICODE 选项一起使用，CSCCMD 工具会创建 Unicode 文本格式的文件列表。

• /DELETE： \\Server\Share\Path[/RECURSE] [/RECURSE2]

• 使用此开关可从本地缓存中删除文件、目录或共享。 若要删除目录或共享，在使用此开关之前，必须确保该目录或共享为空。 如果目录或共享不为空，则无法删除目录或共享。 如果文件处于打开状态，则无法删除该文件。 如果将此开关与 /RECURSE 选项一起使用，则 CSCCMD 工具仅对路径的子级运行。 如果将此开关与 /RECURSE2 选项一起使用，则 CSCCMD 工具将针对路径和子路径进行操作。

• /ISSERVEROFFLINE： \\Server - 使用此开关可确定 CSC 是否认为特定服务器处于脱机状态。

  注意

  使用此开关之前，必须打开存储在要验证的服务器本地缓存上的任何共享、文件或目录。 如果不执行此操作，CSCCMD 命令将始终报告服务器处于联机状态。 此外，此命令报告的服务器状态是 CSC 识别的状态。 它不是实际的服务器状态。

• /SETSPACE： 要设置的字节 数 - 使用此开关可指定要分配给临时脱机文件的磁盘空间（以字节为单位）。 这些临时脱机文件是非固定的自动缓存文件。 此函数的工作方式类似于 “脱机文件 ”对话框中提供的函数。

• /CHECKDB [/QUICK] - 使用此开关可检查 CSC 数据库并显示任何数据库错误标志。 如果将此开关与 /QUICK 选项一起使用，则 CSCCMD 工具将跳过枚举，并仅显示数据库错误。

• /EXTRACT[：\\Server\Share[\Path ]] /TARGET： Path [/RECURSE] [/ONLYMODIFIED] [/STOPONERROR] - 使用此开关可从本地缓存中提取文件、目录或目录树。 可以使用 /TARGET 选项指定要将文件或目录提取到的目标。 可以指定已存在的目标文件夹，也可以指定尚不存在的目标文件夹。

  注意

  如果指定的目标文件夹尚不存在，则该过程会自动创建具有指定名称的文件夹。

  可以使用 /ONLYMODIFIED 选项仅提取已脱机修改的文件。 如果使用 /STOPONERROR 选项，则提取过程将在提取过程中发生错误时停止。

  注意

  由于脱机缓存中的文件使用 NTFS 文件系统权限，因此你必须是本地计算机上的管理员才能使用 /EXTRACT 开关。