客户端缓存命令行选项命令行工具的版本1.1 中的特性和功能

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

原始产品版本:  Windows 10 –所有版本,Windows Server 2012 R2
原始 KB 数:  884739

介绍

本文包含有关最新版本的客户端缓存命令行选项 (CSCCMD) 命令行工具 ( # A0) 中的功能和功能的信息。

更多信息

您可以使用 CSCCMD 工具在 microsoft windows XP 和 Microsoft Windows Server 2003 中管理 Microsoft Windows 2000 中的脱机文件。 最新版本的 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-使用此开关可在客户端上启用客户端缓存 (CSC) 。 通过此开关,您可以在脱机工作时访问和同步网络文件。

    备注

    若要使用此开关,您必须是本地计算机上的管理员。

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

    备注

    若要使用此开关,您必须是本地计算机上的管理员。

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

    备注

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

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

    备注

    若要使此函数正常运行,必须在此共享或此共享上的任何目录/文件上打开句柄。

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

    备注

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

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

    如果使用用户的 Windows NT 4.0 SID 增强了用户的缓存安全性,则不能从 Windows Server 2003 帐户访问缓存,除非使用 Windows Server 2003 SID restamped 缓存项。

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

  • /PIN2: \ \ 服务器 \ 共享 \ 路径[/user] [/SYSTEM] [/USERINHERIT] [/SYSTEMINHERIT]-使用此开关可固定共享资源。 您可以使用/USER 选项来固定文件。 此操作与使用 " 脱机文件 " 对话框缓存文件的结果相同。 /SYSTEM 选项指定必须通过配置组策略设置来管理共享资源。 /USERINHERIT 选项和/SYSTEMINHERIT] 继承选项指定如何继承 pin 数据。 您可以使用 pin 类型的任意组合。

  • /PIN2: filename /FILELIST [/UNICODE] [/user] [/SYSTEM] [/USERINHERIT] [/SYSTEMINHERIT]

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

    备注

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

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

    MyServer/MyShare//MyServer1/MyShare1

    备注

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

  • /UNPIN2: \ \ 服务器 \ 共享 \ 路径[/user] [/SYSTEM] [/USERINHERIT] [/SYSTEMINHERIT] [/RECURSE]

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

  • /UNPIN2: filename /FILELIST [/UNICODE] [/user] [/SYSTEM] [/USERINHERIT] [/SYSTEMINHERIT]-使用此开关通过使用文件来取消对一组特定的共享资源。 您可以使用 pin 类型的任意组合。

    备注

    /FILELIST 参数指示指定的文件是一个文本文件,每行包含一个文件名。 文件开头的任何空白都将被忽略。 但是,行尾的任何空白都会计算在内。 行由回车字符、换行符或两者的任意组合分隔。

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

  • /FILL: \ \ 服务器 \ 共享 \ 路径-使用此开关可将服务器端数据复制到指定共享资源的本地缓存中。

  • /FILL: FileName /FILELIST [/UNICODE]

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

    备注

    /FILELIST 参数指示指定的文件是一个文本文件,每行包含一个文件名。 文件开头的任何空白都将被忽略。 但是,行尾的任何空白都会计算在内。 行由回车字符、换行符或两者的任意组合分隔。

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

  • /Delete: \ \ 服务器 \ 共享 \ 路径[/RECURSE] [/RECURSE2]

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

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

    备注

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

  • /SETSPACE: 要设置的字节 -使用此开关指定要分配给临时脱机文件的磁盘空间(以字节为单位)。 这些临时脱机文件是 nonpinned 的自动缓存文件。 此函数的工作方式与 " 脱机文件 " 对话框中提供的函数类似。

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

  • /EXTRACT [: \ \ 服务器 \ 共享[*路径*]/target: Path [/RECURSE] [/ONLYMODIFIED] [/STOPONERROR]-使用此开关从本地缓存中提取文件、目录或目录树。 可以使用/TARGET 选项指定要将文件或目录提取到的目标位置。 您可以指定一个已存在的目标文件夹,也可以指定一个尚不存在的目标文件夹。

    备注

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

    您可以使用/ONLYMODIFIED 选项仅提取已脱机修改的那些文件。 如果使用/STOPONERROR 选项,则只要在提取过程中出现错误,抽取过程就会停止。

    备注

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