Partilhar via

substituir

Substitua 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 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 os arquivos substituídos. Se você não especificar uma unidade ou caminho, esse comando usará a unidade e o diretório atuais como destino.
/um Adiciona novos arquivos ao diretório de destino em vez de substituir os arquivos existentes. Não é possível 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 que a pesquisa por arquivos de origem comece. Se você não especificar /w, este 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 os arquivos correspondentes. Não é possível usar /s com a opção de linha de comando /a. O comando não pesquisa subdiretórios especificados em Path1.
/u Substitui apenas os arquivos no diretório de destino que são mais antigos do que aqueles no diretório de origem. Não é possível usar /u com a opção de linha de comando /a.
/? Exibe a ajuda no prompt de comando.

Observações

  • À medida que este comando adiciona ou substitui ficheiros, os nomes dos ficheiros aparecem no ecrã. 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 de discos.

  • Não é possível usar esse comando para atualizar arquivos ocultos ou arquivos do sistema.

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

    Código de saída Descrição
    0 Este comando substituiu ou adicionou os ficheiros com êxito.
    1 Este comando encontrou uma versão incorreta do MS-DOS.
    2 Este comando não conseguiu encontrar os ficheiros de origem.
    3 Este comando não conseguiu encontrar 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 de 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