Compartilhar via

substitui

Substitua arquivos existentes em um diretório. Se usado com a opção /a, esse comando adicionará novos arquivos a um diretório em vez de substituir arquivos existentes.

Sintaxe

replace [<drive1>:][<path1>]<filename> [<drive2>:][<path2>] [/a] [/p] [/r] [/w]
replace [<drive1>:][<path1>]<filename> [<drive2>:][<path2>] [/p] [/r] [/s] [/w] [/u]

Parâmetros

Parâmetro Descrição
[<drive1>:][<path1>]<filename> Especifica o local e o nome do arquivo de origem ou do conjunto de arquivos. A opção nome de arquivo é necessária e pode incluir caracteres curinga (* e ?).
[<drive2>:][<path2>] Especifica o local do arquivo de destino. Não é possível especificar um nome de arquivo para arquivos que você substitui. Se você não especificar uma unidade ou caminho, esse comando usará a unidade e o diretório atuais como o destino.
/um Adiciona novos arquivos ao diretório de destino em vez de substituir arquivos existentes. Você não pode usar essa opção de linha de comando com a opção de linha de comando /s ou /u.
/p Solicita confirmação antes de substituir um arquivo de destino ou adicionar um arquivo de origem.
/r Substitui arquivos somente leitura e desprotegidos. Se você tentar substituir um arquivo somente leitura, mas não especificar /r, um erro resultará e interromperá a operação de substituição.
/w Aguarda que você insira um disco antes do início da pesquisa de arquivos de origem. Se você não especificar /w, esse comando começará a substituir ou adicionar arquivos imediatamente após pressionar ENTER.
/s Pesquisa todos os subdiretórios no diretório de destino e substitui arquivos correspondentes. Você não pode usar /s com a opção de linha de comando /a. O comando não pesquisa subdiretórios especificados no Path1.
/u Substitui somente os arquivos no diretório de destino que são mais antigos do que os do diretório de origem. Você não pode usar /u com a opção de linha de comando /a.
/? Exibe a ajuda no prompt de comando.

Observações

  • À medida que esse comando adiciona ou substitui arquivos, os nomes de arquivo aparecem na tela. Depois que esse comando for concluído, uma linha de resumo será exibida em um dos seguintes formatos:

    nnn files added
nnn files replaced
no file added
no file replaced

  • Se você estiver usando disquetes e precisar alternar discos durante a execução desse comando, poderá especificar a opção de linha de comando /w para que esse comando aguarde a troca dos discos.

  • Você não pode usar esse comando para atualizar arquivos ocultos ou arquivos do sistema.

  • A tabela a seguir mostra cada código de saída e uma breve descrição de seu significado:

    Código de saída Descrição
    0 Esse comando substituiu ou adicionou os arquivos com êxito.
    1 Esse comando encontrou uma versão incorreta do MS-DOS.
    2 Esse comando não conseguiu localizar os arquivos de origem.
    3 Esse comando não conseguiu localizar o caminho de origem ou destino.
    5 O usuário não tem acesso aos arquivos que você deseja substituir.
    oito Não há memória do sistema suficiente para executar o comando.
    11 O usuário usou a sintaxe errada na linha de comando.

Observação

Você pode usar o parâmetro ERRORLEVEL no se linha de comando em um programa em lotes para processar códigos de saída retornados por esse comando.

Exemplos

Para atualizar todas as versões de um arquivo chamado Phones.cli (que aparecem em vários diretórios na unidade C:), com a versão mais recente do arquivo Phones.cli de um disquete na unidade A:, digite:

replace a:\phones.cli c:\ /s