substituir

  • Artigo

Substitua os arquivos existentes em um diretório. Se usado com a opção /a, esse comando adiciona 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 filename é 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 um caminho, esse comando usará a unidade e o diretório atuais como o destino.
/a 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 depois de pressionar ENTER.
/s Pesquisa todos os subdiretórios no diretório de destino e substitui os 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 em Path1.
/u Substitui somente os arquivos no diretório de destino que são mais antigos do que aqueles no 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.

Comentários

  • À 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 os 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 localizou os arquivos de origem.
    3 Esse comando não localizou o caminho de origem ou de destino.
    5 O usuário não tem acesso aos arquivos que você deseja substituir.
    8 Não há memória suficiente do sistema para executar o comando.
    11 O usuário utilizou a sintaxe errada na linha de comando.

Observação

Você pode usar o parâmetro ERRORLEVEL na linha de comando if em um programa em lotes para processar os 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