Recursos e funções na versão 1.1 da ferramenta de linha de comando Command-Line opções de cache Client-Side

Este artigo fornece informações sobre os recursos e funções disponíveis na ferramenta de gerenciamento de arquivos offline CSCCMD 1.1.

Aplica-se a: Microsoft Windows XP e Microsoft Windows Server 2003
Número de KB original: 884739

Introdução

Este artigo contém informações sobre os recursos e funções na versão mais recente da ferramenta de linha de comando CSCCMD (CSCCMD) Client-Side cach Command-Line ing (CSCCMD) (Csccmd.exe).

Mais informações

Você pode usar a ferramenta CSCCMD para gerenciar arquivos offline no Microsoft Windows 2000, no Microsoft Windows XP e no Microsoft Windows Server 2003. A versão mais recente da ferramenta CSCCMD é 1.1. A versão 1.1 inclui novas funções e recursos que não estavam disponíveis nas versões anteriores.

Observação

Os usuários que usam a ferramenta CSCCMD devem ter um bom conhecimento da funcionalidade de cache do lado do cliente.

Para obter a ferramenta CSCCMD, entre em contato com os Serviços de Suporte ao Produto da Microsoft. Para obter uma lista completa de números de telefone dos Serviços de Suporte ao Produto da Microsoft e informações sobre os custos de suporte, visite o seguinte site da Microsoft:

Números de telefone do Serviço de Cliente Global

Observação

Você também pode baixar o CSCCMD 1.0 e outras ferramentas como parte das Ferramentas de Kit de Recursos do Windows Server 2003.

A ferramenta CSCCMD usa a seguinte sintaxe: CSCCMD [/RESID] [/ENABLE] [/DISABLE] [/DISCONNECT: \\Server\Share] [/MOVESHARE: \\Server\Share1 \\Server\Share2 ] [/?]

Os seguintes comutadores de linha de comando e suas funções estão disponíveis na versão mais recente da ferramenta CSCCMD:

  • /ENABLE - Use essa opção para habilitar Client-Side CSC (cache) em um cliente. Essa opção permite acessar e sincronizar arquivos de rede enquanto estiver trabalhando offline.

    Observação

    Você deve ser um administrador no computador local para usar essa opção.

  • /DISABLE - Use essa opção para desabilitar o CSC. Antes de executar esse comando, você deve ter certeza de que fechou todos os arquivos offline. Se você desabilitar o CSC, não poderá trabalhar em arquivos de rede enquanto estiver trabalhando offline.

    Observação

    Você deve ser um administrador no computador local para usar essa opção.

  • /ENUM[:\\ Server\Share[\Path]] [/RECURSE] – Use essa opção para exibir todos os compartilhamentos no cache local. Se você usar essa opção com a opção /RECURSE, a ferramenta CSCCMD exibirá o conteúdo dos compartilhamentos em um compartilhamento pai. Você também pode exibir o conteúdo de um compartilhamento específico de um servidor. Para fazer isso, use o formato \\Server\Share . Por exemplo, use o seguinte comando: CSCCMD /ENUM: \MyServer\MyShare

    Observação

    MyServer é o nome do servidor e MyShare é o nome do recurso compartilhado.

  • /DISCONNECT: \\Server\Share – Use essa opção para desconectar um servidor específico do cache de Client-Side no computador cliente. Use o formato \\Server\Share para especificar o nome de um recurso compartilhado específico de um servidor que você deseja desconectar. Por exemplo, use o seguinte comando: CSCCMD /DISCONNECT: \\MyServer\MyShare
    O agente de cache Client-Side em segundo plano não tenta reconectar o servidor. Se você sincronizar o conteúdo offline usando o gerenciador de sincronização, o agente de cache Client-Side se reconectará ao servidor se ele estiver disponível.

    Observação

    Um identificador deve estar aberto neste compartilhamento ou em qualquer diretório/arquivo neste compartilhamento para que essa função funcione corretamente.

  • /MOVESHARE: \\Server1\Share\\Server2\Share – Use essa opção para mover arquivos e diretórios de um compartilhamento para outro compartilhamento no cache. Essa opção será útil se o destino de arquivos offline tiver sido movido e se o cache local agora precisar apontar para um novo local. Por exemplo, use o seguinte comando: CSCCMD /MOVESHARE: \\MyServer\MyShare\\MyServer1\MyShare1

    Observação

    MyServer1 é o novo nome do servidor e MyShare1 é o nome do novo recurso compartilhado.

  • /RESID - Use essa opção para reativar todas as entradas no banco de dados CSC (arquivos offline) do Windows usando um novo SID (identificador de segurança do usuário). Essa opção é usada em cenários em que uma organização move contas de usuário de um domínio do Microsoft Windows NT 4.0 para um domínio do Windows Server 2003.

    Se o cache de um usuário for aprimorado pela segurança usando o SID Windows NT 4.0 do usuário, o cache não poderá ser acessado da conta do Windows Server 2003, a menos que as entradas de cache sejam restamped usando o SID do Windows Server 2003.

  • /ISENABLED ou /ISCSCENABLED - Use qualquer um desses comutadores para determinar se o CSC está habilitado no computador cliente.

  • /PIN2: \\server\share\path[/USER] [/SYSTEM] [/USERINHERIT] [/SYSTEMINHERIT] – Use essa opção para fixar recursos compartilhados. Você pode usar a opção /USER para fixar um arquivo. Essa ação tem o mesmo resultado que usar a caixa de diálogo Arquivos Offline para armazenar em cache o arquivo. A opção /SYSTEM especifica que o recurso compartilhado deve ser fixado administrativamente configurando as configurações de Política de Grupo. A opção /USERINHERIT e a opção /SYSTEMINHERIT]HERD designa como os dados do pino são herdados. Você pode usar qualquer combinação dos tipos de pinos.

  • /PIN2: nome do arquivo /FILELIST [/UNICODE] [/USER] [/SYSTEM] [/USERINHERIT] [/SYSTEMINHERIT]

  • Use essa opção se quiser usar um arquivo que descreva todos os objetos para fixar como parâmetros. O arquivo contém o caminho UNC (Convenção Universal de Nomenclatura) dos objetos a serem fixados. Os objetos são separados por um retorno/alimentação de linha de transporte. Por exemplo, use o seguinte comando: CSCCMD /PIN: MyShare.txt /FILELIST

    Observação

    O arquivo MyShare.txt contém entradas separadas por espaços.

    Essas entradas são semelhantes às seguintes:

    MyServer/MyShare //MyServer1/MyShare1

    Observação

    A opção /PIN não copia o conteúdo do recurso compartilhado no cache local. A fixação não é suficiente para tornar os arquivos disponíveis offline. Depois de usar a opção /PIN, você deve executar o comando CSCCMD junto com a opção /FILL para copiar o conteúdo do recurso compartilhado para o cache local e garantir que o recurso compartilhado esteja disponível offline. A opção /USERINHERIT e a opção /SYSTEMINHERIT]HERD designa como os dados do pino são herdados. Você pode usar qualquer combinação dos tipos de pinos.

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

  • Use essa opção para desafixar um recurso compartilhado ou para remover um recurso compartilhado do cache local. Se você usar essa opção com a opção /RECURSE, a ferramenta CSCCMD desabilitará todas as crianças do caminho. Se você usar essa opção com a opção /RECURSE2, a ferramenta CSCCMD desapina o caminho e as crianças do caminho. Você pode usar qualquer combinação dos tipos de pinos.

  • /UNPIN2: filename /FILELIST [/UNICODE] [/USER] [/SYSTEM] [/USERINHERIT] [/SYSTEMINHERIT] - Use essa opção para desafixar um conjunto específico de recursos compartilhados usando um arquivo. Você pode usar qualquer combinação dos tipos de pinos.

    Observação

    O parâmetro /FILELIST indica que o arquivo especificado é um arquivo de texto com um nome de arquivo para cada linha. Qualquer espaço em branco no início de um arquivo é ignorado. No entanto, qualquer espaço em branco no final da linha é contado. As linhas são delimitadas por qualquer combinação de caracteres de retorno de transporte, caracteres de linefeed ou ambos.

    Se você usar essa opção com a opção /UNICODE, a ferramenta CSCCMD criará a lista de arquivos no formato de texto Unicode.

  • /FILL: \\Server\Share\Path – Use essa opção para copiar dados do lado do servidor para o cache local para um recurso compartilhado especificado.

  • /FILL: FileName /FILELIST [/UNICODE]

  • Use essa opção para copiar dados do lado do servidor para o cache local para um conjunto de recursos compartilhados especificados usando um arquivo.

    Observação

    O parâmetro /FILELIST indica que o arquivo especificado é um arquivo de texto com um nome de arquivo por linha. Qualquer espaço em branco no início de um arquivo é ignorado. No entanto, qualquer espaço em branco no final da linha é contado. As linhas são delimitadas por qualquer combinação de caracteres de retorno de transporte, caracteres de linefeed ou ambos.

    Se você usar essa opção com a opção /UNICODE, a ferramenta CSCCMD criará a lista de arquivos no formato de texto Unicode.

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

  • Use essa opção para excluir um arquivo, um diretório ou um compartilhamento do cache local. Para excluir um diretório ou um compartilhamento, verifique se o diretório ou o compartilhamento estão vazios antes de usar essa opção. Se o diretório ou o compartilhamento não estiver vazio, você não poderá excluir o diretório ou o compartilhamento. Se o arquivo estiver aberto, você não poderá excluir o arquivo. Se você usar essa opção com a opção /RECURSE, a ferramenta CSCCMD só funcionará nas crianças do caminho. Se você usar essa opção com a opção /RECURSE2, a ferramenta CSCCMD funcionará no caminho e nas crianças do caminho.

  • /ISSERVEROFFLINE: \\Server - Use essa opção para determinar se o CSC considera um servidor específico offline.

    Observação

    Antes de usar essa opção, você deve abrir qualquer compartilhamento, arquivo ou diretório armazenado no cache local para o servidor que você deseja verificar. Se você não fizer isso, o comando CSCCMD sempre informa que o servidor está online. Além disso, o servidor afirma que esse comando relata o estado que o CSC reconhece. Não é o estado real do servidor.

  • /SETSPACE: Bytes to Set - Use essa opção para especificar o espaço em disco em bytes que você deseja alocar para arquivos offline temporários. Esses arquivos offline temporários são arquivos não armazenados em cache automático. Essa função funciona de forma semelhante à função fornecida na caixa de diálogo Arquivos Offline .

  • /CHECKDB [/QUICK] – Use essa opção para examinar o banco de dados CSC e exibir quaisquer sinalizadores de erro de banco de dados. Se você usar essa opção com a opção /QUICK, a ferramenta CSCCMD ignorará a enumeração e apenas exibirá os erros do banco de dados.

  • /EXTRACT[:\\Server\Share[\Path ]] /TARGET: Path [/RECURSE] [/ONLYMODIFIED] [/STOPONERROR] - Use essa opção para extrair um arquivo, um diretório ou uma árvore de diretório do cache local. Você pode usar a opção /TARGET para especificar o destino ao qual deseja extrair o arquivo ou o diretório. Você pode especificar uma pasta de destino que já existe ou especificar uma pasta de destino que ainda não existe.

    Observação

    Se a pasta de destino especificada ainda não existir, o processo criará automaticamente uma pasta que tenha o nome especificado.

    Você pode usar a opção /ONLYMODIFIED para extrair apenas os arquivos que foram modificados offline. Se você usar a opção /STOPONERROR, o processo de extração será interrompido sempre que ocorrer um erro durante o processo de extração.

    Observação

    Como os arquivos no cache offline usam permissões do sistema de arquivos NTFS, você deve ser um administrador no computador local para usar o comutador /EXTRACT.