Doskey

Chama o programa Doskey.exe, que repete os comandos do Microsoft Windows, edita linhas de comandos e cria macros.

Sintaxe

doskey {/reinstall | /listsize=tamanho | /macros:[{all | executável}] | /history | /insert | /overstrike | /exename=executável | /macrofile=nome_do_arquivo | nome_da_macro=[texto]}

Parâmetros

/reinstall: Instala uma nova cópia do Doskey.exe. Limpa o buffer de histórico de comandos.
/listsize=tamanho: Especifica o número máximo de comandos no buffer de histórico.
/macros: Exibe uma lista de todas as macros do doskey. Use um símbolo de redirecionamento (>) com a opção /macros para redirecionar a lista para um arquivo. Para representar a opção /macros de modo abreviado, use /m.
all: Exibe as macros do doskey para todos os executáveis.
executável: Exibe as macros do doskey para o executável especificado.
/history: Exibe todos os comandos armazenados na memória. Use um símbolo de redirecionamento (>) com a opção /history para redirecionar a lista para um arquivo. Você pode abreviar /history como /h.
{/insert | /overstrike}: Especifica se o novo texto digitado deve substituir ou não o texto antigo. Se você usar a opção /insert, o novo texto digitado em uma linha será inserido no texto antigo (como se você tivesse pressionado a tecla INSERT). Se for usada a opção /overstrike, o novo texto substituirá o texto antigo. A configuração padrão é /overstrike.
/exename=executável: Especifica o programa (executável) no qual a macro do doskey será executada.
/macrofile=nome_do_arquivo: Especifica um arquivo que contém as macros a serem instaladas.
nome_da_macro=[texto]: Cria uma macro que executa os comandos especificados por texto. Nome_da_macro especifica o nome a ser atribuído à macro. Texto especifica os comandos a serem gravados. Se texto estiver em branco, o nome_da_macro será apagado de todos os comandos atribuídos.
/?: Exibe ajuda no prompt de comando.

Comentários

Usando o Doskey.exe
O programa Doskey.exe está sempre disponível para todos os programas interativos e baseados em caracteres (como programas depuradores de programação ou de transferência de arquivos) e mantém um buffer de histórico de comandos e macros para cada programa iniciado. Não é possível usar opções de linha de comando de doskey de um programa. É necessário executar as opções de linha de comando de doskey antes de iniciar um programa. As atribuições de teclas do programa substituem as atribuições de teclas do doskey.

Repetindo um comando

Para repetir um comando, você pode usar qualquer uma das teclas a seguir após iniciar o Doskey.exe. Se você o usar dentro de um programa, as atribuições de teclas do programa têm precedência.

Tecla	Descrição
SETA PARA CIMA	Repete o comando utilizado antes daquele que está sendo exibido.
SETA PARA BAIXO	Repete o comando utilizado depois daquele que está sendo exibido.
PAGE UP	Repete o comando mais antigo utilizado na sessão atual.
PAGE DOWN	Repete o comando mais recente utilizado por você.

Editando a linha de comando

Com o programa Doskey.exe, você pode editar a linha de comando atual. Se você usar o Doskey dentro de um programa, as atribuições de teclas desse programa terão precedência e algumas teclas de edição do Doskey.exe poderão não funcionar.

A lista a seguir descreve as teclas de edição de doskey e suas funções:

Tecla ou combinação de teclas	Descrição
SETA PARA A ESQUERDA	Move o ponto de inserção um caractere para trás.
SETA PARA A DIREITA	Move o ponto de inserção um caractere adiante.
CTRL+SETA PARA A ESQUERDA	Move o ponto de inserção uma palavra para trás.
CTRL+SETA PARA A DIREITA	Move o ponto de inserção uma palavra adiante.
HOME	Move o ponto de inserção para o início da linha.
END	Move o ponto de inserção para o fim da linha.
ESC	Apaga a exibição do comando.
F1	Copia um caractere da mesma coluna do modelo para a mesma coluna do prompt de comando. (O modelo é um buffer de memória que guarda o último comando digitado.)
F2	Procura no modelo a próxima tecla que você digitar depois de pressionar F2. Doskey.exe insere o texto do modelo até, mas não inclusive, o caractere especificado.
F3	Copia o restante do modelo para a linha de comando. Doskey.exe começa a copiar caracteres a partir da posição no modelo que corresponde à posição indicada pelo ponto de inserção na linha de comando.
F4	Exclui os caracteres a partir da posição atual do ponto de inserção até um caractere especificado. Para usar esta tecla de edição, pressione F4 e digite um caractere. Doskey.exe exclui os caracteres a partir da posição atual do ponto de inserção até a primeira letra especificada.
F5	Copia o modelo para a linha de comando atual.
F6	Insere um caractere de fim de arquivo (CTRL+Z) na posição atual do ponto de inserção.
F7	Exibe todos os comandos para este programa armazenados na memória em uma caixa pop-up. Use as teclas SETA PARA CIMA e SETA PARA BAIXO para selecionar o comando desejado e pressione a tecla `ENTER` para executar o comando. Você também pode anotar o número sequencial na frente do comando e utilizar esse número juntamente com a tecla F9.
ALT+F7	Exclui todos os comandos armazenados na memória para o buffer de histórico atual.
F8	Exibe todos os comandos do buffer de histórico que iniciam com os caracteres do comando atual.
F9	Solicita um número de comando do buffer de histórico, depois exibe o comando associado ao número especificado. Pressione a tecla `ENTER` para executar o comando. Para mostrar todos os números e os comandos associados, pressione a tecla F7.
ALT+F10	Exclui todas as configurações de macro.

Usando doskey dentro de um programa
Determinados programas interativos e baseados em caracteres, como depuradores de programação ou de transferência de arquivos (FTP), utilizam o programa Doskey.exe automaticamente. Para fazer isso, um programa precisa ser um processo de console e usar entrada em buffer. As atribuições de teclas do programa substituem as atribuições de teclas do doskey. Por exemplo, se o programa usar a tecla F7 para alguma função, você não conseguirá obter um histórico dos comandos do doskey em uma janela pop-up.
Com o Doskey.exe você pode manter um histórico de comandos para cada programa que iniciar, repetir e editar comandos anteriores no prompt de comando do programa e iniciar as macros de doskey criadas para o programa. Se você sair e depois reiniciar um programa a partir da mesma janela do prompt de comando, o histórico de comandos da sessão anterior do programa estará disponível.
É necessário executar o Doskey.exe antes de iniciar um programa. Não é possível usar as opções de linha de comando de doskey a partir do prompt de comando de um programa, mesmo que o programa tenha um comando shell.
Se desejar personalizar o funcionamento do Doskey.exe com um programa e criar macros de doskey para ele, você poderá criar um arquivo em lotes que modifique o Doskey.exe e inicie o programa.
Especificando um modo de inserção padrão
Se você pressionar a tecla INSERT, poderá digitar um texto na linha de comando doskey no meio de um texto antigo, sem substituí-lo. Contudo, depois que você pressionar ENTER, o Doskey.exe retornará o teclado para o modo de substituição. Você deverá pressionar a tecla INSERT novamente para retornar ao modo de inserção.
Use /insert para mudar o teclado para o modo de inserção toda vez que você pressionar a tecla ENTER. O teclado permanecerá no modo de inserção até que seja utilizada a opção /overstrike. Você pode, temporariamente, retornar ao modo de substituição pressionando a tecla INSERT; contudo, depois de pressionar ENTER, o Doskey.exe retornará o teclado ao modo de inserção.
O ponto de inserção muda de forma quando você utiliza a tecla INSERT para alternar de um modo para o outro.

Criando uma macro

Você pode utilizar o Doskey.exe para criar macros que executem um ou mais comandos. A tabela a seguir lista os caracteres especiais usados para controlar as operações de comando ao definir uma macro:

Caractere	Descrição
$G ou $g	Redireciona saídas. Utilize um desses caracteres especiais para enviar saídas para um dispositivo ou um arquivo, em vez de enviar para a tela. Este caractere é equivalente ao símbolo de redirecionamento para saída (>).
$G$G ou $g$g	Acrescenta as saídas ao fim de um arquivo. Utilize um desses caracteres duplos especiais para acrescentar saídas a um arquivo existente, em vez de substituir os dados do arquivo. Estes caracteres duplos são equivalentes ao símbolo de redirecionamento para saída (>>) do append.
$L ou $l	Redireciona os dados de entrada. Utilize um desses caracteres especiais para ler os dados de entrada de um dispositivo ou arquivo, em vez de utilizar o teclado. Este caractere é equivalente ao símbolo de redirecionamento de entrada (<).
$B ou $b	Envia as saídas da macro para um comando. Esses caracteres especiais equivalem ao uso do pipe ( \| ) em uma linha de comando.
$T ou $t	Separa comandos. Utilize um desses caracteres especiais para separar comandos ao criar macros ou digitar comandos na linha de comando de doskey. Esses caracteres especiais equivalem ao uso do "E" comercial (&) em uma linha de comando.
$$	Especifica o caractere cifrão ($).
$1 a $9	Representa qualquer informação da linha de comando que você queira especificar ao executar a macro. Os caracteres especiais de $1 a $9 são parâmetros em lote que permitem utilizar dados diferentes na linha de comando a cada vez que a macro é executada. O caractere $1 em um comando doskey é semelhante ao caractere %1 em um arquivo em lotes.
$*	Representa todas as informações da linha de comando que você deseja especificar ao digitar o nome da macro. O caractere especial $* é um parâmetro substituível semelhante aos parâmetros em lote de $1 a $9, com uma diferença importante: tudo que você digitar na linha de comando depois do nome da macro será substituído por $* na macro.

Executando uma macro do doskey
Para executar uma macro, digite o nome da macro iniciando na primeira posição da linha de comando. Se a macro foi definida com $* ou com qualquer um dos parâmetros em lote de $1 a $9, utilize um espaço em branco para separar os parâmetros. Não é possível executar uma macro do doskey a partir de um arquivo em lotes.
Criando uma macro com o mesmo nome de um comando do Microsoft Windows
Se você sempre utiliza um determinado comando com opções de linha de comando específicas, poderá criar uma macro que tenha o mesmo nome que o comando. Para especificar se você deseja executar a macro ou o comando, siga estas diretrizes:
- Para executar a macro, comece a digitar o nome da macro imediatamente após o prompt de comando, sem espaço entre o prompt e o nome do comando.
- Para executar o comando, insira um ou mais espaços entre o prompt de comando e o nome do comando.
Excluindo uma macro
Para excluir uma macro, digite:
doskey nome_da_macro=

Exemplos

As opções de linha de comando /macros e /history são úteis para criar arquivos em lote que salvam macros e comandos. Por exemplo, para armazenar todas as macros atuais do doskey, digite:

doskey /macros > macinit

Para utilizar as macros armazenadas em Macinit, digite:

doskey /macrofile=macinit

Para criar um arquivo em lotes denominado Tmp.bat que contém comandos utilizados recentemente, digite:

doskey /history > tmp.bat

Para definir uma macro com vários comandos, utilize $t para separar comandos, desta maneira:

doskey tx=cd temp$tdir/w $*

No exemplo anterior, a macro TX altera a pasta atual para Temp e exibe uma lista de pastas no formato de exibição ampliado. Você pode utilizar $* no final da macro para acrescentar outras opções ao comando dir quando executar TX.

A macro a seguir utiliza um parâmetro em lote para um novo nome de pasta:

doskey mc=md $1$tcd $1

A macro cria uma nova pasta e muda para ela a partir da pasta atual.

Para usar a macro anterior para criar a pasta Livros e alterar para ela, digite:

mc livros

Para criar uma macro de doskey para um programa chamado Ftp.exe, inclua /exename desta maneira:

doskey /exename:ftp.exe go=open 10.127.1.100$tmget *.TXT c:\reports$bye

Para utilizar a macro anterior, inicie o ftp. No prompt de ftp, digite:

O Ftp executará os comandos open, mget e bye.

Para criar uma macro que execute uma formatação rápida e incondicional de um disco, digite:

doskey qf=format $1 /q /u

Para formatar um disco na unidade A de maneira rápida e incondicional, digite:

qf a:XOX